lazyagent

🐦 Follow me on X (@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, Cursor, Codex, Amp, pi, and OpenCode — no lock-in, no server, purely observational.

Inspired by lazygit, lazyworktree, and pixel-agents.

⭐ If lazyagent is useful to you, consider starring the repo — it helps others discover it!

💛 Loving it? Consider becoming a sponsor to keep the project alive and growing.

News

📢 Chat maintenance is here! Subcommands that keep your agent transcripts (and your rate limits) under control:

• lazyagent prune — 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 — 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, and Codex.
• lazyagent search — search transcript-file agents (Claude, Codex, pi, Amp) with highlighted snippets and an incremental local index.
• lazyagent limits — on-demand 5-hour and weekly rate-limit snapshot for Claude Code and Codex, with a pace indicator that flags whether you're under-, on-, or over-utilizing the window.

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

brew tap illegalstudio/tap
brew install lazyagent

Go (TUI only)

go install github.com/illegalstudio/lazyagent@latest

Build from source

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 --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 rate-limit usage and pace
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, the prune and compact maintenance commands, and architecture — lives at:

• lazyagent.dev/docs — rendered website
• docs/ — Markdown sources in this repository, organized by topic:
  • Getting started — install, quickstart
  • Concepts — how it works, supported agents, activity states, session info
  • Interfaces — terminal UI, macOS GUI, HTTP API
  • Maintenance — prune, compact, search, and limits commands
  • Reference — configuration, architecture, development, roadmap

License

MIT