aitop

aitop is a btop-inspired terminal dashboard for local AI agent activity. It reads native Claude and Codex state directly, so you can see what is active, what recently ran, and what happened in the focused session without wrapping your agent commands.

What It Does

• Discovers Claude CLI sessions from ~/.claude/sessions/*.json.
• Reads Claude project journals from ~/.claude/projects.
• Discovers Codex work from ~/.codex/process_manager/chat_processes.json.
• Reads recent Codex threads from ~/.codex/state_5.sqlite.
• Shows live sessions only when the native process is actually alive.
• Groups recent historical rows by project, while keeping genuinely live sessions distinct.
• Hides stale missing-path sessions from the default overview.
• Shows repo, branch, dirty files, PID, CPU, memory, model, token totals, and recent activity where available.
• Provides a focused tail view with normalized user, assistant, thinking, tool, result, and usage events.

Install

Requirements:

• Rust and Cargo
• macOS or another Unix-like system with kill, lsof, and git

From this repo:

./scripts/install.sh

By default, this builds a release binary and installs it to:

~/.local/bin/aitop

If ~/.local/bin is not on your PATH, add this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Choose another install directory:

AITOP_INSTALL_DIR=/some/bin ./scripts/install.sh

Usage

Open the dashboard:

aitop

Print one text snapshot:

aitop --once

Run with simulated demo data:

aitop --demo
aitop --once --demo

Controls

Monitor view:

• up / down or j / k: select a session
• enter: open the focused tail view
• a: cycle overview, active, and all views
• r: refresh
• q: quit

Tail view:

• j / k: scroll the focused log feed
• up / down: select another session
• page up / page down: scroll by larger jumps
• g / G: jump toward top or bottom
• esc: return to monitor
• a: return to monitor and cycle views
• q: quit

Development

cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo run -- --once
cargo run

License

aitop is released under the MIT License. See LICENSE.