Skip to main content
ClaudeWave
Skill558 repo starsupdated today

spool

Spool is a local search engine that indexes and retrieves conversation history across Claude Code, Codex CLI, Gemini CLI, and OpenCode sessions. Use it to quickly locate past discussions, decisions, and code snippets from your development work by searching through session transcripts stored on your machine, with options to filter by source, date range, and exact phrases.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/paperboytm/spool /tmp/spool && cp -r /tmp/spool/skills/spool ~/.claude/skills/spool
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

Search your thinking with spool — a local search engine over your Claude Code, Codex CLI, Gemini CLI, and OpenCode sessions.

## Steps

1. **Check if spool is installed**

```bash
which spool
```

If the command is not found, tell the user:
> `spool` CLI is not installed. Run: `npm install -g @spool/cli` then `spool sync` to index your sessions.
> Stop here.

2. **Run the search**

```bash
spool search "$ARGS" --json --limit 5
```

where `$ARGS` is everything the user passed to `/spool`.

3. **Present the results**

For each result in the JSON array, show:
- **Session title** and date (`startedAt`)
- **Source** (claude, codex, gemini, or opencode) and **project** path
- The **snippet** with highlighted terms (strip `<mark>` / `</mark>` tags for plain display)
- A note of the session UUID

Example format:
```
1. [claude] /code/myproject — 2026-03-20
   "…evaluated the database sharding tradeoffs and reached a decision…"
   UUID: abc123

2. [opencode] /code/api — 2026-03-18
   "…the race condition was caused by a shared map write without a mutex…"
   UUID: def456
```

4. **Offer to load a full session**

Ask: "Want to see the full conversation for any of these? I can load it with `spool show <uuid>`."

If the user says yes (or specifies a number/UUID), run:

```bash
spool show <uuid>
```

Include the output as context in your next reply.

## Tips

- Add `--source claude`, `--source codex`, `--source gemini`, or `--source opencode` to filter by source
- Add `--since 7d` to limit to the last 7 days
- Use quotes for exact phrases: `/spool "read replicas"`
- Run `spool sync` first if results seem stale