agentic-metric 0.1.0__tar.gz

agentic_metric-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+*.db

agentic_metric-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MrQianjinsi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentic_metric-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: agentic-metric
+Version: 0.1.0
+Summary: Agentic coding metric monitor — multi-agent, TUI, CLI
+Project-URL: Homepage, https://github.com/MrQianjinsi/agentic_metric
+Project-URL: Repository, https://github.com/MrQianjinsi/agentic_metric
+Project-URL: Issues, https://github.com/MrQianjinsi/agentic_metric/issues
+Author-email: MrQianjinsi <mrqianjinsi@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude-code,codex,coding-agent,cursor,metrics,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual-plotext>=0.3.0
+Requires-Dist: textual>=1.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# Agentic Metric
+
+[中文文档](README-CN.md)
+
+A local-only monitoring tool for AI coding agents. Track token usage and costs across Claude Code, Codex, Cursor, OpenCode, VS Code (Copilot Chat), and more — with a TUI dashboard and CLI.
+
+**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** — Estimated based on token usage and per-model pricing tables, not actual billing. Useful as a reference, but may differ from real costs due to caching discounts, plan-specific pricing, etc.
+- **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 and Cursor, extensible
+
+## Data Sources
+
+| Agent | Path | Data |
+|-------|------|------|
+| Claude Code | `~/.claude/projects/` | JSONL sessions, token usage, model, branch |
+| Claude Code | `~/.claude/stats-cache.json` | Daily activity stats |
+| Cursor | `~/.config/Cursor/User/globalStorage/state.vscdb` | Composer sessions, token usage, model |
+| Cursor | Process detection | Running status, working directory |
+| Codex | `~/.codex/sessions/` | JSONL sessions, token usage, model |
+| VS Code | `~/.config/Code/User/workspaceStorage/*/chatSessions/` | Chat sessions (JSON + JSONL), token usage (JSONL only), model |
+| VS Code | `~/.config/Code/User/globalStorage/emptyWindowChatSessions/` | Empty-window chat sessions |
+| VS Code | Process detection | Running status, working directory |
+| OpenCode | `~/.local/share/opencode/opencode.db` | SQLite sessions, messages, token usage, model |
+| OpenCode | Process detection | Running status, active session matching |
+
+All aggregated data is stored locally in `~/.local/share/agentic_metric/data.db` (SQLite).
+
+## Installation
+
+```bash
+pip install agentic-metric
+```
+
+## Usage
+
+```bash
+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
+```
+
+### 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:**
+
+```ini
+[agentic-metric]
+command=agentic-metric bar
+interval=60
+```
+
+**tmux:**
+
+```tmux
+set -g status-right '#(agentic-metric bar | head -1)'
+set -g status-interval 60    # refresh every 60 seconds (default 15)
+```
+
+**vim / neovim statusline:**
+
+```vim
+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
+
+| Key | Action |
+|-----|--------|
+| `q` | Quit |
+| `r` | Refresh data |
+| `Tab` | Switch Dashboard / History tab |
+
+## Agent Data Coverage
+
+Different agents expose different levels of local data. Here's what's available for each:
+
+| Field | Claude Code | Codex | Cursor | VS Code (Copilot) | OpenCode |
+|-------|:-----------:|:-----:|:------:|:-----------------:|:--------:|
+| Session ID | ✓ JSONL | ✓ JSONL | ✓ composerId | ✓ sessionId | ✓ session table |
+| Project path | ✓ JSONL | ✓ JSONL | ◐ partial (from bubble or conversationState) | ✓ workspace.json URI | ✓ session.directory (launch cwd) |
+| Git branch | ✓ JSONL | ✓ JSONL | ✗ not stored | ✗ not stored | ✗ not stored |
+| Model | ✓ JSONL | ✓ JSONL | ✓ modelConfig / bubble modelInfo | ✓ result.details (e.g. "Claude Haiku 4.5 • 1x") | ✓ message.modelID |
+| Input tokens | ✓ per-message | ✓ cumulative | ◐ older versions only | ◐ JSONL format only | ✓ per-message |
+| Output tokens | ✓ per-message | ✓ cumulative | ◐ older versions only | ◐ JSONL format only | ✓ per-message (includes reasoning) |
+| Cache tokens | ✓ read + write | ✓ read only | ✗ not exposed | ✗ not exposed | ◐ read only (write always 0) |
+| User turns | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Message count | ✓ all messages | ✓ AI replies only | ✓ all messages | ✓ turns × 2 | ✓ all messages |
+| First/last prompt | ✓ | ✓ | ✓ from bubble text | ✓ message.text | ✓ from part table |
+| Cost estimation | ✓ | ✓ | ◐ only when tokens available | ◐ only when tokens available | ◐ estimated only (reported cost always 0) |
+| Live active status | ✓ PID + session file match | ✓ PID + session file match | ◐ process-level only (latest session marked active) | ◐ process-level only | ✓ PID + DB session match |
+
+**Key differences:**
+
+- **Claude Code & Codex** — Each running process maps to a JSONL session file with a unique session ID. This allows precise matching between live processes and DB sessions for accurate active status.
+- **Cursor** — Live detection only sees the process PID, while historical sessions use composer UUIDs from `state.vscdb`. There is no way to link a running Cursor process to a specific composer session, so the most recent session is marked active when the process is running.
+- **Token coverage** — Cursor stored per-bubble `tokenCount` (input/output) in `state.vscdb` in earlier versions (~2025-05 to ~2025-12), but newer versions no longer populate this field — all values are zero. Cursor appears to have moved usage tracking to a server-side system, so local token data is unavailable for recent sessions. Cache token breakdown (read/write) has never been available.
+- **Model name** — Cursor's "default" model setting doesn't record which model was actually used on the backend. These sessions show `default` in the model column.
+- **VS Code (Copilot Chat)** — Has two storage formats: legacy JSON (older sessions, no token data) and newer incremental JSONL (with `result.usage` containing `promptTokens`/`completionTokens`). Token usage is only available for sessions stored in JSONL format. Model names are extracted from Copilot's display strings (e.g. "GPT-4o • 1x") and normalized to pricing keys. Workspace paths support local (`file://`), SSH remote (`vscode-remote://ssh-remote+host`), and container (`attached-container+...`) URIs.
+- **OpenCode** — Stores all data in a local SQLite database (`opencode.db`). Token data is per-message with `input`, `output`, `reasoning`, and `cache.read`/`cache.write` fields. Reasoning tokens are counted as output tokens (billed at output rate). The `cost` field in messages is always 0, so all costs are estimated using the pricing table. `cache.write` is also always 0.
+
+## 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 `~/.local/share/agentic_metric/` at any time to remove all data

