claude-code-sessions — Claude Code skill: features and install
claude-code-sessions is a Claude Code skill for searching and analyzing session history. Find earlier work, inspect token use, or rebuild context from a past session.
no license 54 installs updated 2026-11-17
npx claude-code-templates@latest --skill productivity/claude-code-sessionsWhat claude-code-sessions does
The skill reads Claude Code session files from ~/.claude/projects/ and lets you search their contents, inspect usage stats, and track tasks across sessions. Its 11 skills cover searches, session comparisons, Markdown exports, and prompts that recover context for earlier work.
Most actions only read session data; separate skills handle deletion. Session files must be available under ~/.claude/projects/. The web dashboard runs with bun run ui and serves at localhost:3000, so Bun is needed for that interface. Core features need no API key or extra runtime dependencies.
What it helps with
- locate a session by searching its messages
- inspect token use and model distribution
- compare files and tools across two sessions
- find unfinished tasks across projects
- reconstruct context from an earlier session
Example prompts for the agent
- Find the session where I worked on a database migration.
- Show token usage and model distribution across my projects.
- Create a prompt that restores context from this session.
How to install claude-code-sessions
1claude-code-templates
npx claude-code-templates@latest --skill productivity/claude-code-sessions2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a claude-code3Manually: put the files in place
~/.claude/skills/claude-code-sessions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/claude-code-sessions/
1Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a codex2Manually: put the files in place
.agents/skills/claude-code-sessions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a cursor2Manually: put the files in place
.cursor/skills/claude-code-sessions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates cli-tool/components/skills/productivity/claude-code-sessions2Manually: put the files in place
.github/skills/claude-code-sessions/SKILL.md1Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a gemini-cli2Platform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/productivity/claude-code-sessionsManually: put the files in place
.devin/skills/claude-code-sessions/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about claude-code-sessions
How do I install claude-code-sessions in Claude Code?
Run npx claude-code-templates@latest --skill productivity/claude-code-sessions.
What does claude-code-sessions do?
It searches and analyzes Claude Code session history, including usage stats and tasks. It can compare sessions, export them as Markdown, and create a context-recovery prompt.
What does the claude-code-sessions dashboard need?
Bun is needed to run the dashboard. Start it with bun run ui and open localhost:3000; session files are read from ~/.claude/projects/.