Agent of Empires
A Powerful Tool for Managing AI Coding Agent Sessions
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: A Powerful Tool for Managing AI Coding Agent Sessions Full Skill content: https://321skill.com/skills/agent-of-empires/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 difficulty of uniformly managing, monitoring, and switching between multiple AI coding agents running simultaneously. In real-world development, developers often need to launch multiple Claude Code, Codex, or OpenCode sessions in different project directories. Manually managing tmux windows is both cumbersome and prone to overlooking session states.
Usage is straightforward: simply install aoe and tmux, then run aoe add . -t "Task Name" -l to launch an agent session in the current directory. You can then manage all sessions using natural language commands, such as aoe list to view all agent statuses, aoe session capture <id> to capture output, and aoe session attach <id> to interactively attach to a session.
It is particularly well-suited for teams or individuals who need to handle multiple coding tasks in parallel. Especially for developers already using AI coding agents like Claude Code for complex project refactoring, multi-module development, or parallel experiments, it can significantly enhance control over the agent cluster.
It is recommended to adopt this tool uniformly for managing all AI coding agents during team collaboration to track each agent's work progress and output. Note that it is primarily designed for terminal environments, requiring developers to be comfortable with command-line operations, and it relies on tmux as the session container.
Key Features
Unlike managing agents directly with tmux, aoe is specifically designed for AI coding agent scenarios. It provides features like grouping, status monitoring (running/waiting/idle), one-click launching, and output capture. In contrast, tmux only offers basic window management and lacks awareness of the agent lifecycle.
Limitations
Requires tmux and the aoe binary to be installed on the system. Currently, it only supports Unix/Linux-like environments. Windows users need to run it via WSL, and it depends on tmux's session isolation mechanism.
FAQ
Which AI coding agents does aoe support?
It supports mainstream tools like Claude Code, Codex, and OpenCode. Use the `-c` parameter to specify the tool name, e.g., `aoe add . -c codex`.
How can I view the real-time status of all agents?
Run `aoe status --json` to get a JSON summary of all agent statuses, including counts for running, waiting, idle, etc. The `-q` parameter is also supported to output only the waiting count for script integration.
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/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/raw/index.md