gencmd is an interactive command line utility to generate bash commands from a natural language description, directly from the console.

Ever went to ChatGPT after struggling some time with man awk, or with questions like "was it curl or wget with -O"? Well, save some time and ask directly from the terminal. Think of this as the fzf for natural language to bash commands.

There are many alternative tools for this task, but none did all I wanted:

• Simple to install and configure (i.e. single binary, no dependencies).
• Work interactively in the terminal, but require minimal typing.
• Fast.
• Do not run commands for me, but suggest alternatives.
• Paste the result directly in the terminal (without me having to do it).
• Have built-in history for both commands and prompts.
• Open source, no sign-up required, no strings attached.

This project is minimal but provides all of the above.

Head over to the latest release, and download a binary appropriate for your system.

Make it executable and put it somewhere in $PATH:

chmod a+x gencmd
sudo mv gencmd /usr/local/bin

If you want to set up key bindings (default is Ctrl + G), add this to your .bashrc:

source ~/.config/gencmd/key-bindings.bash

or use key-bindings.zsh for .zshrc.

Initialize with:

gencmd init

The instructions will guide you through setting up an AI model provider. The currently supported providers are OpenAI, Gemini, Anthropic, and Ollama.

The easiest to get started is to get a free API key from Google AI Studio. Follow the instructions there and once you have the key, paste it into the interactive prompt.

For local models, you can use Ollama. First install Ollama and pull a model (e.g., ollama pull gemma-3), then configure gencmd to use it.

Credentials are stored locally, and NEVER sent anywhere else.

Think of this as fzf for natural language to bash commands. Open a new terminal and press Ctrl + G. As you type your query, gencmd will filter your recent history, so you can either select something from there, or submit a new prompt.

In case the prompt is new, your configured LLM will be invoked to generate a few alternative commands to solve your intended usage.

You can navigate history and completions with keyboard arrows ↑ ↓, or Ctrl + J and Ctrl + K.

The result is not executed, but pasted into your command line, so that you can edit it.

Examples for inspiration:

• Find all subdirectories
• Count the lines of a file that don't start with #
• Delete a remote git tag

This project is written in Go:

git clone https://github.com/mbrt/gencmd
cd gencmd
go build .