spool

name	spool
description	Search your local Claude Code, Codex CLI, Gemini CLI, and OpenCode session history
allowed-tools	Bash

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

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

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:

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