CLI reference

Every SESSION argument accepts a unique name, short ID, or full ID. Prefer names because they are easier for humans and use fewer agent tokens.

Start and discover

saaht shell NAME
saaht cshell NAME
saaht start --name NAME -- COMMAND [ARGS...]
saaht start --follow --name NAME -- COMMAND [ARGS...]
saaht list
saaht ls
saaht show SESSION

shell starts a reusable zsh session. cshell starts the same session and connects to it immediately. start creates a session for a specific command. --follow also streams its output in the current terminal until the command exits. ls is an alias for list.

Read output

saaht tail SESSION
saaht tail SESSION -n 25
saaht tail SESSION --before CURSOR
saaht follow SESSION
saaht read SESSION

Use tail first. It returns recent lines and, when older output exists, prints the exact command for the previous page. Use follow to stream future output. read prints the complete retained transcript and can be large.

Filter locally when you know what you need:

saaht read SESSION | rg -i -C 3 "error|warning|failed"

Send commands

saaht -i SESSION "bun run dev"
saaht input SESSION "bun run dev"
saaht input SESSION --raw "text without Enter"

-i and normal input append Enter. --raw sends the exact text unchanged.

Join interactively

saaht connect SESSION
saaht attach SESSION

attach is an alias for connect. Your terminal behaves normally, including Ctrl-C, shell history, prompts, colors, and full-screen terminal applications.

To disconnect without stopping the session, press Enter, then type ~..

Control lifecycle

saaht interrupt SESSION
saaht stop SESSION
saaht restart SESSION
saaht delete SESSION
saaht resize SESSION COLUMNS ROWS

• interrupt sends Ctrl-C.
• stop stops the running terminal.
• restart reruns an exited session's original command.
• delete permanently removes a session and its retained output.
• resize changes the managed terminal dimensions.

MCP agent access

saaht access SESSION none
saaht access SESSION observe
saaht access SESSION control

These permissions apply only to agents connected through SAAHT's optional MCP server. none hides the session, observe allows reading, and control also permits terminal input and lifecycle commands.

They do not restrict direct CLI commands such as saaht read or saaht input.

Desktop app

saaht open

Opens the installed SAAHT desktop application.

Daemon health

saaht doctor
saaht daemon status
saaht daemon start
saaht daemon install

doctor checks tmux and the daemon connection. daemon install explains how to install the per-user launchd service.