Documentation
Getting started
AI Monitor reads Claude Code's usage data from the machine you code on, and syncs it to your account so you can see it anywhere. That means two pieces: an account, and a collector running on your computer. Five minutes, start to finish.
1. Sign in
Go to the sign-in page and choose GitHub or Google. There is no separate signup and no password to create — signing in the first time creates your account. AI Monitor reads only your verified email address and display name.
2. Install the desktop app on the computer you code on
This is the part that actually reads your usage. Claude Code writes its session data locally, so something has to run on that machine — the web app alone has nothing to show.
The installer isn't code-signed yet, so Windows SmartScreen will warn you the first time: choose More info → Run anyway. Requires Windows 10 1809 or newer. macOS and Linux builds aren't available yet.
3. Pair the desktop app with your account
Open the desktop app and it asks for a pairing code. Get one from Settings → Connect a computer here on the web, and type it in. The code is short-lived and single-use, and your password never reaches the app — there isn't one.
4. Wait one sync
The app finds your Claude Code session directory automatically and syncs every 60 seconds, starting immediately. Your dashboard fills in on the first pass. If it doesn't, check Providers → Claude Code → Last synced.
The app lives in your system tray and starts with Windows, so it keeps working without you opening it.
5. Optional: phone, watch and widgets
The Android app shows the same data, adds home-screen widgets, and can alert you when you approach a limit. It signs in the same way — no pairing needed.
The Android app is an APK rather than a Play Store install for now, so you'll need to allow installs from your browser. The watch app installs over adb — it's advanced-user territory today.
No computer to install on? You can still sign in and browse the app, but every usage figure will be empty until a collector reports. There is no way for AI Monitor to read your Claude Code usage remotely — Anthropic doesn't publish it through an API.
Connecting Claude Code
Connecting doesn't ask for your Anthropic password. AI Monitor points a local collector at your existing Claude Code session data directory (auto-detected, editable) and reads only timestamps and token-usage metadata — never conversation content.
Understanding usage windows
A usage window represents a rolling quota period (e.g. 5-hour, weekly). Percentage and limit are only shown if you've entered a known plan limit in Settings — otherwise we show your raw usage count and label the limit "Unavailable from provider", since Anthropic doesn't publish that number via an API.
Cost tracking
Estimated cost = token counts × published Anthropic pricing. It is always labeled "Estimated" and is never an actual invoice. Actual billed cost requires a separate, officially supported cost-reporting integration.
Notifications
Configure threshold notifications (50/75/80/90/95%, limit reached, reset) per provider in Settings → Notifications.
Widgets
Three Android home screen widgets — small, medium, and large — show live or last-cached usage. Long-press to configure which provider each widget tracks.
Privacy
We never read source code, file contents, or conversation content. See the Privacy and Security pages for the full data-handling policy.
Troubleshooting
If usage shows "Unavailable from provider", the provider hasn't exposed that specific metric through a supported mechanism — this is expected, not a bug. If usage looks stale, check Providers → Claude Code → Last synced.
Disconnecting accounts
Settings → Providers → Disconnect removes the connection and stops future syncs immediately. Historical data collected while connected is retained unless you also choose "Delete all data".
Deleting data
Settings → Privacy → Delete all data (keeps your account) or Delete account (removes everything, including the account itself).