Agent of Empires
Manage multiple AI coding agent sessions with aoe
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: Agent of Empires. It is used for: Manage multiple AI coding agent sessions with aoe Full Skill content: https://321skill.com/skills/agent-of-empires-x/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the issue of chaotic session management when running multiple AI coding agents (such as Claude Code, Codex, OpenCode) simultaneously. In practical development, developers often need to launch multiple agents to handle different tasks. Manually switching between tmux sessions, monitoring their status, and capturing outputs is cumbersome and prone to oversight or confusion.
Usage is straightforward: simply execute aoe add . -t "task name" -l in your project directory to launch and attach an agent session. You can then use aoe list to view the status of all sessions, aoe session capture <id> to retrieve output, and aoe session start/stop/restart to manage the lifecycle. All operations are performed via the command line, eliminating the need to interact directly with tmux.
It is well-suited for teams or individuals who need to manage multiple AI coding agents concurrently. This is especially useful for developers already using tmux as a terminal multiplexer but who desire enhanced capabilities for session grouping, status monitoring, and output capture. Project managers can also use it to uniformly track the progress of multiple parallel development tasks.
It is recommended to prioritize using this tool over direct tmux operations when managing multiple AI coding agent sessions in a unified manner. Note that it relies on the aoe and tmux binaries, which must be installed beforehand. It is primarily designed for terminal environments and is not suitable for pure GUI scenarios.
Key Features
Unlike managing sessions directly with tmux, aoe provides commands specifically tailored for AI coding agent session management (such as automatic detection of running/waiting/idle states, organization by group/configuration file, output capture, etc.). This eliminates the need for manual manipulation of tmux panes and windows, offering a more intuitive user experience.
Limitations
Requires pre-installation of both the aoe and tmux binaries. It depends on tmux as the underlying terminal multiplexer and cannot be used in purely non-interactive environments or systems without tmux.
FAQ
How can I view all running agent sessions?
Execute `aoe list` to view information for all sessions, including ID, title, tool, status, and group. Adding `--json` outputs the data in JSON format for programmatic processing.
How do I retrieve the current output of a specific agent session?
Execute `aoe session capture <session ID or title>` to capture the text content from that session's tmux pane. Adding `--json` outputs structured data.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/agent-of-empires-x/raw/index.md to read the original Skill definition (Markdown format) for Agent of Empires, and install it according to the instructions.
Raw Markdown URL for AI: /skills/agent-of-empires-x/raw/index.md