Agentop
A terminal UI tool for monitoring local AI coding agents — like nvtop/htop, but for Claude/Codex.
Features
- Real-time process monitoring (CPU, memory, uptime)
- Claude Code usage + cost from local stats
- Quota panels (beta) for Codex + Antigravity
- Lightweight Textual TUI
Supported Agents
| Agent | Process Monitor | Usage Stats | Quota | Status |
|---|---|---|---|---|
| Claude Code | ✅ | ✅ | ✅ | Stable |
| Antigravity | ⏳ | ⏳ | ✅ | Beta |
| OpenAI Codex | ✅ | ✅ | ✅ | Beta |
| OpenCode | ✅ | ✅ | ⏳ | Beta |
Supported Platforms (has been tested)
- macOS
- Linux
Installation (macOS / Linux)
PyPI
pip install agentop
From source
pip install git+https://github.com/dadwadw233/agentop.git
Quick Start
# TUI
agentop
# Or
python3 -m agentop
Detailed stats:
python3 show_stats.py
Data Sources
- Claude stats: JSONL logs under
~/.config/claude/projects/or~/.claude/projects/(override withCLAUDE_CONFIG_DIR, supports comma-separated paths) - Codex token usage: local session logs under
~/.codex/sessions/ - Codex quota:
/usageAPI via Codex auth (~/.codex/auth.json) - Antigravity quota: Google Cloud Code API via Antigravity auth (local state db)
- OpenCode stats:
~/.local/share/opencode/storage/(message + session directories)
Changelog
0.2.0 (2026-01-25)
OpenCode Features:
- Fixed time filtering bug - now shows all historical data (not just today)
- Added time range support (Today/Week/Month/All) for all views
- Implemented lazy loading - only computes aggregates needed for current view
- Added index cache for faster incremental parsing
- Performance optimizations for large datasets
TUI Improvements:
- Redesigned overview dashboard with structured layout (Process Status, Session Stats, Token Usage)
- Added progress bars for visual token usage comparison
- Implemented pagination for handling large datasets
- Dynamic page sizing based on available screen height
- Enhanced table formatting with better alignment and smart truncation
- Color gradients for usage intensity (cyan/magenta/blue)
- Visual status indicators (🟢/⚪) with colored borders
- Improved hint text with time range display and update timestamps
- Consistent styling across all sub-views (Sessions, Projects, Models, Agents, Timeline)
Roadmap
- More agents (TBD)
- Config file (YAML)
- History + export (CSV/JSON)
- UI polish
Known Limitations
- Claude stats can lag behind real time
- Codex local token stats depend on availability of
token_countevents in session logs - Antigravity quota depends on account access
- Antigravity refresh requires
ANTIGRAVITY_OAUTH_CLIENT_SECRETor a fresh login - Proxy users: if you see “unknown scheme for proxy URL”, set
AGENTOP_DISABLE_PROXY=1or installhttpx[socks]
License
MIT (see LICENSE)
Metadata
Release files for agentop 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentop-0.2.2.tar.gz | 45.4 kB | Without provenance | Details for agentop-0.2.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentop-0.2.2-py3-none-any.whl | Python 3 | none | any | Details for agentop-0.2.2-py3-none-any.whl |
Total release size: 96.8 kB
Release files / agentop-0.2.2.tar.gz
| Download URL | agentop-0.2.2.tar.gz |
|---|---|
| Size | 45.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
031bf896a7bc20d4ddaf79314d38ff6986ded25fd9d087f1189878d2e0b98cfc
|
|
BLAKE2b-256 checksum How to use checksums |
bbafc88b6394edf6d14b23a05368d0b695552d79287e43e9e72b628d0be2dc96
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / agentop-0.2.2-py3-none-any.whl
| Download URL | agentop-0.2.2-py3-none-any.whl |
|---|---|
| Size | 51.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c1b66234f34169a473f7a504ec5d2772fa4115574745b4c7b98be4af179633db
|
|
BLAKE2b-256 checksum How to use checksums |
83e8544e6c125bac2a5bf953495e90876c8f669fe27b7cd37ae95da3bdcfdcd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for agentop 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.