Natural language to shell command translator. Type what you want in plain English, get back an editable shell command.

$ @ find all python files modified in the last week
  # Find Python files modified in the last 7 days
❯ find . -name '*.py' -mtime -7

The translated command is placed in an editable prompt — you review, edit, or cancel before anything runs.

• Two interaction modes: Submit (editable prompt) and Inline (replaces shell buffer in-place with undo support)
• Shell-aware: Detects your shell (bash, zsh, fish, PowerShell) and OS, generates correct syntax
• Multiple LLM backends: Claude CLI, Ollama (local), or any OpenAI-compatible API
• Configurable: TOML config file, environment variables, CLI flags, or interactive TUI
• Safe by design: Commands are never auto-executed

• Python 3.12+
• uv (package manager)
• jq (used by shell integration scripts)
• An LLM backend (see Backends)

uv tool install at-cmd

Then run setup to add shell integration:

at-cmd setup

This auto-detects your shell, shows you what it will add, and appends the integration line to your shell config (e.g. ~/.zshrc, ~/.bashrc, ~/.config/fish/config.fish). Use -y to skip the confirmation prompt.

Restart your shell or source your config file to activate.

Type @ <request> and press Enter. You get a description and an editable prompt with the translated command:

$ @ list docker containers sorted by size
  # List Docker containers sorted by size
❯ docker ps -as --format "table {{.Names}}\t{{.Size}}" | sort -k2 -h

• Enter — execute the command
• Edit — modify before executing
• Ctrl+C / Escape — cancel

Type @ <request> and press the hotkey (default: Alt+G). The shell buffer is replaced with the translated command, ready to edit or run:

$ @ find large jpg files        ← you type this
  [Alt+G]
$ find . -name '*.jpg' -size +5M   ← buffer replaced, editable

• Enter — execute
• Ctrl+Z — undo back to original @ <request> text
• Press the hotkey again to regenerate

at-cmd --json "find large files"
# {"command": "find . -size +100M", "description": "Find files larger than 100MB"}

at-cmd <request>                    # translate (default)
at-cmd --json <request>             # JSON output
at-cmd --shell bash <request>       # override shell detection
at-cmd --backend ollama <request>   # override backend
at-cmd --model gpt-4o <request>     # override model
at-cmd setup                        # set up shell integration
at-cmd config                       # open interactive config TUI

Configuration is resolved in layers (later overrides earlier):

1. Defaults — sensible out-of-the-box values
2. Config file — ~/.config/at-cmd/config.toml
3. Environment variables — AT_CMD_* prefix
4. CLI flags — --backend, --model, --shell

backend = "claude"
model = "sonnet"
api_url = ""
api_key = ""
timeout = 10
default_mode = "inline"
hotkey = "alt+g"
undo_key = "ctrl+z"

Run at-cmd config to open a terminal UI for editing settings:

at-cmd config

just install    # install dependencies
just tool       # install as uv tool (available globally)
just dev        # editable install (for development)
just test       # run tests
just testv      # run tests (verbose)
just lint       # ruff check
just format     # ruff format
just check      # lint + format

MIT