openusage: Instructions file for Codex

AGENTS.md

openusage AGENTS.md is an instructions file for Codex, OpenCode from robinebers/openusage. It costs 1,559 tokens per session, scanned A, original, MIT.

Repository instructions for OpenUsage, a macOS menu-bar app that displays usage information from AI providers such as Claude, Codex, Cursor, Grok, and Devin. SwiftPM is Apple's package-management system for Swift projects.

In plain words
What is it for?
Developing the native Swift app, following its contribution rules, preparing releases through the specified workflow, and maintaining its provider usage widgets.
Why use it?
They identify the active codebase and release rules, including version safeguards. This helps an agent avoid editing the legacy edition or accidentally using an invalid release number.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions CLAUDE.md; mentions AGENTS.md; mentions Codex.

This is robinebers/openusage's own configuration. It tells Codex and OpenCode how to work on openusage itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything openusage configures →

About the project

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.

robinebers/openusage · 4,556 stars · on GitHub · openusage.ai

Reuse

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.

Copy the file
curl -O https://raw.githubusercontent.com/robinebers/openusage/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/robinebers/openusage

Made for: Codex, OpenCode.

Wrote 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.

agentmods badge for openusage AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/robinebers/openusage/agents-md/github.svg)](https://agentmods.dev/instructions/robinebers/openusage/agents-md)
Your own site
<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.

agentmods 80×15 button for openusage AGENTS.md

Your own site · 80×15
<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>
Per session 1,559 This file is loaded in full into every session.
When invoked 1,559 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce 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

Measured yesterday against content hash 3de0d7ed87dc, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

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.

AGENTS.md · 129 lines

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 main branch. (NOT the legacy Tauri version which now sits in the tauri-legacy branch)

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.x and up. Never reuse a 0.6.x number — those are the original edition's released tags, now frozen on the tauri-legacy branch (final release v0.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.N tags 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.json so any remaining 0.6.x installs can still update to v0.6.28. release.yml handles 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.sh identify the app to every installed copy. Never change them.

Read the full file on GitHub · 129 lines

Changes

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.

  1. yesterday Changed · +3 tokens per session 3de0d7ed87dc
  2. 2d ago Changed · +1 lines · +21 tokens per session 2af0497f0ffe
  3. 4d ago Changed · -1 lines · -26 tokens per session 648e0b23ebc2
  4. 7d ago Changed · +1 lines · +26 tokens per session b90874e6624e
  5. 8d ago Changed · +48 lines · +24 tokens per session ae9488c0dae5
  6. 25d ago Changed · +2 tokens per session 8fbebf09659c
  7. 2mo ago First seen · 80 lines · 1,509 tokens per session scan A a4231e45cd0d

Subscribe to this mod's changes

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.

Related

openusage AGENTS.md compared with instructions from other repositories

openusage AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
openusage AGENTS.mdrobinebers/openusageInstructions file4.6kyesterdayMITA1,559Codex, OpenCode
plugin-files-modegriddynamics/rosettaInstructions file370todayApache-2.0A236GitHub Copilot
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,516GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot