Session Summary

Every session automatically summarized — files changed, tests run, commands executed, packages installed. No more reading 2,000 messages to understand what the AI did.

Quick start

sfs summary ses_abc

Output:

Debug auth middleware
2.3h | 327 msgs | 28 tool calls | Claude Code
Branch: feature/auth-fix @ a1b2c3d

Files modified (3):
  src/auth/middleware.py
  src/auth/tokens.py
  tests/test_auth.py

Commands: 34
Tests: 6 runs (5 passed, 1 failed)
Packages: pyjwt, redis

What’s extracted

Data	Source
Files modified/read	Read, Write, Edit tool calls
Commands executed	Bash tool calls
Test results	pytest, jest, go test output parsing
Packages installed	pip install, npm install commands
Errors encountered	Error patterns in tool output
Duration	First to last message timestamp

Export as markdown

sfs summary ses_abc --format md > session-summary.md

Today’s sessions

sfs summary --today

Shows a table of all sessions captured today with key metrics.

Dashboard

The Summary tab in the session detail page shows:

• Metric cards (duration, messages, tool calls, tests)
• Files modified and read (expandable)
• Activity section (commands, tests, packages, errors)
• Narrative section (if LLM-generated)