Cross-Project Analytics Query local analytics data from ~/.claude/analytics/ . All data is local-only, privacy-safe (hashed project IDs, no PII). Subcommands Parse the user's argument to determine which report to show. If no argument provided, use AskUserQuestion to let them pick. Subcommand Description Data Source Reference agents Top agents by frequency, duration, model breakdown agent-usage.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md models Model delegation breakdown (opus/sonnet/haiku) agent-usage.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md skills Top skills by invocation count skill-usage.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md hooks Slowest hooks and failure rates hook-timing.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md teams Team spawn counts, idle time, task completions team-activity.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md session Replay a session timeline with tools, tokens, timing CC session JSONL ${CLAUDE_SKILL_DIR}/references/session-replay.md cost Token cost estimation with cache savings stats-cache.json ${CLAUDE_SKILL_DIR}/references/cost-estimation.md trends Daily activity, model delegation, peak hours stats-cache.json ${CLAUDE_SKILL_DIR}/references/trends-analysis.md summary Unified view of all categories All files ${CLAUDE_SKILL_DIR}/references/jq-queries.md Quick Start Example
Top agents with model breakdown
jq -s 'group_by(.agent) | map({agent: .[0].agent, count: length}) | sort_by(-.count)' ~/.claude/analytics/agent-usage.jsonl
All-time token costs
- jq
- '.modelUsage | to_entries | map({model: .key, input: .value.inputTokens, output: .value.outputTokens})'
- ~/.claude/stats-cache.json
- Quick Subcommand Guide
- agents
- ,
- models
- ,
- skills
- ,
- hooks
- ,
- teams
- ,
- summary
- — Run the jq query from
- Read("${CLAUDE_SKILL_DIR}/references/jq-queries.md")
- for the matching subcommand. Present results as a markdown table.
- session
- — Follow the 4-step process in
- Read("${CLAUDE_SKILL_DIR}/references/session-replay.md")
-
- locate session file, resolve reference (latest/partial/full ID), parse JSONL, present timeline.
- cost
- — Apply model-specific pricing from
- Read("${CLAUDE_SKILL_DIR}/references/cost-estimation.md")
- to CC's stats-cache.json. Show per-model breakdown, totals, and cache savings.
- trends
- — Follow the 4-step process in
- Read("${CLAUDE_SKILL_DIR}/references/trends-analysis.md")
- daily activity, model delegation, peak hours, all-time stats.
summary
— Run all subcommands and present a unified view: total sessions, top 5 agents, top 5 skills, team activity, unique projects.
Data Files
Load
Read("${CLAUDE_SKILL_DIR}/references/data-locations.md")
for complete data source documentation.
File
Contents
agent-usage.jsonl
Agent spawn events with model, duration, success
skill-usage.jsonl
Skill invocations
hook-timing.jsonl
Hook execution timing and failure rates
session-summary.jsonl
Session end summaries
task-usage.jsonl
Task completions
team-activity.jsonl
Team spawns and idle events
Rules
Each category has individual rule files in
rules/
loaded on-demand:
Category
Rule
Impact
Key Pattern
Data Integrity
${CLAUDE_SKILL_DIR}/rules/data-privacy.md
CRITICAL
Hash project IDs, never log PII, local-only
Cost & Tokens
${CLAUDE_SKILL_DIR}/rules/cost-calculation.md
HIGH
Separate pricing per token type, cache savings
Performance
${CLAUDE_SKILL_DIR}/rules/large-file-streaming.md
HIGH
Streaming jq for >50MB, rotation-aware queries
Visualization
${CLAUDE_SKILL_DIR}/rules/visualization-recharts.md
HIGH
Recharts charts, ResponsiveContainer, tooltips
Visualization
${CLAUDE_SKILL_DIR}/rules/visualization-dashboards.md
HIGH
Dashboard grids, stat cards, widget registry
Total: 5 rules across 4 categories
References
Reference
Contents
${CLAUDE_SKILL_DIR}/references/jq-queries.md
Ready-to-run jq queries for all JSONL subcommands
${CLAUDE_SKILL_DIR}/references/session-replay.md
Session JSONL parsing, timeline extraction, presentation
${CLAUDE_SKILL_DIR}/references/cost-estimation.md
Pricing table, cost formula, daily cost queries
${CLAUDE_SKILL_DIR}/references/trends-analysis.md
Daily activity, model delegation, peak hours queries
${CLAUDE_SKILL_DIR}/references/data-locations.md
All data sources, file formats, CC session structure
Important Notes
All files are JSONL (newline-delimited JSON) format
For large files (>50MB), use streaming
jq
without
-s
— load
Read("${CLAUDE_SKILL_DIR}/rules/large-file-streaming.md")
Rotated files:
. .jsonl — include for historical queries team field only present during team/swarm sessions pid is a 12-char SHA256 hash — irreversible, for grouping only Output Format Present results as clean markdown tables. Include counts, percentages, and averages. If a file doesn't exist, note that no data has been collected yet for that category.