recall command families

Grouped by what each one does to your data and your tokens.

Readno writes, no spend
Writetouches your db
Tokensspends claude budget
Daemonbackground process

Read

No writes, no spend · 7 commands

recall list / show

Browse your indexed history. Pretty transcript pager.

recall search

Full-text with #tag tokens. BM25 plus RRF fusion on Pro.

recall context

Condensed markdown of any session. Pipe into a new claude.

recall neighborhood

Parents, children, citations, similar in one bundle.

recall stats

Tokens and dollars by session, project, or window.

recall infer bug-patterns

Cluster signatures into recurring bug groups.

recall audit-secrets

Scan DB for leaked secrets. Read-only by default.

Write

Touches your DB · 5 commands

recall threads

List, show, link, sync. Auto-detect parent-child links.

recall semantic

On-device 768-d embeddings. Install, status, reindex.

recall paste

Archive clipboard. Secret-scan blocks unsafe content.

recall license / activate

Pro tier activation. One-time HTTPS call.

recall install-extension

Sideload the VS Code, Cursor, or Windsurf VSIX.

Tokens

Spends Claude budget · 1 command

recall infer outputs

Per-session sub-agent extracts bug snippets.

Daemon

Background process · 3 commands

recall start / stop / open

Daemon lifecycle. Loopback HTTP plus watcher.

recall doctor / optimize

Health check, WAL truncate, FTS5 segment merge.

recall mcp

Stdio MCP server for Claude Desktop or Claude Code.

CLI commands

Hero above color-codes commands by safety. Reference:

#Index & daemon

bash

recall index                              # scan + ingest changed sessions
recall index --force                      # reindex from scratch
recall start / stop / open                # daemon lifecycle
recall status                             # db path, size, counts

#Browse

bash

recall projects                           # project list with counts
recall list -p Tools -n 100               # filter by project, limit
recall show abc12345                      # pretty transcript (paged)
recall show abc12345 --raw                # raw JSONL

#Search

bash

recall search "zod schema"                # full-text
recall search "auth flow" -p MyProject    # scope to project
recall search bug -n 50                   # up to 50 hits

#Context (the moat)

bash

recall context abc12345 | pbcopy          # condensed → clipboard
recall context abc12345 | claude          # pipe into a fresh Claude
recall context abc12345 --since 2h        # last 2 hours only
recall context abc12345 --prelude "continue this" | claude
recall neighborhood abc12345              # parents/children/citations bundle
recall neighborhood abc12345 -b 8000      # raise token budget (default 4000)

#Threads

bash

recall threads sync                       # capture running terminals
recall threads scan -p MyProject --apply  # auto-detect parent-child
recall threads link <sid> --thread <tid>  # manual link
recall threads link <sid> --thread <tid> --parent <pid>  # link as child
recall threads show <id>                  # ASCII tree
recall threads new "Auth refactor"        # create a thread
recall threads merge <source> --into <dest>
recall threads split <id> --sessions s1,s2 --name "New"

recall threads <sub> and recall thread <sub> both work.

#Stats & health

bash

recall stats abc12345                     # per-session
recall stats --days 7                     # 7-day rollup
recall doctor                             # DB + pipeline + tab-name invariant audit
recall optimize                           # WAL truncate + FTS5 merge

#Semantic, paste, audit

bash

recall semantic install                   # bge model (~110MB)
recall semantic status                    # backfill progress
recall similar <id> -n 5                  # top 5 related (Pro)
recall paste --label "fix"                # archive clipboard, secret-scan first
recall audit-secrets                      # scan db for leaked keys

#Bug patterns

bash

recall infer outputs --project <name>     # extract bug snippets (LLM, costs tokens)
recall infer bug-patterns --semantic      # local clustering with embedding fuzz

#License & extension

bash

recall activate <key>                     # one-time HTTPS, then offline forever
recall license status                     # tier check
recall install-extension                  # sideload VS Code/Cursor/Windsurf VSIX

#MCP server

bash

recall mcp                                # stdio MCP server
recall mcp --allow-writes                 # enable write tools (off by default)

#Git correlation

bash

recall correlate                          # link sessions to commits in their cwd
recall blame <sha>                        # reverse lookup: commit to session