{"id":47947670,"url":"https://github.com/anistark/claudemon","last_synced_at":"2026-04-04T08:51:18.272Z","repository":{"id":338070700,"uuid":"1154492352","full_name":"anistark/claudemon","owner":"anistark","description":"Claude Usage Monitor","archived":false,"fork":false,"pushed_at":"2026-03-04T11:42:50.000Z","size":1910,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-29T21:08:01.333Z","etag":null,"topics":["claude","cli","usage-tracking"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anistark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-10T13:00:00.000Z","updated_at":"2026-03-04T11:42:54.000Z","dependencies_parsed_at":"2026-02-13T01:00:22.734Z","dependency_job_id":null,"html_url":"https://github.com/anistark/claudemon","commit_stats":null,"previous_names":["anistark/claudemon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/anistark/claudemon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anistark%2Fclaudemon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anistark%2Fclaudemon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anistark%2Fclaudemon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anistark%2Fclaudemon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anistark","download_url":"https://codeload.github.com/anistark/claudemon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anistark%2Fclaudemon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31393780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","cli","usage-tracking"],"created_at":"2026-04-04T08:51:16.766Z","updated_at":"2026-04-04T08:51:18.240Z","avatar_url":"https://github.com/anistark.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claudemon\n\nClaude Usage Monitor TUI - monitor your Claude Pro/Max plan quota in real-time.\n\n![claudemon-demo](assets/claudemon.gif)\n\n[![npm version](https://img.shields.io/npm/v/claudemon)](https://www.npmjs.com/package/claudemon)\n[![npm downloads](https://img.shields.io/npm/dm/claudemon)](https://www.npmjs.com/package/claudemon)\n[![Open Source](https://img.shields.io/badge/open-source-brightgreen)](https://github.com/anistark/claudemon)\n![maintenance-status](https://img.shields.io/badge/maintenance-actively--developed-brightgreen.svg)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n![claudemon-demo](https://github.com/user-attachments/assets/7acff469-ac72-4de5-8a50-b9231667fbf4)\n\n## Install\n\n```sh\n# Run without installing\nnpx claudemon\n\n# Or install globally\nnpm i -g claudemon\npnpm add -g claudemon\n```\n\nRequires Node.js 18+.\n\n## Setup\n\n```sh\nclaudemon setup\n```\n\nThis detects your Claude Code OAuth credentials automatically. If you haven't logged in to Claude Code yet, it will guide you through the process.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `claudemon` | Launch the TUI dashboard |\n| `claudemon setup` | Interactive OAuth setup (skips if already authenticated) |\n| `claudemon setup --re` | Force re-authentication, overwriting existing token |\n| `claudemon --help`, `-h` | Show help message |\n| `claudemon --version` | Show version |\n\n## Keybindings (in TUI)\n\n| Key | Action |\n|-----|--------|\n| `q` | Quit |\n| `r` | Force refresh |\n| `?` | Toggle help |\n\n## Configuration\n\nConfig file: `~/.config/claudemon/config.toml`\n\n| Key | Type | Default | Description |\n|-----|------|---------|-------------|\n| `plan_type` | string | `\"pro\"` | Claude plan type (`pro` or `max`) |\n| `refresh_interval` | number | `30` | Auto-refresh interval in seconds |\n\n\u003cdetails\u003e\n\u003csummary\u003eAdvanced OAuth settings (usually no need to change)\u003c/summary\u003e\n\n| Key | Type | Default | Description |\n|-----|------|---------|-------------|\n| `oauth_client_id` | string | `\"9d1c250a-...\"` | Public OAuth client ID for Anthropic PKCE flow |\n| `oauth_authorize_url` | string | `\"https://claude.ai/oauth/authorize\"` | Authorization endpoint |\n| `oauth_token_url` | string | `\"https://console.anthropic.com/v1/oauth/token\"` | Token exchange endpoint |\n| `oauth_redirect_uri` | string | `\"https://console.anthropic.com/oauth/code/callback\"` | OAuth redirect URI |\n| `oauth_scopes` | string | `\"org:create_api_key user:profile user:inference\"` | OAuth scopes |\n| `oauth_usage_url` | string | `\"https://api.anthropic.com/api/oauth/usage\"` | Usage/quota API endpoint |\n| `oauth_beta_header` | string | `\"oauth-2025-04-20\"` | Required beta header for the usage API |\n\n\u003c/details\u003e\n\n## Pi Integration\n\nClaudemon is also available as a [pi](https://github.com/badlogic/pi-mono) extension, so you can check your Claude quota without leaving your coding session.\n\n### Install\n\n```sh\n# From npm\npi install npm:claudemon\n\n# From git\npi install https://github.com/anistark/claudemon\n\n# Try without installing\npi -e npm:claudemon\n```\n\n![claudemon-skill](https://github.com/user-attachments/assets/23278db3-675a-4eda-9a98-0879eceb89d2)\n\n### Usage\n\n| Command | Description |\n|---------|-------------|\n| `/claudemon` | Show quota usage inline (5-hour, 7-day windows, per-model breakdown) |\n| `/claudemon --tui` | Launch the full TUI dashboard |\n| *\"Check my Claude usage\"* | The LLM calls the `claudemon` tool automatically |\n\n### Uninstall\n\n```sh\npi remove npm:claudemon\n```\n\n## Development\n\n```sh\n# Install dependencies\npnpm install\n\n# Build and run with args\njust run\njust run setup\njust run --help\n\n# Build\njust build\n\n# Watch mode\njust dev\n\n# Type check\njust lint\n```\n\n\u003cimg width=\"1906\" height=\"1017\" alt=\"claudemon-ss\" src=\"https://github.com/user-attachments/assets/f1b818e1-f34b-4703-8cfb-cd630342b1b5\" /\u003e\n\n[MIT License](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanistark%2Fclaudemon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanistark%2Fclaudemon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanistark%2Fclaudemon/lists"}