ANNULAR

§ Privacy

Privacy

Annular has no account, no server that receives your usage or your login, no tracking, and no crash reporting. Anonymous stats are off unless you switch them on, and this page shows every line of them.

The short version

Annular reads your Claude usage, and from version 1.2 on your Codex usage if you switch that on, and shows it to you. Everything it learns stays on your Mac. There is no Annular account, and no server of ours ever receives your usage, your login, or anything that identifies you. The app contains no tracking and no crash reporting. From version 1.2.1 on it can send anonymous stats, only if you switch them on, and they are off when you install it.

What stays on your Mac

  • No login of its own. Annular stores no token. It reads the login Claude Code keeps in the macOS Keychain, holds it in memory only, and never changes or renews it. From version 1.2.2 on it reads that login through Apple's own security tool, the way Claude Code reads it, so macOS does not ask you about it: the switch in Settings, Sources is your yes, and switching it off stops the reading. Earlier versions read the item themselves, and macOS asked you each time. Versions before 1.1 kept a sign-in of their own in the Keychain, and version 1.1 deletes it at its first launch.
  • Codex, if you switch it on. Annular starts Codex's own local server on your Mac for each reading, asks it for your limits, and ends it. Codex keeps its login; Annular never sees it and stores nothing of it. The answer also names your Codex account, and Annular neither keeps nor logs that.
  • The status line feed, if you switch it on. A small script passes Claude Code's status line through and keeps two things from it in a local file: your session and week percentages, with their reset times. Nothing else from Claude Code's status line data is kept: no folder names, no session ids, no costs. Your earlier status line command is saved next to the script, readable only by you, and when Claude Code had a settings file, a copy of it is kept next to the original.
  • Usage history. Annular keeps the percentages it has seen, with the time and the reset time, in a local file at ~/Library/Application Support/Annular/history.sqlite. It is used for the small charts and the forecast. It is kept for 90 days and left out of Time Machine backups. You can switch it off and delete it in Settings, History.
  • Settings and themes. Your preferences, including the record of which alerts you have already had, and your own themes are files in your Library folder.
  • The date you first installed Annular. It is written once to your preferences and is never sent anywhere.

Annular never sees your Claude password. It does not read your conversations, your prompts, or your files. Annular uses Claude Code's login only to read your usage, and it never sends a prompt.

What Annular connects to

Annular talks to two parties: Anthropic, to read your usage, and annular.app, to look for updates and, only if you switch them on, to send anonymous stats.

  • api.anthropic.com: your usage, read with the login Claude Code keeps. By default every 2 minutes, and you can choose 1, 2, 5, or 10 minutes. While the status line feed is live, Annular asks at most every 10 minutes. With the feed as your only source, Annular does not contact Anthropic at all.
  • With Codex switched on, Annular itself still contacts no OpenAI host: Codex does, on your Mac, with its own login, each time Annular asks it for your limits. That is every 2 minutes by default, at the pace you choose for Claude.
  • Annular does not contact claude.ai or console.anthropic.com. Versions before 1.1 did, for their own sign-in.
  • annular.app: once a day, to look for an update, and to download one when there is one. That request names the app and its version, as an update check must, and nothing else about you or your Mac. Sparkle's system profile is switched off. We count update checks and downloads, so we know how many copies of each version are in use: for each one we keep what kind of request it was, the app version, and the time. We keep no IP address, no country, no cookie, and not the rest of the request.
  • Anonymous stats, from version 1.2.1 on, and only if you switch them on in Settings, Privacy. They are off by default. Once a day Annular then sends seven lines to annular.app, and Settings shows you the exact lines before you decide. The lines are: the format of the lines, the Annular version, the major macOS version (such as 26), which sources are switched on (the Claude Code login, the status line feed, Codex), the name of the built-in theme in use (a theme you made is only ever called "custom"), and whether the corner rings and the menu bar item are on. There is no identifier in them: nothing that names you, your Mac, or your copy of Annular, so we cannot tell two days of the same Mac apart. They never hold your usage, your limits, your plan, or your history. We keep those seven values and the time, and no IP address, no country, no cookie, and nothing else of the request. Switch them off in the same place and nothing more is sent.

Connections use TLS 1.2 or newer. Annular keeps no cookies and no network cache.

What Annular never does

  • It does not send your usage, your token, or anything about you to us. Apart from the update check described above, which names the app and its version, the only thing it can send us is the seven anonymous lines, and only if you switch them on.
  • It does not include advertising, tracking, or crash reporting code.
  • It does not sell or share data, because it has none to sell or share.

Anthropic

When Annular reads your usage, Anthropic receives that request with your token, as it would from one of its own apps. Since version 1.0.4, Annular names itself honestly in every usage request, as Annular/<version> (https://annular.app), so Anthropic can tell the request comes from Annular. Anthropic's privacy policy covers what Anthropic does with it. Annular is an independent tool and is not affiliated with, endorsed by, or sponsored by Anthropic or OpenAI.

OpenAI

When Codex reads your limits for Annular, OpenAI receives that request from Codex, with Codex's login, as it does when you use Codex yourself. Annular tells Codex its own name and version, and Codex uses them in how it names itself to OpenAI. OpenAI's privacy policy covers what OpenAI does with it.

This website

annular.app is a static site. It sets no cookies, runs no scripts, and loads nothing from other companies. It is served by Cloudflare, which processes your IP address to deliver the page, as every web host must. We keep no logs of our own about visitors, and pages are not counted. The only things we count are downloads, update checks, and the anonymous stats of people who switched them on, all as described above.

Children

Annular is a developer tool and is not directed at children.

Changes

If this page changes, the date at the top changes with it, and the release notes say so when the app's behavior changed.

Contact

Questions about privacy go to support@annular.app.