claude-session-commons

What it does

claude-session-commons is the shared foundation that powers resume-resume and other Claude Code session tools. It handles the hard parts — finding sessions on disk, indexing them, generating summaries, caching results — so tools built on top can focus on their own job.

Key features

• Session discovery — finds all Claude Code sessions across your machine
• Indexing — background daemon pre-indexes sessions as you work
• Summarization — generates and caches session summaries
• Classification — categorizes sessions by type and content
• Search — full-text search across all sessions via CLI

Install

pip install claude-session-commons

Standalone tools

# Background daemon — indexes sessions as you work
claude-session-daemon

# Search sessions from terminal
claude-find "database migration"

# Local web UI for browsing history
claude-session-web

# Force full re-index
claude-session-reindex

Used by resume-resume, claude-boss, and claude-resume-duet. If you're building tools that need access to Claude Code session history, this is the foundation.