Agent Usage Stat — Data skill for Claude Code
Local usage analytics portal for Claude Code and Codex.
How to install Agent Usage Stat
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open yiliangs/agent-usage-stat and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Agent Usage Stat does
Local usage analytics portal for Claude Code and Codex.
Alternatives in Data
- Portaljs Add Dataset — Add a dataset (CSV, TSV, JSON, or GeoJSON) to an existing PortalJS portal 2.3k ★
- Agentsview — Local-first session intelligence and analytics for coding agents, supporting Claude Code, Codex, and 14 other 824 ★
- Token Dashboard — See where Claude Code is burning tokens - turn raw JSONL transcripts into local cost analytics, hotspot views 669 ★
README
Agent Usage Stat
A private desktop analytics app for understanding how Claude Code, OpenAI Codex, GitHub Copilot CLI, and opencode use tokens, time, and API-equivalent cost.
Agent Usage Stat turns local coding-agent transcripts into one searchable usage ledger. Compare providers and models, follow spend and token volume, inspect projects and sessions, and see when work happened. Prompt and response text never enters the ledger.
Supported
- Windows and macOS
- Claude Code
- OpenAI Codex, including Codex sessions used through ChatGPT
- GitHub Copilot CLI
- opencode
Agent Usage Stat does not read general ChatGPT or Claude.ai chats. All usage data stays on the local machine or in the folder selected by the user.
Install
Download the current installer from [GitHub Releases](https://github.com/yiliangs/agent-usage-stat/releases):
- Windows installer:
Agent-Usage-Stat-Setup.exe - Windows portable:
Agent.Usage.Stat-win32-x64-*.zip - macOS, Apple Silicon:
Agent.Usage.Stat-*-arm64.dmg - macOS portable, Apple Silicon:
Agent.Usage.Stat-darwin-arm64-*.zip
The macOS build is Apple Silicon only. Intel Macs are not covered by a release yet, because the bundled capture helper is a single executable built for one architecture at a time.
No separate Node.js or npm installation is required.
The macOS build is ad-hoc signed rather than notarized, so Gatekeeper blocks the first launch. After dragging the application into `/Applications`, open it once with Control-click, then **Open**. If macOS still refuses, clear the download quarantine flag and try again:
xattr -dr com.apple.quarantine "/Applications/Agent Usage Stat.app"On first launch, choose where to keep the durable usage ledger and how sessions should be captured. Agent Usage Stat then reconciles existing sess
Related Skills
Tokenmaxx
A local proxy that aggregates usage across your Codex and Claude Code accounts — with live token-throughput an
AI Usage Tray
Windows tray app for monitoring AI quota usage across Claude, Codex, Z.AI and Copilot accounts, with local cos
Skillusage
Skill / slash-command usage analytics for Claude Code and Codex, from local on-disk data
Token Usage
Local LLM token usage analytics for Claude, Codex, OpenCode, ZCode, WorkBuddy, and Zhipu-AutoClaw — build your
Agent Telemetry
Live local dashboard for AI coding-tool usage — Claude Code, Claude Desktop, Codex, GitHub Copilot, Cursor, op
Coding Agent Usage
Live local dashboard for AI coding-tool usage — Claude Code, Claude Desktop, Codex, GitHub Copilot, Cursor, op
Related Agents
Usage Scout
Read-only scout for session, token, and cost code in this FastAPI tracker. Use when the user asks where usage
Figma Analytics
Use to audit the Figma library side of the design system: override hotspots (instances drifted from their main
UI UX Developer
Use when building or modifying UI components, pages, hooks, theme-token usage, styling, layouts, or any visual
