agent-limit

Terminal dashboard to monitor Claude Code and Codex usage limits.

Quickstart

npm install -g agent-limit
agent-limit usage

Example

[███████░░░░|░░░░░░░░░] 30% ↓12%
            ^ you should be at 42%, but you're at 30% (12% under pace)

• ↓X% (green) = under pace, you have headroom
• ↑X% (red) = over pace, might hit limits early

Features

• Real-time usage tracking for Claude Code and Codex
• Trajectory markers showing if you're ahead or behind your usage pace
• Auto-refresh every 60 seconds
• Color-coded usage indicators

CLI Reference

| Command | Description | |---------|-------------| | agent-limit usage | Show usage dashboard | | agent-limit version | Show version | | agent-limit help | Show help message |

Dashboard Controls

| Key | Action | |-----|--------| | q | Quit | | r | Refresh |

Supported Providers

| Provider | Status | Data Source | |----------|--------|-------------| | Claude Code | Full support | macOS Keychain + Anthropic API | | Codex | Full support | ~/.codex/auth.json + OpenAI API |

How It Works

agent-limit reads credentials from standard locations:

• Claude Code: macOS Keychain (Claude Code-credentials)
• Codex: ~/.codex/auth.json

It then fetches usage data from each provider's API and displays it in a unified dashboard.

Installation Options

Via npm

npm install -g agent-limit

Standalone Binary (no dependencies)

Download from GitHub Releases:

# Apple Silicon
curl -L https://github.com/AgentWorkforce/limit/releases/latest/download/agent-limit-darwin-arm64 -o /usr/local/bin/agent-limit
chmod +x /usr/local/bin/agent-limit

# Intel Mac
curl -L https://github.com/AgentWorkforce/limit/releases/latest/download/agent-limit-darwin-x64 -o /usr/local/bin/agent-limit
chmod +x /usr/local/bin/agent-limit

Requirements

• macOS (uses Keychain for credential storage)
• Active CLI authentication for providers you want to monitor

Development

git clone https://github.com/AgentWorkforce/limit.git
cd monitor
bun install

Run in development mode with hot reload:

bun run dev

Run directly:

bun run start

Note: In dev mode, use q to quit cleanly. If you Ctrl-C and see garbled output, run reset to restore your terminal.

Building Standalone Binaries

Build binaries that don't require Bun:

# Build for all macOS architectures
bun run build

# Build for specific architecture
bun run build:arm64   # Apple Silicon
bun run build:x64     # Intel

Binaries are output to dist/.

License

MIT