CLI Reference
Back to spooling.aispooling 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
| Flag | Description |
|---|---|
-n, --limit | Number of results to return. Default: 10. |
-p, --project | Filter to a single project name (case-sensitive). |
--cloud | Search 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.