aish

Description

Do you always forget how to run complex bash commands like:

ps aux --sort=-%mem | head -n 10

Now you can just run:

aish "top 10 processes by memory"

Aish is a smart command-line assistant that generates exact bash commands from plain text descriptions. Just type what you want to do, and it gives you the command-ready to execute. Perfect for sysadmins, developers, or anyone who wants to save time in the terminal.

How it works

• The user provides a textual description of the task.
• The tool sends a request to the Ollama API with a prompt that enforces returning only a command.
• The model responds with a bash command.
• The tool displays the command and asks if it should be executed. The default option is (Y). Pressing Enter executes the command.
• The command is executed in a shell.

Aish does not add sudo automatically. If a command requires elevated privileges, the user is expected to rerun it using sudo.

Installation

Install the latest version using:

go install github.com/cyradin/aish/cmd/aish@latest

Make sure $GOPATH/bin or $HOME/go/bin is in your PATH.

Environment Variables

Aish uses the following environment variables:

Variable	Description	Default / Required
AISH_MODEL	The Ollama model name to use	Required
AISH_HTTP_REQUEST_TIMEOUT	HTTP request timeout for the Ollama API	120s
AISH_OLLAMA_URL	Base URL of the Ollama API	Required

You can set them in your shell configuration (e.g., .bashrc or .zshrc):

export AISH_MODEL="qwen2.5-coder:7b"
export AISH_OLLAMA_URL="http://localhost:11434"
export AISH_HTTP_REQUEST_TIMEOUT="120s"

Usage

Run Aish with a text description:

aish "list top 5 processes by cpu usage"

Example output:

Suggested command:
ps aux --sort=-%cpu | head -n 6

Execute? (Y)/n:

Press Enter or Y to execute the command, or N to abort.