Agentop banner
dadwadw233 dadwadw233

Agentop

AI community

Description

πŸ“Š Terminal UI for monitoring AI coding agents β€” like htop for Claude Code, Codex, and Antigravity.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

agentop

**like htop, but for AI coding agents**

[![PyPI version](https://img.shields.io/pypi/v/agentop?color=14b8a6&style=flat-square)](https://pypi.org/project/agentop/) [![Python versions](https://img.shields.io/pypi/pyversions/agentop?style=flat-square)](https://pypi.org/project/agentop/) [![License MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/dadwadw233/agentop?style=flat-square)](https://github.com/dadwadw233/agentop)

A terminal UI for monitoring AI coding agents in real time. Inspect running sessions, track token usage, watch costs accumulate, and see what every agent on your machine is doing β€” without leaving the terminal.


Supported agents

Agent Status Config path
Claude Code Supported ~/.claude/
Codex Supported ~/.codex/
Antigravity Supported ~/.antigravity/
OpenCode Supported ~/.opencode/

What you see

agentop presents a multi-panel TUI. Each panel updates live as agents write to their session files.

**Process monitor** CPU usage, memory footprint, and uptime for every active agent process. Modelled after htop's process list β€” sortable by any column.

**Usage stats** Token counts (prompt and completion), estimated cost, and session count per agent. Aggregates across all running and recently completed sessions.

**Quota tracking** Remaining API budget against configured limits. Raises a visual alert when an agent is close to exhausting its allocation.

**Timeline view** A scrollable chronological log of agent events β€” session starts, tool calls, errors, and completions β€” across all monitored agents in a single stream.


Data flow

~/.claude/ + ~/.codex/ + ~/.antigravity/ + ~/.opencode/
        |
        v
   agentop (file watchers + process scan)
        |
        v
   TUI Dashboard

agentop reads only local files and process metadata. No net