https://github.com/illegalstudio/lazyagent
Monitor all your coding agents from one terminal - Claude Code, Cursor, OpenCode, pi and more
https://github.com/illegalstudio/lazyagent
agent-dashboard agent-monitoring ai claude-code claude-code-monitor cli codex coding-agent coding-agent-monitor cursor developer-tools golang multi-agent opencode terminal tray tui
Last synced: 3 days ago
JSON representation
Monitor all your coding agents from one terminal - Claude Code, Cursor, OpenCode, pi and more
- Host: GitHub
- URL: https://github.com/illegalstudio/lazyagent
- Owner: illegalstudio
- License: mit
- Created: 2026-03-06T17:40:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-28T15:34:22.000Z (18 days ago)
- Last Synced: 2026-05-28T17:05:51.453Z (18 days ago)
- Topics: agent-dashboard, agent-monitoring, ai, claude-code, claude-code-monitor, cli, codex, coding-agent, coding-agent-monitor, cursor, developer-tools, golang, multi-agent, opencode, terminal, tray, tui
- Language: Go
- Homepage: https://lazyagent.dev/
- Size: 3.01 MB
- Stars: 158
- Watchers: 0
- Forks: 13
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# lazyagent
[](https://www.producthunt.com/products/lazy-agent)
[](https://apps.apple.com/us/app/lazyagent/id6773359156)
[](https://x.com/nahime0)
> 🐦 **[Follow me on X (@nahime0)](https://x.com/nahime0) for updates, new features, and behind-the-scenes development.**
---
**A terminal UI, macOS menu bar app, and HTTP API for monitoring all your coding agents from a single place.**
Watch sessions from [Claude Code](https://claude.ai/code), [Cursor](https://cursor.com/), [Codex](https://developers.openai.com/codex/), [Grok CLI](https://x.ai/cli), [Kilo](https://kilo.ai/), Kimi Code CLI, [Amp](https://ampcode.com/), [pi](https://github.com/badlogic/pi-mono), and [OpenCode](https://opencode.ai/) — no lock-in, no server, purely observational.
Inspired by [lazygit](https://github.com/jesseduffield/lazygit), [lazyworktree](https://github.com/chmouel/lazyworktree), and [pixel-agents](https://github.com/pablodelucca/pixel-agents).
## Support the project
⭐ If lazyagent is useful to you, consider [starring the repo](https://github.com/illegalstudio/lazyagent) — it helps others discover it!
💛 Loving it? Consider [becoming a sponsor](https://github.com/sponsors/nahime0) to keep the project alive and growing.
## lazyagent for iOS
Want to keep an eye on your agents from your pocket? **[lazyagent is available on the App Store](https://apps.apple.com/us/app/lazyagent/id6773359156)** for iPhone and iPad.
The iOS app is a **paid** app — and that's on purpose. Buying it is one of the easiest ways to support the project and keep development going. Thank you! 💛
That said, lazyagent and its API are **fully open source**. If you'd rather not pay for the app, you're more than welcome to build your own client on top of the API — that's exactly what it's there for. No hard feelings, the choice is yours. 🙂
## News
📢 **Chat maintenance is here!** Subcommands that keep your agent transcripts (and your rate limits) under control:
- **[`lazyagent prune`](docs/maintenance/prune.md)** — delete chat files older than N days or whose project folder no longer exists. Interactive agent picker, dry-run previews, and per-project row selection at the confirmation prompt.
- **[`lazyagent compact`](docs/maintenance/compact.md)** — shrink session files in place by truncating bulky tool outputs, thinking blocks, and embedded images — sessions stay resumable with the originating agent. Supports Claude Code, pi, Codex, Grok, and Kimi.
- **[`lazyagent search`](docs/maintenance/search.md)** — search transcript-file agents (Claude, Codex, pi, Amp, Grok, Kimi) with highlighted snippets and an incremental local index.
- **[`lazyagent limits`](docs/maintenance/limits.md)** — on-demand rate-limit / billing summary for Claude Code (5h + 7d), Codex (5h + 7d), Grok (monthly), Kimi Code, and Cursor (monthly API usage), with a detailed pace view available via `--detailed`.
Typical savings on a year of daily use: **80+ MiB reclaimed** across a few commands, with every rewrite validated and backed up by default.
## Why lazyagent?
Unlike other tools, lazyagent doesn't replace your workflow — it watches it. Launch agents wherever you want (terminal, IDE, desktop app), lazyagent just observes. No lock-in, no server, no account required.
### Terminal UI
### macOS Menu Bar App
### HTTP API
## Install
### Homebrew
```bash
brew install illegalstudio/tap/lazyagent
```
### Go (TUI only)
```bash
go install github.com/illegalstudio/lazyagent@latest
```
### Build from source
```bash
git clone https://github.com/illegalstudio/lazyagent
cd lazyagent
# TUI only (no Wails/Node.js needed)
make tui
# Full build with menu bar app (requires Node.js for frontend)
make install # npm install (first time only)
make build
```
## Launch
```
lazyagent Launch the terminal UI (monitors all agents)
lazyagent --agent claude Monitor only Claude Code sessions
lazyagent --agent grok Monitor only Grok CLI sessions
lazyagent --agent kimi Monitor only Kimi Code CLI sessions
lazyagent --api Start the HTTP API (Bearer-token protected)
lazyagent --gui Launch the macOS menu bar app
lazyagent --tui --gui --api Run everything together
lazyagent prune --days N Delete chat sessions older than N days
lazyagent compact Shrink chat files by truncating bulky payloads
lazyagent search "query" Search chat transcripts with snippets
lazyagent limits Show 5h / weekly / monthly usage summary
lazyagent passphrase Set or rotate the HTTP API passphrase
lazyagent --help Show full help
```
## Documentation
Full documentation — supported agents, activity states, keybindings, configuration, the HTTP API, maintenance commands, and architecture — lives at:
- **[lazyagent.dev/docs](https://lazyagent.dev/docs)** — rendered website
- [`docs/`](docs/) — Markdown sources in this repository, organized by topic:
- [Getting started](docs/getting-started/) — install, quickstart
- [Concepts](docs/concepts/) — how it works, supported agents, activity states, session info
- [Interfaces](docs/interfaces/) — terminal UI, macOS GUI, HTTP API
- [Maintenance](docs/maintenance/) — `prune`, `compact`, `search`, and `limits` commands
- [Reference](docs/reference/) — configuration, architecture, development, roadmap
## License
MIT