Natural Language to Shell Command

Translate natural language requests into executable CLI commands using AI.

Installation

git clone https://github.com/Bandit-HaxUnit/clixaw
cd clixaw
pip install -e .

Configuration (Optional)

You can configure the API settings by creating a config file at ~/.config/clixaw/config.toml:

[api]

# Optional: Custom API URL (defaults to https://cmd.xaw.me)
url = "https://cmd.xaw.me"

[provider]

# Optional: Provider name (e.g., "openai", "gemini")
# If not specified, uses default (Groq) - no headers needed
name = "gemini"

# Optional: API key (required if provider is set)
api_key = "xxx"

# Optional: Model override (e.g., "gemini-flash-lite-latest", "gpt-5-mini")
model = "gemini-flash-lite-latest"

Basic Usage

Translate a natural language query to a shell command:

Terminal

xaw show me big files

# Output: du -ah . | sort -rh | head -n 10