Repolode
Submit
graykode

graykode/abtop

A btop-style terminal monitor that shows live token usage, context window, rate limits and open ports for Claude Code, Codex CLI and OpenCode sessions.

View on GitHub
Stars
3,755
Forks
361
Open issues
32
Last commit
last month

What is it?

abtop is a terminal dashboard for watching AI coding agents while they work. It discovers running Claude Code, Codex CLI and OpenCode sessions from local process and file state, and shows each one's token usage, context window percentage, rate limits, child processes and listening ports in a single screen.

The tool is read-only and needs no API keys or login. It runs on macOS, Linux and Windows, and supports multiple Claude Code profile directories. Pressing Enter on a session jumps to its terminal in tmux, cmux or iTerm2 on macOS. It also offers a one-shot text or JSON snapshot for scripts, and it can be used as a Rust library.

The interface includes 12 built-in color themes, including colorblind-friendly and light options, and supports English and Simplified Chinese. Feature coverage differs by agent: context window and rate limit tracking are available for Claude Code and Codex CLI but not OpenCode.

Key features

  • 01Shows token usage and context window percentage per agent session.
  • 02Displays rate limits and flags orphan ports left by agents.
  • 03Discovers Claude Code, Codex CLI and OpenCode sessions on macOS, Linux and Windows.
  • 04Jumps to the terminal pane of a selected session in tmux, cmux or iTerm2.
  • 05Provides a JSON snapshot mode for scripts and tools.
  • 06Offers 12 themes and English or Simplified Chinese UI.

Use cases

  • Running several coding agents across different projects and checking them from one screen.
  • Watching quota consumption to avoid hitting Claude or Codex rate limits mid-task.
  • Finding and killing servers an agent started but forgot to stop.
  • Feeding agent session data into a custom dashboard via the JSON snapshot.

Quick start

  1. 1

    Install via Cargo

    cargo install abtop
  2. 2

    Launch the TUI

    abtop

Things to know

  • Terminal Jump via Enter supports only cmux, tmux, and iTerm2 on macOS.
  • OpenCode support requires the sqlite3 CLI to be installed, and Linux needs it too.
  • Windows reports LOAD as 0 because it has no load average.

Topics

#ai-agents#claude-code#codex-cli#terminal#tui#monitoring#rust#developer-tools#ai-coding-agent#btop

FAQ

What is abtop?
A btop-style terminal monitor that shows live token usage, context window, rate limits and open ports for Claude Code, Codex CLI and OpenCode sessions. abtop is a terminal dashboard for watching AI coding agents while they work. It discovers running Claude Code, Codex CLI and OpenCode sessions from local process and file state, and shows each one's token usage, context window percentage, rate limits, child processes and listening ports in a single screen.
Is abtop free to use? What license does it have?
abtop is open source under the MIT license. Check the license terms before using it in commercial products.
Is abtop still maintained?
Updated within 6 months. The last commit to abtop was on Sep 14, 2026.
What can I use abtop for?
Running several coding agents across different projects and checking them from one screen. Watching quota consumption to avoid hitting Claude or Codex rate limits mid-task. Finding and killing servers an agent started but forgot to stop. Feeding agent session data into a custom dashboard via the JSON snapshot.
How do I install abtop?
Install via Cargo: cargo install abtop Launch the TUI: abtop
Where can I get abtop?
The source code and installation instructions are on GitHub: https://github.com/graykode/abtop

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects