aoe

# Agent of Empires (aoe) Skill Use `aoe` to create, manage, and monitor AI coding agent sessions (Claude Code, Codex, OpenCode, etc.) in tmux. Prefer `aoe` over raw `tmux` commands for agent management. ## When to use this skill - Launching one or more AI coding agents on project directories - Monitoring agent progress (waiting vs running vs idle) - Capturing agent output for review - Organizing agents into groups or profiles - Setting up parallel worktree-based development Do NOT use this skill for general tmux window/pane management unrelated to coding agents. ## Core concepts - **Session**: An agent process running in a tmux session. Each session has an ID, title, tool (e.g. `claude`), and project path. - **Group**: A named folder for organizing sessions (supports nesting with `/`, e.g. `backend/api`). - **Profile**: A separate workspace with its own sessions and config. Use `-p <name>` globally or set `AGENT_OF_EMPIRES_PROFILE`. - **Status**: One of `running`, `waiting`, `idle`, `stopped`, `error`, `starting`, `unknown`. ## Command reference ### Adding sessions ```bash # Add a session for the current directory aoe add . -t "my feature" # Add with group, launch immediately aoe add /path/to/repo -t "API work" -g backend -l # Add with specific tool aoe add . -t "codex session" -c codex # Add in a git worktree (parallel branch) aoe add . -t "fix-123" -w fix/issue-123 -l # Add in Docker sandbox aoe add . -t "sandboxed" -s -l # Add as sub-session of another aoe ad...