github.com/ktamas77/agentop ↗

About ktamas77/agentop

Agentop is a terminal dashboard tool that monitors all running AI coding agent sessions on your machine in real time, similar to the Unix `top` command. It supports multiple agent frameworks including Claude Code, OpenAI Codex, xAI Grok, Google Gemini, Google Antigravity, Earendil Pi, Hermes Agent, and OpenCode, displaying live information about each session such as the model being used, git branch, CPU and memory usage, current state, and what the agent is actively doing.

The tool is designed as a zero-dependency application that reads only local state from the machine—nothing is sent over the network. It discovers running agent processes and retrieves session information by reading framework-specific local files and databases, including JSONL transcripts, SQLite databases, and JSON configuration files. Users can interact with the dashboard using keyboard shortcuts to sort columns, reverse sort order, and adjust refresh intervals, while also having scriptable options like `--once` for single snapshots and `--json` output.

Agentop is available in multiple distribution formats to suit different preferences: as an npm package, Homebrew formula, Deno JSR package, and as standalone statically-compiled binaries for Linux and macOS on both x86_64 and arm64 architectures. The project is written in TypeScript and uses a modular provider architecture that makes it straightforward to add support for new agent frameworks. It requires Node.js 18+, Deno 2+, or Bun 1+ and has a development toolchain built around Deno with TypeScript native support.