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: <name>.<YYYY-MM>.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.

Related Skills

• ork:explore

• Codebase exploration and analysis

• ork:feedback

• Capture user feedback

• ork:remember

• Store project knowledge

• ork:doctor

• Health check diagnostics