Analyze pi session transcripts to discover patterns that could become AGENTS.md rules, skills, or prompt templates. Mines your usage history for automation opportunities.
Resources
4Install
npx skillscat add joelazar/dotfiles/session-analyzer Install via the SkillsCat registry.
SKILL.md
Session Analyzer
Extracts and analyzes your pi session transcripts to find recurring patterns that could be automated.
Usage
# Extract transcripts for current directory
{baseDir}/analyze.js
# Extract transcripts for specific directory
{baseDir}/analyze.js /path/to/project
# Match multiple dirs by pattern (worktrees, variants, etc.)
{baseDir}/analyze.js --pattern orders-app
# Extract + analyze with subagents
{baseDir}/analyze.js --analyze
# Pattern + analyze (finds all matching session dirs)
{baseDir}/analyze.js --pattern orders-app --analyze
# Custom output directory
{baseDir}/analyze.js --output ./my-analysis --analyzeWhat It Does
- Extract: Reads all session files for the given working directory from
~/.pi/agent/sessions/- Use
--patternto match multiple directories (e.g., worktrees, feature branches)
- Use
- Split: Chunks transcripts into ~100k char files (fits in context window)
- Analyze (optional): Spawns pi subagents to identify:
- AGENTS.md patterns: Coding style rules, conventions you repeat
- Skill patterns: Multi-step workflows you do often
- Prompt templates: Reusable prompts for common tasks
Output
Without --analyze:
session-transcripts/
├── session-transcripts-000.txt
├── session-transcripts-001.txt
└── ...With --analyze:
session-transcripts/
├── session-transcripts-000.txt
├── session-transcripts-000.summary.txt # Pattern analysis
├── session-transcripts-001.txt
├── session-transcripts-001.summary.txt
└── FINAL-SUMMARY.txt # Aggregated findingsSetup
Install dependencies (run once):
cd {baseDir}
npm installWhen to Use
- After working on a project for a while, to discover what rules/skills would help
- Periodically to find new automation opportunities
- When you notice you keep giving similar instructions
Adapted from badlogic/pi-mono gist