CLI Reference

The recall binary is installed to ~/.local/bin/recall by the app.

Usage

recall <search query>
recall --warmup

Commands

recall <query>

Embeds <query> using the local AI model, finds the closest saved command by cosine similarity, and copies it to clipboard.

recall "clean docker"
# → copies: docker system prune -af
# → prints: Copied (89% match): Clean up all Docker resources

Interactive mode (when stdin and stdout are a TTY):

• If multiple results score above the threshold, shows a numbered picker
• Press 1–5 to select, or Enter for the top result

Template variables: If a command contains {placeholders}, recall prompts for values:

recall "deploy to env"
# Command: ./deploy.sh --env {environment}
#   environment: prod
# → copies: ./deploy.sh --env prod

Exit codes:

• 0 — command found and copied
• 1 — no match above threshold

recall --warmup

Pre-loads the AI model into the OS page cache without running a search. Add to .zshrc to reduce cold-start latency on subsequent recall calls:

# ~/.zshrc
(recall --warmup &>/dev/null &)

Environment Variables

Data Location

The SQLite database is at ~/Library/Application Support/recall/recall.db (macOS).