AO: Agent Orchestrator

Documentation

tmux runtime

The built-in Terminal UI runtime on macOS and Linux.

AO uses tmux on macOS and Linux to keep each Terminal UI agent process attachable and to feed the desktop terminal mux. Runtime selection is automatic.

The macOS and Linux desktop packages include their own pinned tmux and use an AO-owned socket. Desktop users do not need to install tmux, and AO never shares the machine tmux server.

Standalone daemon and development

Standalone daemon and source development runs still resolve tmux from PATH:

# macOS
brew install tmux

# Debian / Ubuntu
sudo apt install tmux

Then run ao doctor. It reports whether that AO process selected an explicitly configured, packaged, or system tmux. There is no runtime: tmux YAML setting.

Desktop terminal

The desktop xterm surface connects through AO's WebSocket terminal mux. On macOS/Linux the daemon opens a PTY-backed tmux attach stream for that client. Closing the desktop terminal view does not discard the underlying agent session.

On Windows AO automatically uses its ConPTY runtime instead. There is no selectable process fallback.