Metadata-Version: 2.4
Name: agtop
Version: 0.1.0
Summary: TUI monitor for AI coding agents — Claude Code, Codex CLI and more
Project-URL: Homepage, https://github.com/lhead/agtop
Author: lhead
License-Expression: MIT
License-File: LICENSE
Keywords: agent,claude,codex,monitor,terminal,tui
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: textual>=0.70.0
Description-Content-Type: text/markdown

# agtop

TUI monitor for AI coding agents — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex CLI](https://github.com/openai/codex) and more.

![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)
![License: MIT](https://img.shields.io/badge/license-MIT-green)

![screenshot](screenshot.svg)

## Features

- Live status tracking: working, idle, waiting for input/permission, done
- Conversation preview with tool call summaries
- One-key jump to the terminal tab/pane running a session
- macOS notifications + bell when a session needs attention
- Subscribe to sessions for task-completion alerts
- Supports Claude Code and OpenAI Codex CLI
- Terminal support: iTerm2, WezTerm, Terminal.app, Warp, Kaku, tmux

## Install

### Homebrew

```bash
brew install lhead/tap/agtop
```

### pip

```bash
pip install agtop
```

## Usage

```bash
agtop
```

### Keybindings

| Key | Action |
|-----|--------|
| `j` | Jump to session's terminal tab |
| `a` | Subscribe/unsubscribe to completion alerts |
| `r` | Force refresh |
| `c` | Copy session detail to clipboard |
| `q` | Quit |

## Configuration

`~/.config/agtop/config.toml`

```toml
[general]
show_recent_hours = 4   # Show closed sessions from last N hours
max_sessions = 20       # Max sessions in list

[refresh]
fast = 1                # Seconds - when active sessions exist
slow = 3                # Seconds - when all idle/done

[notifications]
enabled = true          # macOS notification for waiting sessions
sound = true            # Terminal bell
```

## License

MIT
