Features

Command Library

The Commands tab lists all saved commands.

Filter bar — fuzzy filter by description, command text, or tags (⌘F)
Sort — Recently Added / Most Used / Recently Used / A–Z
Tag chips — click a tag to filter by it; multiple tags = AND filter
Copy — copies command to clipboard, increments use count
Edit / Delete — edit in the modal or delete with 5-second undo toast
Keyboard nav — ↑↓ to select, Enter to copy, ⌘E to edit, Delete to delete

Template Variables

Commands can contain {variable} placeholders. In the CLI, recall prompts for each value. In the app, the variable is highlighted inline.

kubectl config use-context {cluster}
./deploy.sh --env {environment} --version {version}

Semantic Search

The Semantic Search tab runs a full AI-powered search using the same model as the CLI.

Finds commands by intent even if the wording differs
Score shown as percentage (cosine similarity × 100)
Same RECALL_MIN_SCORE threshold applies

Shell History Import

Click From Shell History in the header to scan ~/.zsh_history and ~/.bash_history.

Top 50 most-used commands are shown, sorted by frequency
Trivial single-token commands (ls, cd, etc.) are pre-filtered
Select any subset and click Import — duplicates are skipped

Import / Export (JSON)

Export dumps all commands to recall-commands.json.

Import JSON merges a JSON file into the library — existing commands (matched by exact command string) are skipped.

JSON format:

[
  {
    "description": "Pretty git log",
    "command": "git log --oneline --graph --decorate",
    "aliases": "git log graph"
  }
]

Global Hotkey

⌘⇧R (anywhere on macOS) brings the recall window to the front.

Duplicate Detection

When adding or editing a command, if the new command is semantically similar (>90% cosine similarity) to an existing one, a warning is shown. You can dismiss and save anyway.

If ~/.local/bin is not in your PATH, recall shows a setup banner with the shell command to add it. Dismiss permanently with ✕.

recall — docs