agentic_metric-0.1.0/README-CN.md

@@ -0,0 +1,123 @@
+# Agentic Metric
+
+[English](README.md)
+
+本地化的 AI coding agent 指标监控工具。追踪 Claude Code、Codex、Cursor、OpenCode、VS Code (Copilot Chat) 等 agent 的 token 用量和成本，提供 TUI 仪表盘和 CLI 命令。
+
+**所有数据完全存储在本地，使用过程不会联网。** 工具仅读取本机的 agent 数据文件（如 `~/.claude/`）和进程信息，不发送任何数据到外部服务器。
+
+## 功能
+
+- **实时监控** — 检测运行中的 agent 进程，增量解析 JSONL 会话数据
+- **成本估算** — 基于 token 用量和各模型定价表估算，非实际账单费用。可作为参考，但可能因缓存折扣、套餐定价等因素与真实费用有差异
+- **今日概览** — 当天的 session 数、token 用量、花费汇总
+- **历史趋势** — 每日 token/成本的 30 天趋势
+- **TUI 仪表盘** — 终端图形界面，实时刷新（1 秒），含 token 堆叠图和趋势折线图
+- **多 Agent 支持** — 插件架构，已支持 Claude Code 和 Cursor，可扩展
+
+## 数据来源
+
+| Agent | 数据路径 | 采集内容 |
+|-------|---------|---------|
+| Claude Code | `~/.claude/projects/` | JSONL 会话、token 用量、模型、分支 |
+| Claude Code | `~/.claude/stats-cache.json` | 每日活动统计 |
+| Cursor | `~/.config/Cursor/User/globalStorage/state.vscdb` | Composer 会话、token 用量、模型 |
+| Cursor | 进程检测 | 运行状态、工作目录 |
+| Codex | `~/.codex/sessions/` | JSONL 会话、token 用量、模型 |
+| VS Code | `~/.config/Code/User/workspaceStorage/*/chatSessions/` | 聊天会话（JSON + JSONL）、token 用量（仅 JSONL）、模型 |
+| VS Code | `~/.config/Code/User/globalStorage/emptyWindowChatSessions/` | 空窗口聊天会话 |
+| VS Code | 进程检测 | 运行状态、工作目录 |
+| OpenCode | `~/.local/share/opencode/opencode.db` | SQLite 会话、消息、token 用量、模型 |
+| OpenCode | 进程检测 | 运行状态、活跃会话匹配 |
+
+所有数据汇总存储在 `~/.local/share/agentic_metric/data.db`（SQLite）。
+
+## 安装
+
+```bash
+pip install agentic-metric
+```
+
+## 使用
+
+```bash
+agentic-metric status          # 查看当前活跃的 agent
+agentic-metric today           # 今日用量概览
+agentic-metric history         # 历史趋势（默认 30 天）
+agentic-metric history -d 7    # 最近 7 天
+agentic-metric sync            # 强制同步数据到本地数据库
+agentic-metric tui             # 启动 TUI 仪表盘
+agentic-metric bar             # 单行摘要，用于状态栏集成
+```
+
+### 状态栏集成
+
+`agentic-metric bar` 输出紧凑的单行摘要（如 `AM: $1.23 | 4.5M`），可嵌入 i3blocks、waybar、tmux、vim statusline 等状态栏。
+
+**i3blocks / waybar：**
+
+```ini
+[agentic-metric]
+command=agentic-metric bar
+interval=60
+```
+
+**tmux：**
+
+```tmux
+set -g status-right '#(agentic-metric bar | head -1)'
+set -g status-interval 60    # 每 60 秒刷新一次（默认 15 秒）
+```
+
+**vim / neovim statusline：**
+
+```vim
+set statusline+=%{system('agentic-metric\ bar\ \|\ head\ -1')}
+" statusline 在光标移动、模式切换等事件时自动刷新
+" 如需定时刷新，可添加 timer：
+autocmd CursorHold * redrawstatus
+set updatetime=60000          " 空闲 60 秒后触发 CursorHold
+```
+
+### TUI 快捷键
+
+| 键 | 功能 |
+|----|------|
+| `q` | 退出 |
+| `r` | 刷新数据 |
+| `Tab` | 切换 Dashboard / History 标签页 |
+
+## 各 Agent 统计口径差异
+
+不同 agent 在本地暴露的数据详细程度不同：
+
+| 字段 | Claude Code | Codex | Cursor | VS Code (Copilot) | OpenCode |
+|------|:-----------:|:-----:|:------:|:-----------------:|:--------:|
+| 会话 ID | ✓ JSONL 文件 | ✓ JSONL 文件 | ✓ composerId | ✓ sessionId | ✓ session 表 |
+| 项目路径 | ✓ | ✓ | ◐ 部分（从 bubble 或 conversationState 提取） | ✓ workspace.json URI | ✓ session.directory（启动目录） |
+| Git 分支 | ✓ | ✓ | ✗ 不存储 | ✗ 不存储 | ✗ 不存储 |
+| 模型名称 | ✓ | ✓ | ✓ 但 "default" 模式不记录实际模型 | ✓ result.details（如 "Claude Haiku 4.5 • 1x"） | ✓ message.modelID |
+| Input tokens | ✓ 逐条累加 | ✓ 累计值 | ◐ 仅旧版本 | ◐ 仅 JSONL 格式 | ✓ 逐条累加 |
+| Output tokens | ✓ 逐条累加 | ✓ 累计值 | ◐ 仅旧版本 | ◐ 仅 JSONL 格式 | ✓ 逐条累加（含 reasoning） |
+| Cache tokens | ✓ 读+写 | ✓ 仅读 | ✗ 不暴露 | ✗ 不暴露 | ◐ 仅读（write 始终为 0） |
+| 用户轮次 | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 消息总数 | ✓ 所有消息 | ✓ 仅 AI 回复 | ✓ 所有消息 | ✓ 轮次 × 2 | ✓ 所有消息 |
+| 首条/末条 prompt | ✓ | ✓ | ✓ 从 bubble text 提取 | ✓ message.text | ✓ 从 part 表提取 |
+| 成本估算 | ✓ | ✓ | ◐ 仅在有 token 数据时可估算 | ◐ 仅在有 token 数据时可估算 | ◐ 全部为估算（上报 cost 始终为 0） |
+| 实时活跃状态 | ✓ PID + 会话文件精确匹配 | ✓ PID + 会话文件精确匹配 | ◐ 仅进程级检测（标记最新会话为活跃） | ◐ 仅进程级检测 | ✓ PID + DB 会话匹配 |
+
+**主要差异说明：**
+
+- **Claude Code 和 Codex** — 每个运行中的进程对应一个 JSONL 会话文件，文件内含唯一 session ID，因此可以精确匹配 live 进程和数据库会话。
+- **Cursor** — 实时检测只能获取进程 PID，而历史会话使用 `state.vscdb` 中的 composer UUID。两者无法关联，因此仅在 Cursor 进程运行时将最新会话标记为活跃。
+- **Token 覆盖率** — Cursor 在早期版本（约 2025-05 至 2025-12）会在 `state.vscdb` 的 bubble 数据中记录 `tokenCount`（input/output），但新版本不再填充该字段（值始终为 0）。Cursor 已将用量追踪迁移至服务端，近期会话的本地 token 数据不可用。Cache token 细分（读/写）从未可用。
+- **模型名称** — Cursor 的 "default" 模型设置不记录后端实际使用的模型，这类会话在模型列显示为 `default`。
+- **VS Code (Copilot Chat)** — 存在两种存储格式：旧版 JSON（无 token 数据）和新版增量 JSONL（含 `result.usage`，包括 `promptTokens`/`completionTokens`）。Token 用量仅在 JSONL 格式的会话中可用。模型名称从 Copilot 的显示字符串（如 "GPT-4o • 1x"）提取并归一化为定价键。工作区路径支持本地（`file://`）、SSH 远程（`vscode-remote://ssh-remote+host`）和容器（`attached-container+...`）URI。
+- **OpenCode** — 数据存储在本地 SQLite 数据库（`opencode.db`）。Token 数据按消息粒度记录，包含 `input`、`output`、`reasoning` 和 `cache.read`/`cache.write` 字段。Reasoning tokens 计入 output tokens（按 output 费率计费）。消息中的 `cost` 字段始终为 0，因此所有成本均通过定价表估算。`cache.write` 也始终为 0。
+
+## 隐私
+
+- 不联网，不发送任何数据
+- 不修改 agent 的配置或数据文件（只读）
+- 所有统计数据存储在本地 SQLite 数据库
+- 可随时删除 `~/.local/share/agentic_metric/` 清除所有数据

