robinebers/openusage is a native macOS menu-bar application that tracks usage of AI coding subscriptions, including limits, credits, and spending. Developers use it to monitor plans from services such as Claude, Codex, Cursor, and Copilot, while the catalogue entries support related workflows.
Borrowing it
Nothing to install: this file belongs to robinebers/openusage. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/robinebers/openusage/main/AGENTS.mdgit clone --depth 1 https://github.com/robinebers/openusageWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/robinebers/openusage/agents-md)<a href="https://agentmods.dev/instructions/robinebers/openusage/agents-md"><img src="https://agentmods.dev/badge/instructions/robinebers/openusage/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/robinebers/openusage/agents-md"><img src="https://agentmods.dev/badge/instructions/robinebers/openusage/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01559 | $0.01559 |
| Opus 5.5 | $0.00624 | $0.00624 |
| Sonnet 5.5 | $0.00312 | $0.00312 |
| Haiku 4.5 | $0.00156 | $0.00156 |
Grade A, and why
openusage AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
OpenUsage is a SwiftPM-based macOS menu-bar app that shows the usage limits of the AI coding accounts a user adds within the app (Claude, Codex, Cursor, Copilot, Antigravity, Devin, Grok, Muse Code, Ollama, OpenCode, OpenRouter, Z.ai).
This file documents the engineering conventions for the project. Read it before contributing.
Agent Instructions
AGENTS.md is the source of truth for agent instructions in this repository. CLAUDE.md files may only
point to the nearest AGENTS.md file with @AGENTS.md; do not add guidance, duplicate instructions, or
project rules to CLAUDE.md.
Repository note: This is the native Swift edition of OpenUsage. Active development happens on the
mainbranch. (NOT the legacy Tauri version which now sits in thetauri-legacybranch)
Releases
main is the active development line; it ships via .github/workflows/release.yml (Sparkle appcast
on gh-pages). Cut releases with the release-swift skill.
Guardrails (do not break)
- Versions are
0.7.xand up. Never reuse a0.6.xnumber — those are the original edition's released tags, now frozen on thetauri-legacybranch (final releasev0.6.28). - Never increase the version number on your own initiative — always ask for explicit approval first. The version is a deliberate owner decision: propose the number and wait for explicit sign-off before tagging or cutting a release.
- Beta releases use
-beta.Ntags and stay GitHub pre-releases on Sparkle's beta channel. Stable releases use plain tags and become GitHub "Latest". - Stable releases must carry forward the legacy
latest.jsonso any remaining0.6.xinstalls can still update tov0.6.28.release.ymlhandles this; verify it with the release-swift skill. - Never leave a release in Draft, and never ship blank notes: the release-swift skill generates the changelog and verifies the published release after every cut.
- The appcast URL and the Sparkle public key in
script/release.shidentify the app to every installed copy. Never change them.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +3 tokens per session 3de0d7ed87dc
- 2d ago Changed · +1 lines · +21 tokens per session 2af0497f0ffe
- 4d ago Changed · -1 lines · -26 tokens per session 648e0b23ebc2
- 7d ago Changed · +1 lines · +26 tokens per session b90874e6624e
- 8d ago Changed · +48 lines · +24 tokens per session ae9488c0dae5
- 25d ago Changed · +2 tokens per session 8fbebf09659c
- 2mo ago First seen · 80 lines · 1,509 tokens per session scan A a4231e45cd0d
openusage AGENTS.md is an instructions file published in the GitHub repository robinebers/openusage (4,556 stars, last pushed yesterday), licensed MIT. It adds 1,559 tokens to every session, about $0.0062 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
openusage AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| openusage AGENTS.mdrobinebers/openusage | Instructions file | 4.6k | yesterday | MIT | A | 1,559 | Codex, OpenCode |
| plugin-files-modegriddynamics/rosetta | Instructions file | 370 | today | Apache-2.0 | A | 236 | GitHub Copilot |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 5,516 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 3,093 | GitHub Copilot |