claudemon

Claude Usage Monitor TUI - monitor your Claude usage in real-time

Package details

← Back

extension

Install claudemon from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:claudemon

Package: claudemon
Version: 0.4.0
Published: Apr 4, 2026
Downloads: 227/mo · 28/wk
Author: anistark
License: MIT
Types: extension
Size: 111.8 KB
Dependencies: 4 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Claudemon

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

claudemon-demo

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

claudemon-skill

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