agentic_metric-0.1.0/README.md

@@ -0,0 +1,123 @@
+# Agentic Metric
+
+[中文文档](README-CN.md)
+
+A local-only monitoring tool for AI coding agents. Track token usage and costs across Claude Code, Codex, Cursor, OpenCode, VS Code (Copilot Chat), and more — with a TUI dashboard and CLI.
+
+**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** — Estimated based on token usage and per-model pricing tables, not actual billing. Useful as a reference, but may differ from real costs due to caching discounts, plan-specific pricing, etc.
+- **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 and Cursor, extensible
+
+## Data Sources
+
+| Agent | Path | Data |
+|-------|------|------|
+| Claude Code | `~/.claude/projects/` | JSONL sessions, token usage, model, branch |
+| Claude Code | `~/.claude/stats-cache.json` | Daily activity stats |
+| Cursor | `~/.config/Cursor/User/globalStorage/state.vscdb` | Composer sessions, token usage, model |
+| Cursor | Process detection | Running status, working directory |
+| Codex | `~/.codex/sessions/` | JSONL sessions, token usage, model |
+| VS Code | `~/.config/Code/User/workspaceStorage/*/chatSessions/` | Chat sessions (JSON + JSONL), token usage (JSONL only), model |
+| VS Code | `~/.config/Code/User/globalStorage/emptyWindowChatSessions/` | Empty-window chat sessions |
+| VS Code | Process detection | Running status, working directory |
+| OpenCode | `~/.local/share/opencode/opencode.db` | SQLite sessions, messages, token usage, model |
+| OpenCode | Process detection | Running status, active session matching |
+
+All aggregated data is stored locally in `~/.local/share/agentic_metric/data.db` (SQLite).
+
+## Installation
+
+```bash
+pip install agentic-metric
+```
+
+## Usage
+
+```bash
+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
+```
+
+### 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:**
+
+```ini
+[agentic-metric]
+command=agentic-metric bar
+interval=60
+```
+
+**tmux:**
+
+```tmux
+set -g status-right '#(agentic-metric bar | head -1)'
+set -g status-interval 60    # refresh every 60 seconds (default 15)
+```
+
+**vim / neovim statusline:**
+
+```vim
+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
+
+| Key | Action |
+|-----|--------|
+| `q` | Quit |
+| `r` | Refresh data |
+| `Tab` | Switch Dashboard / History tab |
+
+## Agent Data Coverage
+
+Different agents expose different levels of local data. Here's what's available for each:
+
+| Field | Claude Code | Codex | Cursor | VS Code (Copilot) | OpenCode |
+|-------|:-----------:|:-----:|:------:|:-----------------:|:--------:|
+| Session ID | ✓ JSONL | ✓ JSONL | ✓ composerId | ✓ sessionId | ✓ session table |
+| Project path | ✓ JSONL | ✓ JSONL | ◐ partial (from bubble or conversationState) | ✓ workspace.json URI | ✓ session.directory (launch cwd) |
+| Git branch | ✓ JSONL | ✓ JSONL | ✗ not stored | ✗ not stored | ✗ not stored |
+| Model | ✓ JSONL | ✓ JSONL | ✓ modelConfig / bubble modelInfo | ✓ result.details (e.g. "Claude Haiku 4.5 • 1x") | ✓ message.modelID |
+| Input tokens | ✓ per-message | ✓ cumulative | ◐ older versions only | ◐ JSONL format only | ✓ per-message |
+| Output tokens | ✓ per-message | ✓ cumulative | ◐ older versions only | ◐ JSONL format only | ✓ per-message (includes reasoning) |
+| Cache tokens | ✓ read + write | ✓ read only | ✗ not exposed | ✗ not exposed | ◐ read only (write always 0) |
+| User turns | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Message count | ✓ all messages | ✓ AI replies only | ✓ all messages | ✓ turns × 2 | ✓ all messages |
+| First/last prompt | ✓ | ✓ | ✓ from bubble text | ✓ message.text | ✓ from part table |
+| Cost estimation | ✓ | ✓ | ◐ only when tokens available | ◐ only when tokens available | ◐ estimated only (reported cost always 0) |
+| Live active status | ✓ PID + session file match | ✓ PID + session file match | ◐ process-level only (latest session marked active) | ◐ process-level only | ✓ PID + DB session match |
+
+**Key differences:**
+
+- **Claude Code & Codex** — Each running process maps to a JSONL session file with a unique session ID. This allows precise matching between live processes and DB sessions for accurate active status.
+- **Cursor** — Live detection only sees the process PID, while historical sessions use composer UUIDs from `state.vscdb`. There is no way to link a running Cursor process to a specific composer session, so the most recent session is marked active when the process is running.
+- **Token coverage** — Cursor stored per-bubble `tokenCount` (input/output) in `state.vscdb` in earlier versions (~2025-05 to ~2025-12), but newer versions no longer populate this field — all values are zero. Cursor appears to have moved usage tracking to a server-side system, so local token data is unavailable for recent sessions. Cache token breakdown (read/write) has never been available.
+- **Model name** — Cursor's "default" model setting doesn't record which model was actually used on the backend. These sessions show `default` in the model column.
+- **VS Code (Copilot Chat)** — Has two storage formats: legacy JSON (older sessions, no token data) and newer incremental JSONL (with `result.usage` containing `promptTokens`/`completionTokens`). Token usage is only available for sessions stored in JSONL format. Model names are extracted from Copilot's display strings (e.g. "GPT-4o • 1x") and normalized to pricing keys. Workspace paths support local (`file://`), SSH remote (`vscode-remote://ssh-remote+host`), and container (`attached-container+...`) URIs.
+- **OpenCode** — Stores all data in a local SQLite database (`opencode.db`). Token data is per-message with `input`, `output`, `reasoning`, and `cache.read`/`cache.write` fields. Reasoning tokens are counted as output tokens (billed at output rate). The `cost` field in messages is always 0, so all costs are estimated using the pricing table. `cache.write` is also always 0.
+
+## 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 `~/.local/share/agentic_metric/` at any time to remove all data

agentic_metric-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentic-metric"
+version = "0.1.0"
+description = "Agentic coding metric monitor — multi-agent, TUI, CLI"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "MrQianjinsi", email = "mrqianjinsi@gmail.com" },
+]
+keywords = ["ai", "coding-agent", "metrics", "tui", "claude-code", "cursor", "codex"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "textual>=1.0.0",
+    "textual-plotext>=0.3.0",
+    "rich>=13.0.0",
+    "typer>=0.9.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/MrQianjinsi/agentic_metric"
+Repository = "https://github.com/MrQianjinsi/agentic_metric"
+Issues = "https://github.com/MrQianjinsi/agentic_metric/issues"
+
+[project.scripts]
+agentic-metric = "agentic_metric.cli:app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentic_metric"]

agentic_metric-0.1.0/src/agentic_metric/__init__.py

@@ -0,0 +1,3 @@
+"""Agentic Metric — multi-agent coding metric monitor."""
+
+__version__ = "0.1.0"

agentic_metric-0.1.0/src/agentic_metric/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point: python -m agentic_metric."""
+
+from .cli import app
+
+if __name__ == "__main__":
+    app()