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

bash — session 04

$ 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

01Ask in place

No context switching. Prompt from the command line you already use.

02Investigate together

Give AI a deliberate allowlist of commands it can use to explore.

03Local control

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.

01

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.

02

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.

03

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.