aoe

Topics in the source

• Peer communication
• Troubleshooting

aoe creates and drives agent sessions. Run aoe --help and aoe --help — flags change between releases; this file covers only what help text won't tell you. Distinguish tmux from structured ACP sessions. For tmux, aoe add --title creates the record and aoe session start starts the worker. For ACP, discover supported agents with aoe acp agents; aoe add --scratch --agent omp --title creates a structured OMP scratch worker served by aoe serve. Do not call session start on ACP sessions. aoe add --launch tries to attach interactively and fails without a TTY. Every session and subagent that may modify a repository needs a dedicated git worktree. Read-only inspection needs neither a new session nor a worktree. Use aoe add --worktree --new-branch (plus --base-branch when needed); for an existing session, aoe session add-project creates a worktree but restarts the agent. If attachment is refused because its conversation is bound to the current directory, use a new session; never clear the resume target or proceed without write isolation. is canonicalized, never resolved back to the main repo. Point aoe add at a worktree and it silently creates a bogus project rooted there. Pass the exact regi

This is an excerpt. Refer to the complete source and its current requirements.