Claudemon

Claude Usage Monitor TUI - monitor your Claude Pro/Max plan quota in real-time.

Install

# Run without installing
npx claudemon

# Or install globally
npm i -g claudemon
pnpm add -g claudemon

Requires Node.js 18+.

Setup

claudemon setup

This detects your Claude Code OAuth credentials automatically. If you haven't logged in to Claude Code yet, it will guide you through the process.

Commands

| Command | Description | |---------|-------------| | claudemon | Launch the TUI dashboard | | claudemon setup | Interactive OAuth setup (skips if already authenticated) | | claudemon setup --re | Force re-authentication, overwriting existing token | | claudemon --help, -h | Show help message | | claudemon --version | Show version |

Keybindings (in TUI)

| Key | Action | |-----|--------| | q | Quit | | r | Force refresh | | ? | Toggle help |

Configuration

Config file: ~/.config/claudemon/config.toml

| Key | Type | Default | Description | |-----|------|---------|-------------| | plan_type | string | "pro" | Claude plan type (pro or max) | | refresh_interval | number | 30 | Auto-refresh interval in seconds |

| Key | Type | Default | Description | |-----|------|---------|-------------| | oauth_client_id | string | "9d1c250a-..." | Public OAuth client ID for Anthropic PKCE flow | | oauth_authorize_url | string | "https://claude.ai/oauth/authorize" | Authorization endpoint | | oauth_token_url | string | "https://console.anthropic.com/v1/oauth/token" | Token exchange endpoint | | oauth_redirect_uri | string | "https://console.anthropic.com/oauth/code/callback" | OAuth redirect URI | | oauth_scopes | string | "org:create_api_key user:profile user:inference" | OAuth scopes | | oauth_usage_url | string | "https://api.anthropic.com/api/oauth/usage" | Usage/quota API endpoint | | oauth_beta_header | string | "oauth-2025-04-20" | Required beta header for the usage API |

Pi Integration

Claudemon is also available as a pi extension, so you can check your Claude quota without leaving your coding session.

Install

# From npm
pi install npm:claudemon

# From git
pi install https://github.com/anistark/claudemon

# Try without installing
pi -e npm:claudemon

Usage

| Command | Description | |---------|-------------| | /claudemon | Show quota usage inline (5-hour, 7-day windows, per-model breakdown) | | /claudemon --tui | Launch the full TUI dashboard | | "Check my Claude usage" | The LLM calls the claudemon tool automatically |

Uninstall

pi remove npm:claudemon

Development

# Install dependencies
pnpm install

# Build and run with args
just run
just run setup
just run --help

# Build
just build

# Watch mode
just dev

# Type check
just lint

MIT License