yaak 0.0.3

Translate natural language to bash commands using an OpenAI-compatible LLM
yaak-0.0.3 is not a library.

yaak

Translate natural language into bash commands using any OpenAI-compatible LLM.

$ yaak list all rust files larger than 1MB
  Command: find . -name "*.rs" -size +1M -ls
Execute? [Y/n] y

Install

cargo install --path .

Configuration

yaak resolves settings in this priority order: CLI flags → environment variables → config file → defaults.

Config file

Copy the example and edit it:

mkdir -p ~/.config/yaak
cp config.example.toml ~/.config/yaak/config.toml

Environment variables

export YAAK_API_BASE="https://api.openai.com/v1"
export YAAK_API_KEY="sk-..."
export YAAK_MODEL="gpt-4o-mini"

Usage

yaak <description of what you want to do>

Options

Flag Short Description
--api-base URL -u API base URL
--api-key KEY -k API key
--model NAME -m Model name
--yes -y Skip confirmation prompt

Examples

# Basic usage
yaak find all PDFs modified in the last week

# Use a local Ollama model
yaak -u http://localhost:11434/v1 -m llama3 show disk usage by directory

# Pipe-friendly (skip confirmation)
yaak -y count lines of code in src/

Compatible providers

Any service exposing an /v1/chat/completions endpoint works:

  • OpenAI — https://api.openai.com/v1
  • Ollama — http://localhost:11434/v1 (no key needed, use -k none)
  • Together AI — https://api.together.xyz/v1
  • OpenRouter — https://openrouter.ai/api/v1
  • Groq — https://api.groq.com/openai/v1
  • vLLM / LocalAI / LM Studio — your local URL