AIMonitor
japananh/aimonitor
Monitor de uso Claude multi-conta com troca automática e MCP Slack/ClickUp
Ver no GitHubMonitor de uso multi-conta do Claude Code com troca silenciosa de contas, integração Slack/ClickUp via MCP, e dashboard em menu bar do macOS/Linux. Local-first, sem telemetria, com armazenamento em keyring do SO e auto-swap inteligente baseado em limites de uso.
Instalação
npx convez-ai japananh/aimonitor1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Monitorar consumo de 5h e 7d de múltiplas contas Claude em tempo real
- Alternar automaticamente entre contas quando uma atinge limite de uso
- Integrar Slack e ClickUp como ferramentas no Claude Code via MCP
- Exportar/importar configurações e contas criptografadas entre máquinas
Veredito

Ferramenta bem-arquitetada em Go para gerenciamento de múltiplas contas Claude com segurança nativa (keyring + Argon2id). MCP server com 28 ferramentas Slack/ClickUp agrega valor significativo, embora seja nicho para power users com rotinas multi-conta ou automação pesada.
README
A tradução para o português deste README ainda está na fila.
aimonitor
Multi-account Claude Code usage monitor & silent account switcher for macOS & Linux.
English | 简体中文 | 繁體中文 | Tiếng Việt
Features
- 🔍 Live 5h + 7d usage bars per account — polled from Anthropic's
/api/oauth/usage(no tokens consumed), with a trend line (↗ +21% in 45m). - 🔀 Silent switching —
aimonitor switch <label>refreshes the OAuth token and swaps the live credential. Noclaude /login, no terminal hop. - 🤖 Auto-swap at the 5h or 7d threshold (default 80 %) — picks the account with the most overall headroom, skips exhausted/rate-limited ones, and rescues immediately if the active account hits 100 %. Running
claudesessions follow automatically. - 🔔 Threshold notifications as an account nears its limit (when auto-swap is off).
- 💾 Export / import settings, or migrate accounts to another machine — credentials optional and passphrase-encrypted (Argon2id + AES-256-GCM).
- 🔌 MCP server — 28 Slack + ClickUp tools for Claude Code over stdio, with per-service read-only mode.
- 🔐 OS-keyring storage (macOS Keychain, Linux libsecret). SQLite holds references; tokens never leave the keyring. No telemetry.
Install
# macOS (Sonoma 14+)
brew install --cask japananh/tap/aimonitor
# 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
macOS first launch: the
.appisn't notarized yet — clear Gatekeeper once withxattr -dr com.apple.quarantine /Applications/AIMonitor.app(or right-click → Open). Seedocs/unsigned-app.md.
Quick start
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.
Configuration
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.
| Key | Default | Description |
|---|---|---|
auto_swap.enabled | true | Master toggle for auto-swap |
auto_swap.threshold_pct | 80 | 5h utilization (%) to auto-swap |
auto_swap.threshold_7d_pct | 80 | 7d utilization (%) to auto-swap |
auto_swap.grace_sec | 60 | Delay between the "pending" notification and the swap (0 = immediate) |
notify.enabled | true | Warn as the active account nears its limit (only when auto-swap is off) |
notify.warn_pct / notify.crit_pct | 80 / 95 | Warning / critical notification levels |
auto_update.enabled | true | Check GitHub for releases on launch (never auto-installs) |
autostart | false | Start the daemon at login |
mcp.slack.enabled / mcp.clickup.enabled | true | Expose that service's MCP tools |
mcp.slack.read_only / mcp.clickup.read_only | false | Hide the service's write tools |
mcp.disabled_tools | (empty) | Comma-separated tool names to hide |
How it works
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.
MCP server (Slack + ClickUp for Claude Code)
One stdio process serving 28 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 register # add the server to Claude Code
- Slack: post to channels/threads (mrkdwn, code blocks), upload, search, history, permalinks.
- ClickUp: workspace hierarchy, tasks, comments, Docs (read & write).
- Safety: Claude Code's per-tool prompts are the approval layer; per-service Enabled / Read-only switches and a per-tool disable list refine it. Tokens are verified live, then stored in the OS keyring — never in SQLite or logs.
Privacy & security
- No telemetry, no phone-home. OAuth tokens live only in the OS keyring; SQLite holds references. Token bytes are never logged.
- Outbound traffic is limited to:
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.
Uninstall
aimonitor uninstall --purge # drop autostart + SQLite DB, config, aimonitor keyring entries
brew uninstall --cask aimonitor # macOS
Your original Claude Code-credentials keyring entry is never touched — existing claude logins keep working.
Build from source
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