⌘OK

commandOK

commandOK is a Spotlight-like command generator for your terminal. Pops up when you need it and gets out of the way when you don't.

Built with Ratatui and powered by your choice of public, private or local LLM provider.

WARN: you must always verify the generated command before accepting it

Install

brew install 64bit/tap/commandok

OR

cargo install commandok

Setup

On first run, a default config is created at ~/.commandok/config.toml. Add your API key for at least one provider:

[commandok]
# Options: anthropic, openai, google, mistral, ollama,
#          openrouter, xai, vercel_ai_gateway, litert_lm
provider = "anthropic"
system_prompt = """\
You are a terminal command generator. Given a natural language description, output ONLY \
the shell command appropriate for the user's OS and shell. No explanation, no markdown, no code blocks, \
no backticks. Just the raw command.\
"""

[anthropic]
api_key = ""
model = "claude-opus-4-6"

[openai]
api_key = ""
model = "gpt-5.4"

[google]
api_key = ""
model = "gemini-3-flash-preview"

[mistral]
api_key = ""
model = "mistral-small-latest"
# api_url = "https://api.mistral.ai/v1"  # default

[ollama]
model = "gemma3:1b"
# api_url = "http://localhost:11434"  # default, change if running elsewhere

[openrouter]
api_key = ""
model = "qwen/qwen3.6-plus:free"
# api_url = "https://openrouter.ai/api/v1"  # default

[xai]
api_key = ""
model = "grok-4.20-0309-reasoning"
# api_url = "https://api.x.ai/v1"  # default

[vercel_ai_gateway]
api_key = ""
model = "google/gemini-3-flash"
# api_url = "https://ai-gateway.vercel.sh/v1"  # default

[litert_lm]
model = "gemma-4-E2B-it.litertlm"
huggingface_repo = "litert-community/gemma-4-E2B-it-litert-lm"

Usage

Run commandok in any terminal. A search bar appears inline below your cursor.

1. Type a natural language description of the command you need
2. Press Enter -- the command streams in token-by-token
3. Press Enter again to accept (injects the command into your shell) or Esc to cancel

Keybindings

| Key | Action | |-----|--------| | Enter | Submit prompt / Accept generated command | | Esc | Cancel and dismiss | | Shift+Tab | Cycle through configured providers | | Up / Down | Browse prompt history | | Ctrl+U | Clear input line | | Ctrl+C | Quit | | Left / Right / Home / End | Move cursor |

Adding a new provider

1. Create src/provider/yourprovider.rs with a pub async fn stream(...) function
2. Add pub mod yourprovider; to src/provider/mod.rs
3. Add a variant to the Provider enum and wire it in from_name() / stream()
4. Add the section to Config in src/config.rs and PROVIDER_ORDER

License

MIT