{"id":50372810,"url":"https://github.com/reedchan7/claudex","last_synced_at":"2026-05-30T08:03:18.732Z","repository":{"id":360151477,"uuid":"1248851503","full_name":"reedchan7/claudex","owner":"reedchan7","description":"A power-user toolkit that supercharges the Claude Code CLI","archived":false,"fork":false,"pushed_at":"2026-05-25T07:38:05.000Z","size":54,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T09:15:36.525Z","etag":null,"topics":["anthropic","claude","claude-code","cli","developer-tools","productivity","rust","terminal"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/reedchan7.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-25T05:37:30.000Z","updated_at":"2026-05-25T07:38:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/reedchan7/claudex","commit_stats":null,"previous_names":["reedchan7/claudex"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/reedchan7/claudex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reedchan7%2Fclaudex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reedchan7%2Fclaudex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reedchan7%2Fclaudex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reedchan7%2Fclaudex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reedchan7","download_url":"https://codeload.github.com/reedchan7/claudex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reedchan7%2Fclaudex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33684419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"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","claude","claude-code","cli","developer-tools","productivity","rust","terminal"],"created_at":"2026-05-30T08:03:15.248Z","updated_at":"2026-05-30T08:03:18.722Z","avatar_url":"https://github.com/reedchan7.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claudex\n\n\u003e Supercharge the [Claude Code](https://claude.com/claude-code) CLI.\n\n**claudex** is a power-user companion for the `claude` command line — a growing toolkit of extra commands that make your Claude Code workflow faster, slicker, and more fun. Think of it as the \"missing extras\" pack for Claude Code.\n\nTwo commands set the tone:\n\n- **`claudex usage`** — see your *entire* Claude plan budget at a glance: current session, weekly limits, Sonnet-only, and usage credits, all rendered as crisp colored bars in a single command.\n- **`claudex codex usage`** — the same treatment for your [OpenAI Codex](https://developers.openai.com/codex/cli) / ChatGPT plan: subscription tier, 5-hour session window, weekly window, and any per-model limits.\n\nNo interactive session, no digging through a web app — just run the command and you're done. More commands are on the way.\n\n\u003e [!WARNING]\n\u003e **Unofficial \u0026 unaffiliated.** claudex is a personal, non-commercial project. It is **not** affiliated with, endorsed by, or supported by Anthropic or OpenAI. It works by reusing the OAuth tokens that Claude Code and the Codex CLI already store locally, and calling **undocumented** endpoints (`api.anthropic.com` and `chatgpt.com`) with the matching `User-Agent`. Those endpoints may change or disappear without notice, and this usage may be against the providers' Terms of Service. Use it at your own risk. No warranty — see [LICENSE](LICENSE).\n\n## Example\n\n```console\n$ claudex usage\nCurrent session\n█████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 34% used\nResets 2:30pm (Asia/Shanghai), 2h 30m left\n\nCurrent week (all models)\n███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 6% used\nResets May 30 at 3am (Asia/Shanghai), 4d 11h left\n\nCurrent week (Sonnet only)\n██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3% used\nResets May 30 at 3am (Asia/Shanghai), 4d 11h left\n\nUsage credits   off\n```\n\n```console\n$ claudex codex usage\nSubscription: Pro\n\nCurrent session (5h)\n██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 4% used\nResets 6:19pm (Asia/Shanghai), 4h 35m left\n\nCurrent week\n█████████████████████████████░░░░░░░░░░░░░░░░░░░░░ 58% used\nResets May 31 at 2:55pm (Asia/Shanghai), 1d 1h left\n\nGPT-5.3-Codex-Spark — Current session (5h)\n░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% used\nResets 6:44pm (Asia/Shanghai), 5h left\n\nGPT-5.3-Codex-Spark — Current week\n░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% used\nResets Jun 6 at 1:44pm (Asia/Shanghai), 7d left\n```\n\nProgress bars are colored by utilization: green below 50%, yellow from 50–80%, red at 80% and above.\n\n## How it works\n\nclaudex reuses the credentials these CLIs already store on your machine — no extra login or API key required.\n\n### `claudex usage` (Claude)\n\nIt resolves the OAuth access token from the first available source:\n\n1. The `CLAUDE_CODE_OAUTH_TOKEN` environment variable, if set.\n2. On macOS, the Keychain entry `Claude Code-credentials`.\n3. The credentials file at `$CLAUDE_CONFIG_DIR/.credentials.json` (default `~/.claude/.credentials.json`).\n\nIt then detects your installed `claude` version (via `claude --version`) to send a matching `User-Agent`, calls `GET https://api.anthropic.com/api/oauth/usage`, and renders the response. If you can run `claude`, you can run `claudex usage`.\n\n### `claudex codex usage` (Codex / ChatGPT)\n\nIt reads the access token from `~/.codex/auth.json` (written when you sign in with the Codex CLI — run `codex`), sends a `codex-cli` `User-Agent` plus your `ChatGPT-Account-Id`, calls `GET https://chatgpt.com/backend-api/wham/usage`, and renders the response. If you can run `codex`, you can run `claudex codex usage`.\n\n## Requirements\n\nTo **run** claudex (using a prebuilt binary), you only need:\n\n- **macOS or Linux** (x86_64 or arm64). Windows is best-effort — no prebuilt binary; build from source.\n- An authenticated **Claude Code** install for `claudex usage`, and/or an authenticated **Codex CLI** install for `claudex codex usage`, with an active subscription.\n\nNo Rust toolchain is required to run a prebuilt binary. Rust (edition 2024, so 1.85+) is only needed if you build from source.\n\n## Install\n\n### Install or upgrade (recommended)\n\nDownload the right prebuilt binary for your platform and install it — no Rust required:\n\n```sh\ncurl -fsSL https://raw.githubusercontent.com/reedchan7/claudex/main/install.sh | sh\n```\n\n**The same command also upgrades.** Re-run it anytime: it detects an existing install, does nothing if you already have the latest version, and otherwise updates the binary you actually run, in place. Pass `CLAUDEX_FORCE=1` to reinstall even when you're already up to date.\n\nA fresh install lands in `~/.local/bin` (override with `CLAUDEX_INSTALL_DIR`), creating the directory if needed. If that directory isn't on your `PATH`, the installer adds it to your shell profile (`.zshrc` / `.bashrc` / `.bash_profile` / fish config) automatically — restart your shell afterwards. Set `CLAUDEX_NO_MODIFY_PATH=1` to manage `PATH` yourself.\n\n### Download manually\n\nGrab the archive for your platform from the [latest release](https://github.com/reedchan7/claudex/releases/latest), extract it, and put `claudex` on your `PATH`. Prebuilt targets:\n\n| Platform | Asset |\n| --- | --- |\n| macOS (Apple Silicon) | `claudex-\u003ctag\u003e-darwin-arm64.tar.gz` |\n| macOS (Intel) | `claudex-\u003ctag\u003e-darwin-amd64.tar.gz` |\n| Linux (x86_64) | `claudex-\u003ctag\u003e-linux-amd64.tar.gz` |\n| Linux (arm64) | `claudex-\u003ctag\u003e-linux-arm64.tar.gz` |\n| Windows (x86_64) | `claudex-\u003ctag\u003e-windows-amd64.zip` |\n\n### Build from source\n\nRequires the Rust toolchain:\n\n```sh\ncargo install --path .\n# or\nmake install\n```\n\nThis installs the `claudex` binary to `~/.cargo/bin`.\n\n## Usage\n\n```sh\nclaudex usage         # show Claude plan usage limits\nclaudex codex usage   # show Codex / ChatGPT plan usage limits\nclaudex --help        # list available commands\nclaudex --version     # print the version\n```\n\nIf your Claude token lives somewhere non-standard (or you just want to be explicit), set it directly:\n\n```sh\nexport CLAUDE_CODE_OAUTH_TOKEN=\"sk-ant-oat01-...\"\nclaudex usage\n```\n\n## Development\n\nCommon tasks are available through the `Makefile`:\n\n| Command | Description |\n| --- | --- |\n| `make build` | Build the debug binary |\n| `make release` | Build the optimized release binary |\n| `make test` | Run the test suite |\n| `make fmt` | Format the code with rustfmt |\n| `make lint` | Run clippy with warnings denied |\n| `make check` | Format check + lint + test (CI gate) |\n| `make run` | Run `claudex usage` |\n| `make install` | Install to `~/.cargo/bin` |\n| `make clean` | Remove build artifacts |\n\n## License\n\n[MIT](LICENSE) © Reed Chan\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freedchan7%2Fclaudex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freedchan7%2Fclaudex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freedchan7%2Fclaudex/lists"}