Deus AI Limits Extension

A lightweight Chrome extension popup for monitoring signed-in Codex and Claude usage limits from the browser toolbar.

It is built for people who switch between AI coding/chat tools and want a fast local view of remaining session and weekly limits without keeping full usage pages open.

Features

• Codex limits from the signed-in ChatGPT/Codex browser session.
• Automatic Codex window detection by duration; the 5-hour row is hidden when OpenAI does not return that limit and reappears automatically when available.
• Manual Codex mapping override in Options: Auto, Standard, or Swapped.
• Claude limits from the signed-in Claude browser session.
• Direct browser-side API refresh.
• No external backend.
• No analytics.
• No token or cookie persistence.
• Dark, light, and system themes.
• Claude display mode:
  • left — inverted remaining-limit view.
  • used — Claude-style usage view.
• Clickable provider headers:
  • Codex opens the full Codex analytics page.
  • Claude opens the full Claude usage/settings page.
• Safe Claude organization setup:
  • autodiscovery first;
  • manual Options fallback when needed.

Screenshots

Light theme	Dark theme

Install locally

1. Download or clone this repository.
2. Open chrome://extensions/.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select the repository folder.
6. Pin Deus AI Limits in the Chrome toolbar.

You must be signed into ChatGPT/Codex and Claude in the same Chrome profile.

Package

Create a Chrome-ready ZIP:

python3 scripts/package-extension.py

The package is written to dist/.

Development

Run the smoke check:

npm run smoke

Build the distributable ZIP:

npm run package

Permissions

{
  "permissions": ["storage"],
  "host_permissions": [
    "https://chatgpt.com/*",
    "https://claude.ai/*"
  ]
}

Why they are needed:

• storage stores local UI preferences such as theme, language, Claude display mode, Codex window mapping mode, and optional Claude organization override.
• chatgpt.com is used to fetch Codex usage data from the current signed-in browser session.
• claude.ai is used to discover the Claude organization and fetch Claude usage data from the current signed-in browser session.

Privacy model

The extension does not run a server and does not send usage data to third-party infrastructure.

Authentication cookies are managed by the browser. The ChatGPT access token, when available from the active browser session, is used only in memory by the extension service worker to call the Codex usage endpoint. It is not saved to extension storage.

See PRIVACY.md.

Security model

• No remote code execution.
• No analytics SDK.
• No broad all-sites permission.
• No DOM scraping.
• No token/cookie persistence.
• No bundled secrets.

See SECURITY.md.

Known limitations

• This is not an official OpenAI, ChatGPT, Codex, Anthropic, or Claude product.
• Provider endpoints may change.
• The extension depends on the user being signed into the provider websites in the same Chrome profile.
• Claude organization autodiscovery may need manual Options fallback for some accounts.

Store readiness

Chrome Web Store preparation notes are tracked in STORE-CHECKLIST.md.

Community

For feedback, issues, ideas, and project discussion, join the Deus Apps Discord.

License

MIT.