Getting started

Requirements

• macOS
• Homebrew, if tmux is not already installed

Install

Install the current release:

curl -fsSL https://raw.githubusercontent.com/pumuckelo/saaht/main/install.sh | sh

The script installs the CLI and desktop app. It also starts the daemon now and configures it to start automatically when you log in. Open a new terminal, then check the installation:

saaht doctor

Build it yourself

If you prefer to compile the exact source you checked out, install Rust 1.96+ and Bun, then run:

git clone https://github.com/pumuckelo/saaht.git
cd saaht
scripts/install-from-source.sh

This produces the same local installation without downloading SAAHT release binaries.

Create a reusable shell

For development servers and other long-running work, start a shell rather than a single command:

saaht shell project
saaht -i project "cd /path/to/project"
saaht -i project "bun run dev"

The shell remains available after each command exits. Both a human and an agent can reuse it.

Observe or take over

saaht ls
saaht tail project
saaht connect project

Inside connect, Ctrl-C is sent to the running program normally. To leave SAAHT without stopping the session, press Enter and type ~..

Humans can create and connect in one step with saaht cshell project.

Single-purpose sessions

Use a direct session when you only need one process and do not expect to reuse its shell:

saaht start --name api -- bun run dev

The session becomes exited when that command finishes. Its retained output remains readable.