Session intelligence for Claude Code
Search, analyze, and manage every session across all your projects.

Claude Code writes a JSONL file for every session you run. These files live in ~/.claude/projects/ and contain everything — messages, tool calls, token counts, diffs, tasks. But there's no built-in way to search or analyze them.

This plugin reads those files and gives you 11 skills and a web dashboard to make sense of your session history.

Register the marketplace, then install:

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

That's it. No API keys, no config, no runtime dependencies. Most operations are read-only; the delete and cleanup skills can remove session files when explicitly invoked.

Use these directly in Claude Code:

A local web UI for browsing sessions visually:

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

4 views:

• Dashboard — session count, pending tasks, recent activity, quick navigation
• Sessions — sortable table with project, duration, messages, size. Bulk select and delete
• Search — full-text search with context snippets and session linking
• Tasks — grouped by status (in progress / pending / completed), orphan detection

Session detail — click any session to see its full transcript, tool usage breakdown, token consumption bar, and task lists. Filter tool calls in/out. Paginated message loading.

Keyboard shortcut: Cmd+K jumps to search from anywhere.

Three TypeScript modules, one HTTP server, zero runtime dependencies:

lib/
├── formatters.ts        # JSON serialization, truncation, timestamp parsing
├── session-parser.ts    # Single-session JSONL parser (stats, messages, tools, diffs)
└── session-store.ts     # Cross-session operations (list, search, filter, aggregate)

ui/
├── server.ts            # Bun HTTP server — 10 REST endpoints + static files
└── public/              # Alpine.js SPA, OKLCH design tokens, light/dark theme

skills/                  # Skill definitions
tests/                   # Bun test runner, fixture-based

Data flow: Claude Code writes JSONL → this plugin reads it. Nothing is modified. Tasks come from ~/.claude/tasks/ with JSONL fallback for older sessions.

Each lib file doubles as a CLI:

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-store.ts tasks --status pending
bun run lib/session-parser.ts stats path/to/session.jsonl
bun run lib/session-parser.ts export path/to/session.jsonl --format md

Prerequisites: Bun v1.3+

# Install
bun install

# Run tests
bun test

# Typecheck
bun run typecheck

# Lint (Biome)
bun run lint

# Start the UI
bun run ui

MIT