agentic-metric

Agentic Metric

中文文档

A local-only monitoring tool for AI coding agents — like top, but for your coding agents. Track token usage and costs across Claude Code, Codex, OpenCode, Qwen Code, VS Code (Copilot Chat), and more — with a TUI dashboard and CLI.

Supported platforms: Linux and macOS.

All data stays on your machine. No network requests, no telemetry, no data leaves your computer. The tool only reads local agent data files (e.g. ~/.claude/) and process info.

Features

• Live monitoring — Detect running agent processes, incremental JSONL session parsing
• Cost estimation — Per-model pricing table with CLI management, calculates API-equivalent costs
• Today overview — Sessions, token usage, and cost summary for the current day
• Historical trends — 30-day daily token/cost trends
• TUI dashboard — Terminal UI with 1-second live refresh, stacked token charts, and trend lines
• Multi-agent — Plugin architecture, supports Claude Code, Codex, OpenCode, Qwen Code, VS Code, extensible

Agent Data Coverage

¹ VS Code legacy JSON sessions (older Copilot versions) do not contain token data; only newer JSONL sessions are supported.

² Cache read tokens only; cache write data is not exposed.

³ VS Code live status is process-level only; cannot match to a specific Copilot Chat session.

Installation

Requires Python 3.10+.

pip install agentic-metric

Or with uv:

uvx agentic-metric              # Run directly without installing
uv tool install agentic-metric   # Or install persistently
uv tool upgrade agentic-metric   # Upgrade to latest version

Usage

agentic-metric                 # Launch TUI dashboard (default when no command given)
agentic-metric status          # Show currently active agents
agentic-metric today           # Today's usage overview
agentic-metric history         # Historical trends (default 30 days)
agentic-metric history -d 7    # Last 7 days
agentic-metric sync            # Force sync data to local database
agentic-metric tui             # Launch TUI dashboard
agentic-metric bar             # One-line summary for status bars
agentic-metric pricing         # Manage model pricing

Pricing Management

Model pricing is used for cost estimation. Builtin pricing is included for common models. You can add new models or override existing prices via CLI — overrides are stored in $DATA/agentic_metric/pricing.json.

agentic-metric pricing list                                    # List all model pricing
agentic-metric pricing set deepseek-r2 -i 0.5 -o 2.0          # Add a new model
agentic-metric pricing set claude-opus-4-6 -i 4.0 -o 20.0 -cr 0.4 -cw 5.0  # Override builtin
agentic-metric pricing reset deepseek-r2                       # Reset a model to builtin default
agentic-metric pricing reset --all                             # Reset all overrides

For unknown models, pricing falls back by model family (e.g. claude-sonnet-* uses Sonnet pricing) before using the global default.

Status Bar Integration

agentic-metric bar outputs a compact one-line summary (e.g. AM: $1.23 | 4.5M) for embedding into status bars like i3blocks, waybar, tmux, vim statusline, etc.

i3blocks / waybar:

[agentic-metric]
command=agentic-metric bar
interval=60

tmux:

set -g status-right '#(agentic-metric bar | head -1)'
set -g status-interval 60    # refresh every 60 seconds (default 15)

vim / neovim statusline:

set statusline+=%{system('agentic-metric\ bar\ \|\ head\ -1')}
" statusline refreshes on cursor move, mode change, etc.
" to force a periodic refresh, add a timer:
autocmd CursorHold * redrawstatus
set updatetime=60000          " trigger CursorHold after 60s idle

TUI Keybindings

Data Sources

Paths differ by platform. $CONFIG and $DATA refer to:

All aggregated data is stored locally in $DATA/agentic_metric/data.db (SQLite).

Unsupported Agents

• Cursor — Cursor stopped writing token usage data (tokenCount) to its local state.vscdb database around January 2026 (approximately version 2.0.63+). All inputTokens/outputTokens values are now zero. Cursor has moved usage tracking to a server-side system. Since this tool is designed to be fully offline with no network requests, there is no way to retrieve Cursor's usage data via network API, so monitoring Cursor usage is not supported.

Privacy

• Fully offline — no network requests, no data sent anywhere
• Read-only — never modifies agent config or data files
• All stats stored in a local SQLite database
• Delete the data directory at any time to remove all data (~/.local/share/agentic_metric/ on Linux, ~/Library/Application Support/agentic_metric/ on macOS)