Your shell, with a second brain
Ask your terminal.
Keep your flow.
ash brings AI into bash, Fish, and zsh so questions, investigations, and small automations happen where the work already is.
macOS · Linux · FreeBSD · Open source
$ uptime
11:17 up 5 days, 3:13, 2 users, load averages: 1.94 3.05 3.05
$ summarize this project
ASH is a shell-integrated AI assistant.
It can inspect files, run allowlisted tools, schedule tasks, author and execute python, and keep session-scoped notes for sub-agent execution.
$ list the biggest files here
1.2M ./README.md
842K ./ash_test.go
312K ./docs/ash.1
█
No context switching. Prompt from the command line you already use.
Give AI a deliberate allowlist of commands it can use to explore.
Use locally hosted models, or a cloud provider, while keeping execution under your control.
A calmer way to use AI
The terminal stays
the center of gravity.
Install the shell integration
ash works with bash, Fish, and zsh. Unknown commands become prompts without changing your normal command habits. Snooze when you need a break from automatic prompt processing.
Easy updates
ash update keeps your installation up to date with the latest release. The command handles version checks, downloads, and verification automatically. No background or surprise updates.
Stay in control
Tool execution is constrained by an explicit allowlist and runs as your user. You decide what ash is allowed to touch. Add your own python scripts to the ~/.ash/tools directory.
Start small
Give your shell
some company.
Linux, macOS, and FreeBSD users can install the latest release in one step. The installer verifies the download, installs to ~/.local/bin, and configures detected Fish, zsh, or bash integration, falling back to bash.
ash install auto-configures your AI provider: it detects an already-set cloud provider API key or a running local inference server, otherwise it shows a numbered menu to pick a provider and model. Or set these yourself:
export AI_AUTH_TOKEN='84…89'
export AI_ENDPOINT='https://ollama.com'
export AI_MODEL='gemma4:31b-cloud'
Local, OpenAI, Anthropic, Google, Azure OpenAI, Mistral, Cohere, Groq, xAI, DeepSeek, Together AI, OpenRouter, HuggingFace, and any other provider with an OpenAI compatible API are supported.
curl -fsSL https://jonconradt.github.io/ash/install.sh | shOpen by design
Useful in the moment.
Understandable afterward.
Read the source, inspect the architecture, or see exactly what gets installed.