# Spool

> Search your local Claude Code and Codex CLI session history

- **Type:** Skill
- **Install:** `agentstack add skill-anneheartrecord-charles-skill-spool`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [anneheartrecord](https://agentstack.voostack.com/s/anneheartrecord)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [anneheartrecord](https://github.com/anneheartrecord)
- **Source:** https://github.com/anneheartrecord/charles-skill/tree/main/skills/spool
- **Website:** https://www.charles-cheng.com/projects

## Install

```sh
agentstack add skill-anneheartrecord-charles-skill-spool
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Search your thinking with spool — a local search engine over your Claude Code and Codex CLI 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 or codex) and **project** path
- The **snippet** with highlighted terms (strip `` / `` 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 `."

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

```bash
spool show 
```

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [anneheartrecord](https://github.com/anneheartrecord)
- **Source:** [anneheartrecord/charles-skill](https://github.com/anneheartrecord/charles-skill)
- **License:** MIT
- **Homepage:** https://www.charles-cheng.com/projects

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-anneheartrecord-charles-skill-spool
- Seller: https://agentstack.voostack.com/s/anneheartrecord
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.