Skip to content

CLI commands

The recall binary is on your PATH after npm link. Every command has --help.

Index

recall index             # scan for new/changed sessions and ingest them
recall index --force     # reindex everything from scratch
recall index -v          # verbose output per file

The daemon watcher does this automatically in the background. Manual recall index is a fallback.

Daemon lifecycle

recall start             # start background daemon (watcher + localhost HTTP)
recall stop              # stop daemon cleanly
recall open              # open the web UI; auto-starts daemon if needed
recall status            # db path, size, session counts, daemon state

Explore from the terminal

recall projects          # project list with session counts
recall list              # 30 most-recent sessions (all projects)
recall list -p Tools     # filter by project-name substring
recall list -n 100       # limit

Read a session

recall show abc12345     # pretty transcript; auto-pages through `less` if long
recall show abc12345 --raw       # raw JSONL lines (debug)
recall show abc12345 --no-pager  # dump to stdout without pager

Search

recall search "zod schema"                    # full-text search across everything
recall search "auth flow" -p Pest-Control     # scope to one project
recall search bug -n 50                       # up to 50 hits

Context re-injection (the moat)

recall context abc12345                  # condensed markdown to stdout
recall context abc12345 | pbcopy         # to clipboard (macOS)
recall context abc12345 | claude         # pipe into new Claude session
recall context abc12345 --full           # full transcript (huge)
recall context abc12345 --since 2h       # only last 2 hours
recall context abc12345 --since 1d       # only last day
recall context abc12345 --since 2026-04-18        # only since date
recall context abc12345 --prelude "continue this conversation"
recall context abc12345 --subagents      # include subagent messages