[Resource]: usage

[aqua5230]

Display Name

usage

Category

Tooling

Sub-Category

Tooling: Usage Monitors

Primary Link

https://github.com/aqua5230/usage

Author Name

aqua5230

Author Link

https://github.com/aqua5230

License

AGPL-3.0

Other License

No response

Description

macOS menu bar utility that surfaces Claude Code and Codex quota by reading a status file
written by an installed statusLine hook (Claude Code) and parsing rate_limits from local
session JSONL logs (Codex). Pins 5-hour and 7-day percentages to the menu bar with an
expandable popover showing per-project breakdowns, daily token counts, and cost estimates.
Makes no Anthropic or OpenAI API calls; the LiteLLM pricing JSON is fetched once and cached
for 7 days to estimate Codex cost.

Validate Claims

Run python3 main.py --setup to install the statusLine hook, then restart Claude Code once.
The menu bar percentage should match the value shown in Claude Code's native status line,
because both read from the same local file (~/.claude/usage-status.json) written by the
hook.

Specific Task(s)

No response

Specific Prompt(s)

No response

Additional Comments

No response

Recommendation Checklist

• I have checked that this resource hasn't already been submitted
• It has been over one week since the first public commit to the repo I am recommending
• All provided links are working and publicly accessible
• I do NOT have any other open issues in this repository
• I am primarily composed of human-y stuff and not electrical circuits

[github-actions]

🤖 Validation Results

✅ All validation checks passed!

Your submission is ready for review by a maintainer.

Validated Data:

{
  "display_name": "usage",
  "category": "Tooling",
  "subcategory": "Usage Monitors",
  "primary_link": "https://github.com/aqua5230/usage",
  "author_name": "aqua5230",
  "author_link": "https://github.com/aqua5230",
  "license": "AGPL-3.0",
  "description": "macOS menu bar utility that surfaces Claude Code and Codex quota by reading a status file\n  written by an installed statusLine hook (Claude Code) and parsing rate_limits from local\n  session JSONL logs (Codex). Pins 5-hour and 7-day percentages to the menu bar with an\n  expandable popover showing per-project breakdowns, daily token counts, and cost estimates.\n  Makes no Anthropic or OpenAI API calls; the LiteLLM pricing JSON is fetched once and cached\n  for 7 days to estimate Codex cost.",
  "secondary_link": "",
  "last_modified": "2026-05-25:12-50-51",
  "active": "TRUE",
  "last_checked": "2026-05-25:13-58-57"
}

---

_{This comment is automatically updated when you edit the issue.}