mine

Mine Claude Code session data for analytics — token usage, tool rankings, skill invocations, session search, and prompt history. Use when asked about session stats, token costs, tool frequency, skill

SKILL.md

GitHub

mine

Mine ~/.claude/projects/ session JSONL and index files for analytics and forensics.

Trigger Cues

  • Explicit /mine invocation
  • "How many tokens did I use?" / "What are my most-used tools?"
  • "Find the session where I discussed X"
  • "Which skills do I use most?"
  • "Show me token usage by project/day"

Data Model

  • Sessions: ~/.claude/projects/<project>/<session-id>.jsonl
  • Index: ~/.claude/projects/<project>/sessions-index.json
  • Memory: ~/.claude/projects/<project>/memory/

Scripts

All scripts are in ~/.claude/skills/mine/scripts/. Run them via Bash.

1. Search sessions

Find sessions by prompt text, project, or date range.

bash ~/.claude/skills/mine/scripts/mine-sessions.sh --prompt "auth" --limit 10
bash ~/.claude/skills/mine/scripts/mine-sessions.sh --project dotfiles --since 2026-03-01

2. View session prompts

Extract user/assistant messages from a session.

bash ~/.claude/skills/mine/scripts/mine-prompts.sh --session <path-to-jsonl>
bash ~/.claude/skills/mine/scripts/mine-prompts.sh --session <path> --roles user --limit 20

3. Rank tool usage

See which tools are called most across sessions.

bash ~/.claude/skills/mine/scripts/mine-tools.sh --limit 20
bash ~/.claude/skills/mine/scripts/mine-tools.sh --project ka-ching --since 2026-03-01

4. Token usage

Summarize token consumption.

bash ~/.claude/skills/mine/scripts/mine-tokens.sh --by project --limit 10
bash ~/.claude/skills/mine/scripts/mine-tokens.sh --by day --since 2026-03-20
bash ~/.claude/skills/mine/scripts/mine-tokens.sh --by session --project dotfiles

5. Rank skill invocations

See which skills are invoked most (via Skill tool_use blocks).

bash ~/.claude/skills/mine/scripts/mine-skills.sh --limit 20
bash ~/.claude/skills/mine/scripts/mine-skills.sh --since 2026-03-01

Workflow

  1. Start with session search or index queries to find relevant sessions.
  2. Drill into a specific session with mine-prompts.sh.
  3. Use mine-tools.sh, mine-tokens.sh, mine-skills.sh for aggregate analytics.