convez.ai
AgenteDevOps & InfraestruturaIntermediário
youming-ai

Agent Usage Monitor

youming-ai/agent-usage-monitor

Monitor em tempo real de uso e quotas de agentes IA locais

Ver no GitHub
InicialPluginScore · de 0 a 100

Dashboard TUI em tempo real que monitora uso, quotas e custos de múltiplos agentes de IA (Claude Code, Codex, Cursor, Copilot e outros) lendo dados de arquivos locais. Sem necessidade de API keys, oferece visibilidade consolidada do consumo de tokens entre diferentes ferramentas.

Instalação

$npx convez-ai youming-ai/agent-usage-monitor

1 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

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 semanas
Versão
v1.10.5
Issues abertas
0
Contribuidores
2

Casos de uso

  • Acompanhar consumo de tokens e custos entre múltiplos agentes de IA
  • Gerenciar quotas e limites de uso em tempo real via TUI
  • Auditar e monitorar atividade local de ferramentas como Claude Code, Cursor e Copilot

Veredito

Ferramenta sólida e bem executada para quem trabalha com múltiplos agentes de IA localmente. Preenche uma lacuna real de observabilidade sem depender de APIs externas, embora o nicho de uso seja específico para desenvolvedores com setup poliglota de agentes.

README

A tradução para o português deste README ainda está na fila.

Agent Usage Monitor

Real-time terminal dashboard for Claude Code, Codex, opencode, Kimi Code, pi, openclaw, hermes-agent, Factory AI, Grok Build, Cursor CLI, Copilot CLI, Antigravity CLI & MiMo Code usage — quota windows, token usage, and cost, read straight from local log files. No API keys required. The command is aum.

Platform License: MIT

Install

curl -fsSL https://raw.githubusercontent.com/youming-ai/agent-usage-monitor/main/install.sh | sh

Also available from Releases, or build from source with cargo build --release.

Usage

aum                # start monitoring (defaults below)
aum -r 2           # refresh every 2 seconds
aum update         # self-update to the latest release (--dry-run / --force)
aum config         # show current configuration
aum config set <key> <value>  # set a configuration value
aum config reset   # reset configuration to defaults
FlagDefaultDescription
--claude-path~/.claude/projectsClaude Code data directory
--codex-path~/.codexCodex data directory
--opencode-path$XDG_DATA_HOME/opencodeopencode data directory
--kimi-code-path~/.kimi-codeKimi Code data directory
--pi-path~/.pi/agent/sessionspi data directory
--openclaw-path~/.openclaw/agentsopenclaw data directory
--hermes-path~/.hermeshermes-agent data directory
--factory-path~/.factory/projectsFactory AI data directory
--grok-path~/.grokGrok Build data directory
--cursor-path~/.cursorCursor CLI data directory
--copilot-path~/.copilotCopilot CLI data directory
--antigravity-path~/.gemini/antigravity-cliAntigravity CLI data directory
--mimo-code-path~/.local/share/mimocodeMiMo Code data directory
-r, --refresh5Poll interval, in seconds

Keys: Tab / ← / → switch tab · r clear current tab · q quit

Only tabs for agents whose data directory exists are shown in the TUI.

Configuration

Configuration is stored in ~/.config/aum/config.toml (or platform equivalent). Available keys:

  • claude_path - Path to Claude Code data directory
  • codex_path - Path to Codex data directory
  • opencode_path - Path to opencode data directory
  • kimi_code_path - Path to Kimi Code data directory
  • pi_path - Path to pi data directory
  • openclaw_path - Path to openclaw data directory
  • hermes_path - Path to hermes-agent data directory
  • factory_path - Path to Factory AI data directory
  • grok_path - Path to Grok Build data directory
  • cursor_path - Path to Cursor CLI data directory
  • copilot_path - Path to Copilot CLI data directory
  • antigravity_path - Path to Antigravity CLI data directory
  • mimo_code_path - Path to MiMo Code data directory
  • refresh - Polling interval in seconds
  • max_records - Maximum number of records to keep in memory

Example:

aum config set refresh 2
aum config set max_records 200
aum config set grok_path ~/.grok
aum config set cursor_path ~/.cursor
aum config set copilot_path ~/.copilot
aum config set antigravity_path ~/.gemini/antigravity-cli
aum config set mimo_code_path ~/.local/share/mimocode

Layout

Each agent tab uses the same layout; only the accent color and data source change. Claude and Codex also show quota bars when credentials are available.

Claude Code (quota + usage)

 CLAUDE   codex   opencode   kimi-code   GROK   CURSOR                 ✓ you@mail.com
───────────────────────────────────────────────────────────────────────────────
 ✓ 5h ▓▓▓▓▓▓▓▓▓▓░░  82%  resets 2h30m
 ✓ 7d ▓▓▓▓▓▓░░░░░░  54%  resets 4d6h
