// reference

Command reference

Save, list, run, and import history work offline with no account. Local groups / templates / snippets / env / aliases live under ~/.recall/ (manage in VS Code or edit JSON; CLI collection commands still need login). Sync, Ask, playbooks, and cloud collections need Pro. Ask only prints suggestions — it never runs them. Try: save and run locally, Ask demos, git, React, Next.js, Docker.

Commands

recall save "<cmd>"

Save locally (--name --tags). No account needed

recall save --last

Save last shell history line (zsh/bash/PowerShell; not cmd)

recall import history

Import from shell history (--dry-run -n -y)

recall import <file>

Import from JSON or .sh

recall list

List saved commands (--tag --search --pinned)

recall run <name>

Run a saved command (--confirm --dry-run)

recall delete <name>

Delete a saved command (--force)

recall search <query>

Fuzzy search saved commands

recall pin <name>

Pin a command to the top of the list

recall update <name>

Update name, tags, or content

Sync (Pro / Team)

recall auth login

Log in for sync and Ask

recall sync

Pull cloud → local, then push new local commands (Pro)

recall sync --pull

Cloud → local only

recall sync --push

Local-only → cloud only

recall sync --status

Show sync status

Ask (Pro / Team)

recall

Open an Ask session. Prints only. /save [name] asks for tags. /exit

recall "find the 10 biggest files"

Suggest a command from English. Prints only — does not run it

recall ask <query>

Same as a quoted question

rec "…"

Short alias for recall (install scripts create rec)

Authentication

recall auth register

Create a new account

recall auth login

Login with credentials or browser

recall auth logout

Logout and clear token

recall auth forgot <email>

Request a password reset token

recall auth reset <token>

Reset your password with a token

Templates

recall template save <name> "<tmpl>"

Save a template (CLI needs login; Free local via VS Code / templates.json)

recall template list

List all templates

recall template run <name>

Run template — prompts for each variable

recall template show <name>

Show template details

recall template delete <name>

Delete a template

Playbooks (Pro / Team)

recall playbook save deploy "docker compose up -d" "pnpm migrate"

Save an ordered workflow

recall playbook list

List playbooks

recall playbook show <name>

Show steps

recall playbook run <name>

Run steps in order (executes). --dry-run prints only

recall playbook delete <name>

Delete a playbook

Snippets

recall snippet save <name>

Save a multi-line script (CLI needs login; Free local via VS Code / snippets.json)

recall snippet list

List all snippets

recall snippet show <name>

Show snippet content

recall snippet run <name>

Run a snippet

recall snippet delete <name>

Delete a snippet

Environment variables

recall env save <name>

Save an env set (CLI needs login; Free local via VS Code / env.json)

recall env list

List all env sets

recall env show <name>

Show variables in an env set

recall env use <name>

Print export commands for shell loading

recall env delete <name>

Delete an env set

Groups

recall group create <name>

Create a group (CLI needs login; Free local via VS Code / groups.json)

recall group list

List all groups

recall group show <name>

List commands in a group

recall group add <cmd> <group>

Add a command to a group

recall group remove <cmd>

Remove a command from its group

recall group delete <name>

Delete a group (commands kept)

recall group rename <old> <new>

Rename a group

Org vault (Team)

recall org create <name>

Create an organization

recall org members

List org members

recall org invite <email>

Invite a member

recall org join <token>

Join via invite token

recall org save "<cmd>"

Save to org vault

recall org commands

List org vault commands

recall org run <name>

Run an org command

recall audit

Show org audit log

recall approve request <name>

Request approval to run

recall approve grant <token>

Approve a pending request

Utilities

recall alias set <a> <name>

Create a short alias (CLI needs login; Free local via VS Code / aliases.json)

recall alias list

List all aliases

recall history

Show run history

recall share create <name>

Create a public share link (Pro)

recall export

Export as JSON or shell script

recall whoami

Show account and plan info

recall doctor

Health check and diagnostics

recall upgrade

View plans / open upgrade

recall completion <shell>

Generate shell completion script

recall feedback

Send feedback or report a bug

recall support ticket

Submit a support ticket