A no-bullshit, seamless way to use LLMs right inside your shell (bash, zsh). Supports OpenAI, Ollama and OpenRouter
Ever felt that most AI tools sound nice but are completely impractical or simply useless? Then try Ash, because you don’t need another bloated wrapper or half-baked CLI tool.
- Command-not-found Fallback: Unrecognized commands become AI queries
~ ❯ hey chat how are you
I'm a program — ready to help. What would you like to do?
~ ❯ ls
Desktop/ Documents/ Downloads/ Music/ Pictures/ Videos/- Shell Integration: Respects redirections, pipes, and standard shell behavior
git log --oneline -10 | summarize recent changes
grep "ERROR" app.log | categorize these errors > error_types.txtNote: This feature currently doesnt work in fish because of restrictions in the command not found handler
- Easily extensible: Simply implement a new provider to use your llm of choice
Clone the repository and build the project. Execute the binary and follow on screen instructions for further information. The installer will move the binary into /usr/local/bin and append some lines into your shell config
After installation edit the config file found under ~/.config/ash/config.json to change your provider, choose your model and add your API key
{
"provider": "enter-your-provider",
"api_key": "enter-your-api-key",
"model": "enter-your-model"
}Other important files:
- Chat history:
~/.ash_history.json
"argsd": "1.2.0"
"requests": "2.2.0"