{"id":47695316,"url":"https://github.com/bezlant/climeter","last_synced_at":"2026-05-09T08:12:02.718Z","repository":{"id":342761167,"uuid":"1170744315","full_name":"bezlant/cliMeter","owner":"bezlant","description":"macOS menu bar app for tracking Claude Code API usage — see session and weekly rate limits at a glance","archived":false,"fork":false,"pushed_at":"2026-04-24T08:37:04.000Z","size":2807,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T10:36:11.433Z","etag":null,"topics":["anthropic","api-usage","claude","claude-code","developer-tools","mac-app","macos","menu-bar","native-app","rate-limit","status-bar","swift","swiftui","token-usage","usage-monitor"],"latest_commit_sha":null,"homepage":"https://climeter.bezlant.com","language":"Swift","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/bezlant.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-03-02T13:21:59.000Z","updated_at":"2026-04-24T08:37:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"f0755b22-3e97-496b-a6f2-81d555be58de","html_url":"https://github.com/bezlant/cliMeter","commit_stats":null,"previous_names":["bezlant/climeter"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/bezlant/cliMeter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bezlant%2FcliMeter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bezlant%2FcliMeter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bezlant%2FcliMeter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bezlant%2FcliMeter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bezlant","download_url":"https://codeload.github.com/bezlant/cliMeter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bezlant%2FcliMeter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32331305,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["anthropic","api-usage","claude","claude-code","developer-tools","mac-app","macos","menu-bar","native-app","rate-limit","status-bar","swift","swiftui","token-usage","usage-monitor"],"created_at":"2026-04-02T16:22:57.295Z","updated_at":"2026-04-27T10:00:57.300Z","avatar_url":"https://github.com/bezlant.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cliMeter\n\nmacOS menu bar app that tracks Claude Code and OpenAI Codex usage in real time.\n\nSee session and weekly limits at a glance. Know when you're running low before you hit a wall.\n\n[![GitHub release](https://img.shields.io/github/v/release/bezlant/cliMeter)](https://github.com/bezlant/cliMeter/releases/latest)\n[![GitHub downloads](https://img.shields.io/github/downloads/bezlant/cliMeter/total)](https://github.com/bezlant/cliMeter/releases)\n![macOS](https://img.shields.io/badge/macOS-14%2B-black)\n![Swift](https://img.shields.io/badge/Swift-5.9-orange)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n![Climeter](screenshot.png)\n\n## Why\n\nClaude Code and Codex do not keep their usage limits visible while you work. You often find out when you're blocked. cliMeter fixes that with a tiny menu bar view that stays out of your way.\n\n## Features\n\n- **Menu bar progress bar** — color-coded (green/orange/red) so you know at a glance\n- **Session + weekly tracking** — see both the 5-hour session and 7-day usage windows\n- **Claude multi-account support** — manage multiple Claude accounts, switch between them\n- **Claude auto-switch** — when one Claude account hits 95% utilization, automatically activates the next\n- **Codex usage tracking** — shows OpenAI Codex session and weekly plan-limit windows\n- **CLI sync** — picks up Claude Code `/login` credentials and Codex CLI login state\n- **Peak hours indicator** — shows when Claude rate limits are tighter (5–11 AM PT, weekdays) with countdown in your local timezone\n- **Per-provider toggles** — show or hide Claude and Codex independently\n- **File-based credential storage** — optional alternative to macOS Keychain, reduces security prompts\n- **Auto-update check** — notifies you when a new version is available\n\n## Install\n\n### Homebrew (recommended)\n\n```bash\nbrew install bezlant/tap/climeter\n```\n\n### Manual download\n\nDownload `Climeter.zip` from [the latest release](https://github.com/bezlant/cliMeter/releases/latest), unzip, and drag `Climeter.app` to `/Applications`.\n\n\u003e **Note:** The app is not notarized. On first launch, right-click → Open, or go to System Settings → Privacy \u0026 Security → Open Anyway.\n\n### Build from source\n\n```bash\ngit clone git@github.com:bezlant/cliMeter.git\ncd cliMeter\nxcodebuild -scheme Climeter -configuration Release -derivedDataPath build\ncp -R build/Build/Products/Release/Climeter.app /Applications/\n```\n\n## Update\n\n```bash\nbrew upgrade climeter\n```\n\nNew versions are published automatically — the Homebrew cask updates on every release.\n\n## Setup\n\n1. Open cliMeter — it appears in your menu bar\n2. For Claude usage, run `/login` in Claude Code\n3. For Codex usage, run `codex login`\n4. cliMeter detects the credentials automatically\n\nThat's it. No API keys to paste, no config files to edit.\n\n## Security\n\n- Claude credentials are stored in macOS Keychain by default, with optional file-based storage\n- Codex credentials are read from the Codex CLI auth file managed by `codex login`\n- OAuth tokens with automatic refresh\n- No data leaves your machine except provider API calls to Anthropic and OpenAI/ChatGPT usage endpoints\n- No analytics, no telemetry, no tracking\n- Open source — read every line\n\n## How it works\n\ncliMeter reads the OAuth credentials that Claude Code stores in the system Keychain (or its credentials file) for Claude usage. For Codex usage, it reads the current Codex CLI OAuth login from `$CODEX_HOME/auth.json` or `~/.codex/auth.json`. It polls provider usage endpoints every 3 minutes and displays the result. When tokens expire, it refreshes them silently.\n\nYou can toggle each provider on or off in Settings. File-based credential storage can be enabled to avoid Keychain security prompts — credentials are stored in `~/Library/Application Support/Climeter/credentials.json` instead.\n\nClaude auto-switch applies only to Claude profiles. Codex usage is displayed separately and does not participate in account switching.\n\n## Requirements\n\n- macOS 14 (Sonoma) or later\n- Claude Code CLI with an active Claude Pro/Team/Enterprise subscription for Claude usage\n- Codex CLI with a ChatGPT/Codex plan for Codex usage\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbezlant%2Fclimeter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbezlant%2Fclimeter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbezlant%2Fclimeter/lists"}