┌ CLAUDE models (42) ───────────────────────────────────────────────────────────┐
│ MODEL          INPUT   OUTPUT   CACHE     COST     #                          │
│ claude-opus-4  1.2M    340.0k   8.1M      $12.34   42                         │
└───────────────────────────────────────────────────────────────────────────────┘
┌ sessions ─────────────────────────────────────────────────────────────────────┐
│ SESSION                       TOKENS    REQUESTS                              │
│ agent-usage-monitor a3f2c1d8  10.5k     2                                     │
│ my-web-app 9b4e7f02           2.3k      1                                     │
└───────────────────────────────────────────────────────────────────────────────┘
 42 calls · $12.34                                                    tab·r·q

Grok Build (usage only)

 GROK   CURSOR   CLAUDE   codex
───────────────────────────────────────────────────────────────────────────────
 (no quota API — usage from local session logs)
┌ GROK models (8) ──────────────────────────────────────────────────────────────┐
│ MODEL                 INPUT    OUTPUT   CACHE   COST     #                    │
│ grok-composer-2.5-fast  45.2k    0       0      $0.12    8                    │
└───────────────────────────────────────────────────────────────────────────────┘
┌ sessions ─────────────────────────────────────────────────────────────────────┐
│ SESSION                       TOKENS    REQUESTS                              │
│ my-project 019ea524           12.1k     4                                     │
└───────────────────────────────────────────────────────────────────────────────┘
 8 calls · $0.12                                                      tab·r·q

Cursor CLI (usage only)

 CURSOR   GROK   CLAUDE   codex
───────────────────────────────────────────────────────────────────────────────
 (no quota API — usage from transcripts and store.db)
┌ CURSOR models (3) ────────────────────────────────────────────────────────────┐
│ MODEL               INPUT   OUTPUT   CACHE   COST     #                      │
│ claude-sonnet-4-5   8.4k    2.1k     0      $0.00    3                       │
└───────────────────────────────────────────────────────────────────────────────┘
┌ sessions ─────────────────────────────────────────────────────────────────────┐
│ SESSION                       TOKENS    REQUESTS                              │
│ myproject a3f2c1d8            3.2k      1                                     │
└───────────────────────────────────────────────────────────────────────────────┘
 3 calls · $0.00                                                      tab·r·q
  • Quota bars — one per window (Claude & Codex only); the fill shows remaining usage, with a status glyph (✓ ≥50%, ⚠ ≥20%, ✗ <20%) and reset time.
  • models — per-model totals: tokens, cost, and request count.
  • sessions — per-conversation usage (tokens, requests), labelled <dir> <id> so multiple sessions in one project stay distinct.

Each platform uses an accent color matched to its official CLI theme or brand palette (Claude orange, Codex magenta, OpenCode peach, Kimi Code cyan, Pi sage, OpenClaw lobster orange, Hermes gold, Factory orange, Grok purple, Cursor cyan, Copilot green, Antigravity blue, MiMo Code Xiaomi orange); everything else stays default or dimmed. These are defined in src/state/app_state.rs (Tab::primary_color).

How it works

aum reads data that the supported agents already write locally — no network calls for usage records, no API keys:

  • Claude Code — ~/.claude/projects/**/*.jsonl
  • Codex — ~/.codex/sessions/**/rollout-*.jsonl
  • opencode — $XDG_DATA_HOME/opencode/opencode.db (SQLite, read-only)
  • Kimi Code — ~/.kimi-code/sessions/**/agents/*/wire.jsonl
  • pi — ~/.pi/agent/sessions/**/*.jsonl
  • openclaw — ~/.openclaw/agents/**/sessions/*.jsonl
  • hermes-agent — ~/.hermes/state.db (SQLite, read-only)
  • Factory AI — ~/.factory/projects/**/<session-uuid>.jsonl
  • Grok Build — ~/.grok/sessions/**/<session-id>/updates.jsonl (+ summary.json for session metadata)
  • Cursor CLI — ~/.cursor/projects/**/agent-transcripts/**/*.jsonl, ~/.cursor/chats/**/store.db, and ~/.config/cursor/chats/**/store.db
  • Copilot CLI — ~/.copilot/session-state/*/events.jsonl
  • Antigravity CLI — ~/.gemini/antigravity-cli/brain/*/.system_generated/logs/transcript_full.jsonl
  • MiMo Code — ~/.local/share/mimocode/mimocode.db (SQLite, read-only)

Quota percentages come from the official endpoints, authenticated with your existing local credentials (Claude: macOS Keychain or ~/.claude/.credentials.json; Codex: ~/.codex/auth.json). Cost is computed from built-in pricing tables for Anthropic & OpenAI models; unknown models show $0.00.

Adding a new agent

Platform wiring lives in src/platforms.rs (RegistryEntry). A new agent needs one registry row (path keys, reader factory) instead of scattered changes across main.rs and config handlers.

Tests

Unit tests live under src/; committed log samples under tests/fixtures/ are scanned by integration tests in tests/reader_fixtures.rs to catch format regressions:

cargo test

License

MIT

Ver o original no GitHub

Bom para

Relacionados