OpenParable
Skip to content
← Back to skills

Claude Code Sessions

Productivity
claude-code-sessions

Claude Code Sessions is an Agent Skill for productivity published in the davila7/claude-code-templates repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Search, analyze, and manage Claude Code session history. Use when the user wants to find past sessions, check token usage, review tool breakdowns, resume previous work, or manage tasks across sessions. Provides 11 skills and a web dashboard.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/davila7/claude-code-templates/blob/HEAD/cli-tool/components/skills/productivity/claude-code-sessions/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/claude-code-sessions, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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