It2ag

it2ag

iTerm2 agent monitor for [Claude Code](https://github.com/anthropics/claude-code) and [Codex](https://github.com/openai/codex).

Displays a real-time dashboard in iTerm2's Toolbelt sidebar showing all running AI coding agent sessions, their status (running/awaiting user/idle), git repo, and branch.

Features

• Agent detection — Detects Claude Code and Codex processes via process tree inspection
• Running/idle status — Claude Code: caffeinate child process; Codex: per-PID IOKit power assertion (pmset) + sandbox-exec/bwrap fast path
• Completion acknowledgement — When Claude Code or Codex transitions from running to idle, the card switches to awaiting user until clicked
• Git info — Shows repo name and branch for each session
• Repo grouping — Groups sessions by root repository (worktree-aware via git rev-parse --git-common-dir)
• Click to focus — Click a session entry to switch to that iTerm2 pane and clear awaiting user
• Search — Filter sessions by name, repo, branch, or path
• Auto-refresh — Updates every 3 seconds
• Toolbelt auto-open — Automatically opens the Toolbelt panel if it's not already visible

Requirements

• macOS
• iTerm2 with Python API enabled (Settings > General > Magic > Enable Python API)
• iTerm2 Shell Integration (for working directory and git info)
• uv

Installation

Homebrew

brew tap mkusaka/tap
brew install mkusaka/tap/it2ag

`uvx` from GitHub

Run directly from the git repo without cloning:

uvx --from git+https://github.com/mkusaka/it2ag.git it2ag

Clone and run locally

git clone https://github.com/mkusaka/it2ag.git
cd it2ag
uv run it2ag

Usage

# If installed via Homebrew or uvx
it2ag

# Or from the cloned repo
uv run it2ag

The Toolbelt panel opens automatically. Click any session to focus it, a