Who it is forA person paying for several model subscriptions who wants to know which agents are consuming usage and when quotas reset.
The problemUsage is spread across Claude Code, Codex, and other subscriptions, so it is hard to tell which agent used what or when a limit will reset.
The outcomeA Home view and Operations view that show reported token activity per agent and used percentages, reset times, and report age for enabled model quotas.
What you need first
- Docker with Compose installed
- Host port 9219 free on the machine that will run the hub
- An admin password of at least 8 characters
- Python for the optional MCP install (pip install 'retinue[mcp]')
- An agent that can send HTTP requests or speak MCP
Steps
- Run
docker compose up --buildand confirm the hub withcurl -fsS http://127.0.0.1:9219/api/health. - Upgrade an existing server through the explicit schema-26 migration described in docs/node-quota.en.md, since the README says existing servers require it. (inferred, check the README)
- Enable the node quota collector locally for the subscriptions you use, since collectors stay off until enabled. (inferred, check the README)
- Open the Home view and check the Claude, Codex, Grok, Cursor, or Kimi cards for used percentage, reset time, and report age.
- Open the Operations view and check reported usage coverage and receipt freshness before trusting the per-agent totals.
Prompt for your agent
In the Retinue repo at <repo path>, enable the node quota collector as described in docs/node-quota.en.md and open the Home view. Report the used percentage, reset time, and report age for each enabled subscription, and verify that the Operations view labels each source and its coverage.
Caveat. The README says reported usage is not a complete provider bill, so these numbers should be read as coverage-limited estimates rather than invoices.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for jklthinking/retinue and "See token activity and model quota per agent on the Home view"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer