Claude Code Sessions

Session intelligence plugin for Claude Code. Reads the JSONL session files that Claude Code writes to ~/.claude/projects/ and makes them searchable and analyzable.

What It Does

Claude Code records every session as a JSONL file — messages, tool calls, token counts, diffs, tasks. This plugin reads those files and provides two interfaces. Most operations are read-only; delete and cleanup skills can remove session files when explicitly invoked.

11 skills usable directly in Claude Code:

| Skill | Purpose | |-------|---------| | /session-search "query" | Full-text search across every session | | /session-stats | Token usage, model distribution, tool breakdown | | /session-list | List sessions sorted by recency, size, or duration | | /session-detail | Deep dive into a specific session | | /session-diff | Compare two sessions — files, tools, topics | | /session-timeline | Chronological view of sessions on a project | | /session-resume | Generate a context recovery prompt from any session | | /session-tasks | Find pending and orphaned tasks across sessions | | /session-export | Export a session as clean markdown | | /session-cleanup | Find empty, tiny, or stale sessions | | /session-delete | Delete sessions and their associated tasks |

Web dashboard at localhost:3000 with four views: Dashboard (summary stats), Sessions (sortable table with bulk operations), Search (full-text with context snippets), Tasks (grouped by status with orphan detection).

Install

bash
/plugin marketplace add apappascs/claude-code-sessions
/plugin install claude-code-sessions@claude-code-sessions

No API keys. No config. No runtime dependencies. It reads what's already on disk.

For the dashboard:

bash
bun run ui
# → http://localhost:3000

Architecture

Same TypeScript modules power skills, dashboard, and CLI:

lib/formatters.ts      — pure utilities, no I/O
lib/session-parser.ts  — parses one JSONL file into structured data
lib/session-store.ts   — scans all sessions, aggregates, searches
ui/server.ts           — HTTP endpoints + static file serving

Each lib file doubles as a standalone CLI:

bash
bun run lib/session-store.ts list --sort recency --limit 10
bun run lib/session-store.ts search "database migration" --since 2025-01-01
bun run lib/session-parser.ts stats path/to/session.jsonl

Use Cases

• Find the session where you solved a specific problem weeks ago
• See which projects consume the most tokens
• Track pending tasks across all sessions and projects
• Resume a past session with full context
• Compare how two sessions approached the same problem
• Export session transcripts for documentation

Links

• GitHub: github.com/apappascs/claude-code-sessions
• License: MIT