# claude-code-sessions

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 54 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/productivity/claude-code-sessions
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/claude-code-sessions

## What it 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.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill productivity/claude-code-sessions
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/claude-code-sessions/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/claude-code-sessions/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/claude-code-sessions/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/claude-code-sessions/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates cli-tool/components/skills/productivity/claude-code-sessions
```

2. **Manually: put the files in place**
- File: `.github/skills/claude-code-sessions/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill claude-code-sessions -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/productivity/claude-code-sessions
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/claude-code-sessions/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/productivity/claude-code-sessions

## When to use it
- 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
- 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.

## Similar
- [token-dashboard](https://affpapa.org/en/nevibecode/skills/token-dashboard.md) — skill · 477 installs
- [deja-vu](https://affpapa.org/en/nevibecode/plugins/deja-vu.md) — plugin · ★ 1645 repo stars
- [codeledger](https://affpapa.org/en/nevibecode/plugins/codeledger.md) — plugin · ★ 9 repo stars
- [daily-focus-board](https://affpapa.org/en/nevibecode/skills/daily-focus-board.md) — skill · 29 installs
- [session-history](https://affpapa.org/en/nevibecode/skills/session-history.md) — skill · 14800 installs
- [mem-search](https://affpapa.org/en/nevibecode/skills/mem-search.md) — skill · 9500 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 745 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
