Your shell, with a second brain
Ask your terminal.
Keep your flow.
ash brings AI into bash, and zsh so questions, investigations, and small automations happen where the work already is.
macOS · Linux · 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, 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 and macOS users can install the latest release in one step. The installer verifies the download, installs to ~/.local/bin, and configures the detected zsh or bash integration, fallback to bash.
Set the following environment variables after running the installer. The website now has a one-line installer, but you still have to set:
export AI_AUTH_TOKEN='84…89'
export AI_ENDPOINT='https://ollama.com'
export AI_MODEL='gemma4:31b-cloud'
Local, OpenAI, Google, Anthropic, and any other provider with an OpenAI compatible API are supported.
curl -fsSL https://jonconradt.github.io/ash/install.sh | sh
Open by design
Useful in the moment.
Understandable afterward.
Read the source, inspect the architecture, or see exactly what gets installed.