Jovan1666/commandcode-usage

Command Code Usage is a cross-agent quota-monitoring tool whose sole implementation lives in core/cc-usage.mjs; the repository ships seven thin adapter directories so the same logic can be loaded into seven different coding CLIs and harnesses. It reads a Command Code API key from environment variables, ~/.commandcode/auth.json, or the host agent's own settings file, then renders a one-line status bar showing the five-hour, weekly, and monthly rolling windows with percent-used bars, reset times, remaining dollar balance, and traffic-light colors that turn from green under sixty percent to amber by eighty-five percent and red above ninety. The MIT-licensed project supports Claude Code, Codex CLI, Grok Build, opencode, pi, DeepSeek Harness, and ZCode, and is installed via per-agent commands such as /plugin marketplace add Jovan1666/commandcode-usage for Claude Code, grok plugin marketplace add … for Grok Build, pi install ./commandcode-usage/plugins/pi, and dsh plugin --profile web add ./commandcode-usage/plugins/dsh (requiring dsh ^0.1.5-rc.1). Most adapters are copies of the core script kept in sync by scripts/sync-core.mjs, but the DeepSeek Harness adapter deliberately keeps its own data layer because its host/client halves and one-hundred-forty-one offline checks are built against a separate contract; that detail is documented in plugins/dsh/README.md.

The typical workflow is to glance at the editor's status line, sidebar, or terminal panel between turns and see at a glance how much of the current billing window is gone, with no model round-trip and therefore no quota cost. The script decides per turn whether the active session is actually routed through Command Code by reading router mappings such as cc-switch-style ANTHROPIC_DEFAULT_OPUS_MODEL pairs, and simply hides itself when the user has switched to a different model so the quota bar does not become permanent noise. When precise numbers are wanted, /quota is invoked as a prompt and therefore costs a model turn; alternative surfaces include the terminal panel, the HTML panel, --compact, --md, and --json outputs, and per-agent toggle commands like pi's /ccq-bar on|off|toggle|refresh|status, while opencode exposes only its sidebar. Plans with no rolling windows, such as Provider or Enterprise, display only the balance, and the Go plan without API access renders nothing; the target audience is developers who juggle multiple coding agents and want to avoid burning turns just to inspect their usage.

Dependencies are intentionally light: Node eighteen or newer is the only runtime requirement beyond a Command Code paid plan that actually grants API access. Claude Code and Grok require a one-time setup script because their plugin manifests cannot declare a status line, so the script writes the setting on the user's behalf, refuses to overwrite an existing status line unless --force is passed, and restores the original on --remove. Windows users should install Git Bash because Claude Code falls back to PowerShell otherwise, and PowerShell repaints run roughly three times slower than Git Bash. The repository ships a node scripts/check.mjs that runs the same suites as CI, including the DeepSeek Harness one-hundred-forty-one checks, and an editor should change only core/cc-usage.mjs and then run the sync script, since the per-adapter files are generated copies. When credentials cannot be located the status line silently omits itself instead of printing an error into the editor, with the documented exception of the DeepSeek Harness adapter that retains its independent data layer.