spool

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

Search your thinking with spool — a local search engine over your Claude Code and Codex CLI 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 or codex) 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. [codex] /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 or --source codex 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