ao

ao = agent orchestrator

• ao up watches a simple todo.txt file for new tasks and spawns claude agents in tmux sessions
• ao add <task> adds a new task
• default instructions can be prepended to all tasks using ao.txt

Important

Requires Bun >= 1.3, tmux and the Claude Code CLI on PATH

Build

Build bin into ~/.bun/bin/ao (in PATH already if Bun is installed):

bun run build

Usage

Start watcher:

ao up

Add agent tasks (appends to todo.txt in the cwd):

ao add say hello

Each new task spawns a tmux pane (or detached session if not already running tmux) running a Claude Code agent.

Optionally, place an ao.txt in the cwd to prepend shared context to every task's prompt. The file is read fresh on each spawn, so edits apply to the next task without restarting ao up.