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 spoolingCheck it worked:
spooling --version2. 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 theminit 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/... │
└────────────────────┴──────────────────┴──────────────────────────────────────┘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/mcpEverything 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 loginYour 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 sessionsA 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 syncWhat's next
- Working across multiple workspaces: send different projects to different workspaces, or copy a session into more than one.
spooling pushreference: every flag (--cwd,--title,--copy,--project,--dry-run).- MCP endpoint: let your agents call the cloud as a tool.
- Security and privacy: what we store and how it is protected.