CLI reference¶

commando — context-aware command launcher

Usage:
  commando [command]

Commands:
  (no args)          Open the interactive search TUI
  search [--print]   Open the TUI; --print writes the chosen command to stdout
  init <shell>       Print integration for zsh, bash, or fish
  run                Alias for search
  add                Interactively add a cheat entry
  history [query]    Search your shell history (read live from the history file)
  doctor             Diagnose config, state, history, providers, and shell setup
  state clear ...    Clear remembered arguments or usage ranking
  promote [flags]    Promote a command or history entry into a managed cheat
  bookmark ...       Manage bookmarks: add/list/remove (also: bm)
  version            Print the version
  help               Show this help

Run with no arguments to open the search TUI. commando --help prints the usage above.

commando / commando search¶

Open the interactive search TUI. Running commando with no arguments is identical to commando search.

commando
commando search [--print] [--exec]

Behavior: you search, optionally fill in a form, and Commando emits the assembled command. By default it prints to stdout (the zsh widget puts it on your prompt). With --exec it runs the command via your shell.

In the list, type to fuzzy-filter (each term matches independently across an entry's title, description, command, and tags) and lead the query with a :c/:p/:h/:b prefix — or press Tab — to scope to cheats, project commands, history, or bookmarks. See The TUI for the full key reference.

Exit codes:

commando init¶

Print shell integration to stdout for Zsh, Bash, or Fish.

commando init zsh
commando init bash
commando init fish

Add the matching command to your shell config:

eval "$(commando init zsh)"    # ~/.zshrc
eval "$(commando init bash)"   # ~/.bashrc
commando init fish | source    # ~/.config/fish/config.fish

The emitted snippet defines the summon widget and binds it to your configured key_binding (default Ctrl+G). See Installation & setup.

commando run¶

An alias for commando search. Accepts the same flags.

commando run [--print] [--exec]

commando add¶

Interactively author a cheat entry. Commando prompts for a title, optional description, template, and tags, then parses the template to discover each variable and prompts for its options. The validated entry is appended to ~/.config/commando/cheats/user.toml.

commando add

Prompts, in order:

1. Title — required; shown in the result list.
2. Description — optional; shown for the selected command.
3. Command template — required; use <var> and [optional <var>].
4. Tags — comma-separated, optional.
5. For each discovered variable: src, default, multi-select (y/N), and remember scope (none/global/project/dir, default none).

See Cheat sheets.

commando history¶

Search your shell history, read live from the history file. Commando never stores a copy.

commando history [query...] [--limit N]

• The query is one or more words, matched case-insensitively as a substring.
• Results print newest-first.
• Flags may appear before or after the query — both commando history --limit 3 docker and commando history docker --limit 3 work.

commando history docker
commando history --limit 100 kubectl rollout

See Shell history.

commando doctor¶

Inspect the active paths, config and cheat files, state store, shell history, project providers, shell support, and binary discovery.

commando doctor

Each line is marked ok, warn, or error and includes the path or an actionable detail. Warnings describe reduced functionality and still exit 0; an error exits 1.

commando state clear¶

Reset Commando's learned state without deleting configuration or bookmarks.

commando state clear memory
commando state clear usage
commando state clear all

memory forgets parameter values, usage resets command and candidate frecency, and all clears both.

commando promote¶

Append a literal command or parameterized template to ~/.config/commando/cheats/user.toml.

commando promote [--title "..."] [--desc "..."] [--tags "a,b"] <template>
commando promote --title "Pod logs" --tags "k8s,logs" \
  'kubectl logs <pod> [-n <namespace>]'

Discovered variables are written with remember = "none" so promoting an existing command cannot start persisting parameter values unexpectedly. Edit the generated cheat when a variable is safe to remember.

commando bookmark¶

Manage saved commands. Also available as commando bm. With no subcommand, it lists bookmarks.

commando bookmark add  [--tags "a,b"] [--note "..."] <command>
commando bookmark list                     # alias: ls
commando bookmark remove <command>         # alias: rm

bookmark add¶

The command is everything after the flags.

bookmark list / ls¶

Prints each bookmark as command [tags] — note.

bookmark remove / rm¶

Removes the bookmark whose command exactly matches the argument. In the TUI, highlight a bookmark and press Ctrl+D for the same operation.

See Bookmarks.

commando version¶

Print the version and exit.

$ commando version
commando 0.1.0

Also available as commando --version and commando -v.

commando help¶

Print the usage summary. Also commando --help and commando -h.