Analyze your Claude Code sessions for patterns, issues, and insights using Braintrust tracing data.
When to Use
- After completing a complex task (retrospective)
- When debugging why something failed
- Weekly review of productivity patterns
- Finding opportunities to create new skills
- Understanding token usage trends
Commands
Run from the project directory:
# Analyze last session - summary with tool/agent/skill breakdown
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session
uv run python -m runtime.harness scripts/braintrust_analyze.py --sessions 5
Agent usage statistics (last 7 days)uv run python -m runtime.harness scripts/braintrust_analyze.py --agent-stats
Skill usage statistics (last 7 days)uv run python -m runtime.harness scripts/braintrust_analyze.py --skill-stats
Detect loops - find repeated tool patterns (>5 same tool calls)uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops
Replay specific session - show full sequence of actionsuv run python -m runtime.harness scripts/braintrust_analyze.py --replay
Weekly summary - daily activity breakdownuv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary
Token trends - usage over timeuv run python -m runtime.harness scripts/braintrust_analyze.py --token-trends
## Options
- `--project NAME` - Braintrust project name (default: agentica)
## What You'll Learn
### Session Analysis
- Tool usage breakdown
- Agent spawns (plan-agent, debug-agent, etc.)
- Skill activations (/commit, /research, etc.)
- Token consumption estimates
### Loop Detection
Find sessions where the same tool was called repeatedly, which may indicate:
- Stuck in a search loop
- Inefficient approach
- Opportunity for better tooling
### Usage Patterns
- Which agents you use most
- Which skills get activated
- Daily/weekly activity trends
## Examples
### Quick Retrospective
```bash
# What happened in my last session?
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session
Output:
## Session Analysis
**ID:** `92940b91...`
**Started:** 2025-12-24T01:31:05Z
**Spans:** 14
### Tool Usage
- Read: 4
- Bash: 2
- Edit: 2
...
Find Loops
uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops
Weekly Review
uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary
Requirements
- BRAINTRUST_API_KEY in ~/.claude/.env or project .env
- Braintrust tracing enabled (via braintrust-claude-plugin)