Spooling
CLI Reference
Back to spooling.ai

spooling search

Semantic search across your local session history.

spooling search QUERY [-n LIMIT] [-p PROJECT]

Vector similarity search over every message Spool has ingested locally. Returns the top LIMIT chunks with similarity scores.

Flags

FlagDescription
-n, --limitNumber of results to return. Default: 10.
-p, --projectFilter to a single project name (case-sensitive).
--cloudSearch the cloud workspace instead of the local DB. Requires spooling cloud login.

Example

$ spooling search "where did I fix the auth middleware bug"

1. [78.4%] linear/backend [user] 2026-04-08T14:21:03
   Session: found the issue, session tokens were stored in...
   ...rotating the JWT verification to match new...

2. [71.2%] vercel/next.js [user] 2026-04-02T10:15:44
   Session: rewriting the JWT verification to match new...
   ...staging cluster was using the old secret...

How it works

spooling sync chunks every message into ~512-character windows and embeds them with sentence-transformers/all-MiniLM-L6-v2 (running locally; no API key needed). The chunks land in pgvector, and search runs a cosine-similarity ANN query.

For cross-tool, cross-developer search across a team, the same query is available via the cloud's REST endpoint and MCP endpoint, scoped to the workspace your key authenticates to. See the Cloud API Reference.

On this page