Spooling
Back to spooling.ai

Quickstart

Install Spooling, index your sessions locally, and optionally connect to Spooling Cloud, in a few minutes.

This takes you from a fresh laptop to "my AI coding sessions are searchable", and then, if you want, "my team can search them too."

1. Install

You need Python 3.11 or newer. No Docker, no Postgres and no Node.js are required.

pipx install spooling      # recommended: keeps it isolated
# or: pip install spooling
# or: uv tool install spooling

Check it worked:

spooling --version

2. Detect providers and sync

spooling init     # shows which AI coding tools were found on this machine
spooling sync     # parses their session files into a local database and indexes them

init prints a table like:

┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Provider           ┃ Status           ┃ Path                                 ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Claude Code        │ 67 session files │ ~/.claude/projects                   │
│ Cursor             │ 14 session files │ ~/Library/.../Cursor/User/...        │
│ Kiro               │  3 session files │ ~/Library/.../Kiro/User/...          │
└────────────────────┴──────────────────┴──────────────────────────────────────┘

Provider details →

3. Search and explore

spooling search "that redis race condition"
spooling stats
spooling mcp      # an MCP server your agents can call, on http://127.0.0.1:3004/mcp

Everything so far stays on your machine.

4. (Optional) Connect to Spooling Cloud

Spooling Cloud is the hosted workspace where your team's sessions are pooled and searchable together. It is free while in early access.

Sign up at app.spooling.ai with Google, GitHub or email. If you used email, confirm the address from the link we send you.

spooling login

Your browser opens to approve the login and choose which workspace (personal or a team) this machine pushes to. Add --no-browser on a remote machine to get a link to open yourself.

spooling push --dry-run   # preview what would go up
spooling push             # send your most recent sessions

A login belongs to one workspace. To push to a different one, run spooling login again and pick it in the browser. Prefer to paste a key? Mint one in Settings in the app and run spooling cloud login --key sk_....

5. Keep it running

spooling watch tails the provider directories and keeps the local database fresh. spooling cloud watch (a separate process) keeps the cloud in sync.

spooling watch          # keep the local DB fresh
spooling cloud watch    # keep the cloud workspace in sync

What's next

On this page