Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
davila7 avatar

Claude Code Sessions

  • 11 installs
  • 30.1k repo stars
  • Updated August 4, 2026
  • davila7/claude-code-templates

Search, analyze, and manage Claude Code session history from the JSONL files on disk, with token usage stats, tool breakdowns, and a web dashboard.

About

Reads Claude Code's session JSONL files to make past sessions searchable and analyzable, offering 11 skills plus a localhost dashboard. A developer uses it to find past work, check token usage, resume sessions, or manage orphaned tasks.

  • 11 read-only session skills plus delete/cleanup operations
  • Web dashboard with search, stats, and task views, no API keys needed

Claude Code Sessions by the numbers

  • 11 all-time installs (skills.sh)
  • Ranked #2,178 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/davila7/claude-code-templates --skill claude-code-sessions

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs11
repo stars30.1k
Last updatedAugust 4, 2026
Repositorydavila7/claude-code-templates

What it does

Search, analyze, and manage Claude Code session history from the JSONL files on disk, with token usage stats, tool breakdowns, and a web dashboard.

Files

SKILL.mdMarkdownGitHub ↗

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:

SkillPurpose
/session-search "query"Full-text search across every session
/session-statsToken usage, model distribution, tool breakdown
/session-listList sessions sorted by recency, size, or duration
/session-detailDeep dive into a specific session
/session-diffCompare two sessions — files, tools, topics
/session-timelineChronological view of sessions on a project
/session-resumeGenerate a context recovery prompt from any session
/session-tasksFind pending and orphaned tasks across sessions
/session-exportExport a session as clean markdown
/session-cleanupFind empty, tiny, or stale sessions
/session-deleteDelete 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

/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:

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:

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

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.