# Mine

> Analyzes Claude Code session logs to report token usage, tool and skill rankings, and session search by prompt text.

- Skill: `sdiamante13/mine` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add sdiamante13/mine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sdiamante13/mine/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics, Data Analysis
- Tags: Analytics, Claude Code, Jsonl, Session Logs, Session Search, Skill Usage, Token Usage, Tool Usage
- Author: SDiamante13 (https://skillmd.com/u/sdiamante13)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/sdiamante13/mine

---


# 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
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
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
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
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
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.