spool

Name: spool
Author: spool-lab

Verified

Your local AI session library. Collects sessions from Claude Code, Codex CLI, Gemini CLI (and more) — browsable and ⌘K-searchable.

531stars

37forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/spool-lab/spool

Getting Started

Guides for using ai agents skills like spool.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/16/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-16T06:21:48.612Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is spool?

spool is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by spool-lab. Your local AI session library. Collects sessions from Claude Code, Codex CLI, Gemini CLI (and more) — browsable and ⌘K-searchable. It has 531 GitHub stars.

Is spool safe to use?

Yes. spool passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install spool?

Clone the repository with "git clone https://github.com/spool-lab/spool" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is spool written in?

spool is primarily written in TypeScript. It is open-source under spool-lab on GitHub, so you can review or fork the full source.

Are there alternatives to spool?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh spool against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

concierge kooky

Spool

Your local AI session library.

Spool collects every Claude Code, Codex CLI, and Gemini CLI session you've ever had into a sidebar of projects you can browse, pin, and revisit. Press ⌘K to search across the whole archive.

Early stage. Spool is under active development — expect rough edges. Feedback, bug reports, and ideas are very welcome via Issues or Discord.

Install

curl -fsSL https://spool.pro/install.sh | bash

macOS / Apple Silicon only. Or build from source:

pnpm install
pnpm build
# DMG is in packages/app/dist/

What it does

Spool turns the pile of AI sessions sitting on your disk into a browsable library.

Library shell — sidebar of projects (derived from working-dir paths across agents) and a main pane that shows recent + pinned sessions for whatever you've selected
Session indexing — watches Claude/Codex/Gemini session dirs in real time, including profile-based paths like ~/.claude-profiles/*/projects, ~/.codex-profiles/*/sessions, and Gemini's project temp dirs under ~/.gemini/tmp/*/chats
Pin — keep important sessions on top of their project and on the global Library Home
⌘K search — fast full-text search scoped to All or the current project; AI mode synthesizes answers across fragments
Agent search — a /spool skill inside Claude Code (and any ACP agent) feeds matching fragments back into your conversation

Everything stays on your machine. Nothing leaves.

Looking for connectors (Twitter / GitHub / Reddit / etc.)? They now live in Spool Daemon, a sibling app focused on syncing platform data.

Architecture

packages/
  app/      Electron macOS app (React + Vite + Tailwind)
  core/     Indexing engine (SQLite + FTS5)
  cli/      CLI interface (`spool search ...`)
  landing/  spool.pro website

Development

pnpm install
pnpm exec electron-rebuild -f -w better-sqlite3   # rebuild native modules for Electron
pnpm dev          # starts app + landing in dev mode
pnpm test         # runs all tests

Note: The electron-rebuild step is required whenever you run pnpm install or switch Node.js versions. Without it, the Electron app will crash at launch with a NODE_MODULE_VERSION mismatch error from better-sqlite3.

If you switch between Node-side tests and Electron app/e2e runs, rebuild better-sqlite3 for the matching runtime:

pnpm run rebuild:native:node      # before @spool/core / Node-based tests
pnpm run rebuild:native:electron  # before launching the Electron app or e2e tests

Dev DB isolation

pnpm dev points Spool at ~/.spool-dev/ instead of your real ~/.spool/, so iterating on schema migrations or destructive maintenance never touches the database you actually use. The dev DB starts empty; seed it from your real one only when you want realistic data:

pnpm --filter @spool/app dev:seed-from-prod   # copies ~/.spool/ → ~/.spool-dev/
pnpm --filter @spool/app dev:reset-db         # wipes ~/.spool-dev/

Override the dev location with SPOOL_DATA_DIR=/some/path pnpm dev. The isolation kicks in automatically in dev mode; production builds always use the real ~/.spool/.

Release

./scripts/release.sh        # bump version, push tag, dispatch CI release workflow

Build + signing happen in GitHub Actions (see .github/workflows/release.yml) so releases are never tied to a local developer certificate. The script blocks until CI finishes; artifacts appear on the release page when it returns.

To test a local build without cutting a release, use pnpm --filter @spool/app build:mac.

License

MIT

Trademark

"Spool" and the Spool logo are trademarks of TypeSafe Limited. The MIT License above covers the source code only and does not grant permission to use the Spool name or logo. See the trademark notice in LICENSE for details.