aimonitor
Multi-account Claude Code usage monitor & silent account switcher for macOS & Linux.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirEnglish | 简体中文 | 繁體中文 | Tiếng Việt
/api/oauth/usage (no tokens consumed), with a trend line (↗ +21% in 45m).aimonitor switch <label> refreshes the OAuth token and swaps the live credential. No claude /login, no terminal hop.claude sessions follow automatically.# macOS (Sonoma 14+) — one command: taps, trusts, installs, clears Gatekeeper
curl -fsSL https://raw.githubusercontent.com/japananh/aimonitor/main/packaging/macos/install.sh | bash
# Linux (Ubuntu 22.04+) — CLI only
curl -fsSL https://raw.githubusercontent.com/japananh/aimonitor/main/packaging/linux/install.sh | sh
# Any platform, CLI only
go install github.com/japananh/aimonitor/cmd/aimonitor@latest
Prefer Homebrew directly?
brew trust japananh/tap && brew install --cask japananh/tap/aimonitor, then clear Gatekeeper on first launch:xattr -dr com.apple.quarantine /Applications/AIMonitor.app(or right-click → Open). The one-line installer above does both for you. Seedocs/unsigned-app.md.
brew upgrade --cask aimonitor # macOS
aimonitor update check # CLI: is a newer release out?
aimonitor update install # CLI: upgrade in the background
⚠️ macOS:
brew upgrade --caskre-quarantines the app. Each upgrade lays down a fresh unsigned.app, so if it won't open afterward, re-clear Gatekeeper withxattr -dr com.apple.quarantine /Applications/AIMonitor.app(re-running the one-line installer does it for you). This is expected — not a broken install, so don't reinstall or--purge. The CLI keeps working regardless.
The menu-bar app also checks GitHub on launch and offers the update under Preferences → Check for updates. Pre-releases are never auto-served — brew upgrade keeps you on the latest stable.
aimonitor add --adopt-current --label personal # register your current Claude login
aimonitor add --label work # add another (drives claude /login, polls keychain)
aimonitor switch work # switch silently
aimonitor list # live 5h / 7d usage per account
aimonitor doctor # health check
Already on another switcher? aimonitor import pulls its accounts in one step. Auto-swap is on by default at 80 % — nothing else to configure for the common case.
aimonitor config set auto_swap.enabled true # default true
aimonitor config set auto_swap.threshold_pct 80 # 5h threshold
aimonitor config set auto_swap.threshold_7d_pct 80 # 7d threshold
aimonitor config set autostart true # daemon at login
Back up or move to another machine:
aimonitor config export --out backup.json # settings only (no secrets)
AIMONITOR_PASSPHRASE=… aimonitor config export --include-tokens --out full.json # + encrypted credentials
AIMONITOR_PASSPHRASE=… aimonitor config import full.json # restore elsewhere
--include-tokens bundles your logins encrypted under the passphrase — restoring it means claude works on the other machine without re-login, so treat that file like a password. Same actions live in Preferences → Backup.
The daemon polls /api/oauth/usage (~5 min ± jitter, no tokens consumed). When the active account crosses its 5h or 7d threshold, it picks the account with the most overall headroom, refreshes that account's OAuth token (POST .../v1/oauth/token), and writes it to the live Keychain slot. Running and new claude sessions adopt the new account — no /login, no restart.
See docs/architecture.md and docs/thresholds.md for the full picture.
One stdio process serving Slack, ClickUp & Sentry tools — no extra runtimes.
aimonitor mcp connect slack # store a Slack user token (xoxp-…)
aimonitor mcp connect clickup # store a ClickUp token (pk_…)
aimonitor mcp connect sentry # store a Sentry auth token (set mcp.sentry.org first)
aimonitor mcp register # add the server to Claude Code
mcp.sentry.org, mcp.sentry.base_url).Slack token scopes. The Slack token is a user token (
xoxp-…). Grant these User Token Scopes on your Slack app (api.slack.com → OAuth & Permissions), reinstall, then connect — a missing one surfaces asslack: missing scope "…"on the affected tool:search:read,users:read,users:read.email,channels:history,groups:history,im:history,mpim:history,channels:read,groups:read,im:read,mpim:read,chat:write,files:read,files:write,reactions:write.
Sentry token scopes. A Sentry auth token (User Auth Token, or an Internal Integration). Set
mcp.sentry.org— andmcp.sentry.base_urlfor self-hosted — beforeconnect. Scopes:org:read,project:read,event:readfor the read/triage tools; addevent:write+member:readto resolve/assign/comment;event:adminto delete comments.
GET /api/oauth/usage (introspection, no tokens consumed), POST /v1/oauth/token (silent token refresh), and the GitHub release check. Nothing about you is sent.See docs/security.md for the threat model.
aimonitor doctor # health check: config, SQLite, keyring, accounts
aimonitor config set autostart true, or click Start daemon in the popover — it registers a LaunchAgent that relaunches at login.brew upgrade/reinstall — each lays down a fresh unsigned .app. Clear the quarantine flag, then reopen: xattr -dr com.apple.quarantine /Applications/AIMonitor.app. This is not a broken install, so don't uninstall or aimonitor uninstall --purge to "reset" it — --purge wipes your saved account logins. The CLI (aimonitor …) is unaffected. Details: docs/unsigned-app.md.~/Library/Logs/aimonitor/aimonitor.daemon.log (INFO/WARN/ERROR — never token bytes); background upgrades log to update.log beside it.aimonitor log prints the switch audit trail.# Remove the app + daemon, KEEP your saved accounts
brew uninstall --cask aimonitor
# Full wipe — ALSO deletes every account login aimonitor saved in your Keychain.
# Purge runs first: it needs the binary still installed to reach the stashes.
aimonitor uninstall --purge && brew uninstall --cask aimonitor
🔴
--purgeis destructive and irreversible. It permanently deletes aimonitor's saved copies of all your accounts (theaimonitor-<uuid>Keychain stashes) — you'll have toaimonitor addand complete/loginfor every account again. Plainbrew uninstall --cask aimonitor(no--purge) keeps them all.App won't open? That's Gatekeeper, not a broken install — don't
--purgeto "reset" it. Run thexattrfix in Troubleshooting instead.
--purge never touches Claude's own Claude Code-credentials slot, so the account you're currently signed into keeps working in claude with no re-login — only aimonitor's saved copies of your other accounts are dropped (and those you must re-add).
Requires Go 1.25+. Pure Go (CGO_ENABLED=0 works on macOS; keychain access shells out to /usr/bin/security).
make build # CLI binary
make test # unit tests
make widget # AIMonitor.app (macOS; needs the Swift toolchain)
make release-snapshot # goreleaser dry-run
To try a dev build of the app, run it against your dev CLI:
make widget
AIMONITOR_SKIP_GUARD=1 AIMONITOR_BIN=$PWD/bin/aimonitor build/AIMonitor.app/Contents/MacOS/AIMonitor
make dev-clean # when done
The dev bundle shares the installed app's bundle id, so LaunchServices keeps it registered after the folder is gone and Spotlight shows two "AIMonitor" apps. make dev-clean quits dev bundles, deletes build/AIMonitor.app and unregisters every AIMonitor.app path except /Applications.
Multi-account Claude Code usage monitor & silent account switcher, plus a Slack/ClickUp MCP server — macOS menu bar + CLI. Local-first, no telemetry.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Aimonitor roda localmente via stdio.
Última verificação: 2026-11-12. Multi-account Claude Code usage monitor & silent account switcher, plus a Slack/ClickUp MCP server — macOS menu bar + CLI. Local-first, no telemetry.