lazyagent

lazyagent is a monitoring tool for coding agent sessions. It is built to show what running agents are doing and to track their activity, token use, and cost in real time across Claude Code (CLI and Desktop), Cursor, Codex, Grok CLI, Kilo, Kimi Code CLI, Amp, pi, and OpenCode.

The product centers on session monitoring in one place. It reports live activity states such as thinking, writing, reading, searching, and compacting, and it includes automatic token counting, USD cost estimation per session, and activity sparklines. It also provides maintenance functions from the CLI: pruning old or orphaned chats, compacting bulky session files in place, searching transcripts, and checking rate-limit windows. Transcript search spans Claude, Codex, pi, Amp, Grok, and Kimi transcripts, with highlighted snippets and an incremental local index; Cursor, OpenCode, and Kilo are excluded from that search because they keep history in third-party SQLite databases. Rate-limit summaries are available in the terminal interface and the GUI, with a quick-scan table and a detailed view showing per-window bars, reset times, and a pace indicator.

lazyagent is delivered as three interfaces: a terminal UI, a macOS menu bar app, and an HTTP API. The TUI is built with bubbletea and supports Vim-style navigation, fuzzy search, activity filters, time window controls, real-time updates via FSEvents, and CJK/Unicode text rendering. The menu bar app runs silently in the background with no Dock icon, uses a Catppuccin theme, and can toggle a session panel, open the limits page, or detach from the menu bar. The HTTP API provides REST endpoints and Server-Sent Events for real-time streaming, and it is protected by passphrase-derived Bearer tokens using PBKDF2-SHA256. The API exposes session lists, session detail, stats, configuration, and an events stream, and it can be used from a browser, mobile app, or curl. Outbound webhooks can push signed HTTP POSTs to Slack, dashboards, or CI endpoints when a session changes state, with optional HMAC-SHA256 signing, event and agent filters, and automatic retries on transient failures.

It is distributed through Homebrew, Go install, or source build. The project is released under the MIT license and is described as a single Go binary with no runtime dependencies and minimal CPU use. It is credited to Illegal Studio and Vincenzo Petrucci.