Agent of Empires
A command-line tool for unified management of 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 command-line tool for unified management of AI coding agent sessions Full Skill content: https://321skill.com/skills/agent-of-empires-x-2/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 pain points of manual switching and monitoring when developers need to manage multiple AI coding agent sessions simultaneously. In real-world development, it's common to run tools like Claude Code, Codex, and OpenCode in parallel across multiple project directories. Manually creating tmux windows, switching between them, and checking their status is cumbersome and prone to losing session information and context.
Usage is straightforward via the aoe command-line tool. For example, to add a session in the current directory: aoe add . -t "my feature"; to specify a tool and group: aoe add /path/to/repo -t "API work" -g backend -l. Afterwards, you can view all sessions with aoe list, check a status summary with aoe status, attach to a session with aoe session attach, and capture output for monitoring with aoe session capture. All commands support JSON output for easy integration into automation scripts and monitoring dashboards.
It is well-suited for teams or individuals who need to run multiple AI coding agents in parallel, especially developers working on multiple features, code reviews, or experimental explorations simultaneously. For AI-assisted development workflows using tools like Claude Code, Codex, or OpenCode, aoe can significantly improve management efficiency. It's also ideal for agent developers and operations engineers who need to switch between multiple projects.
We recommend using aoe consistently to manage all AI coding agent sessions during project development, avoiding direct use of raw tmux commands. Note that aoe depends on tmux and the aoe binary, and only supports Unix-like systems (Linux/macOS); Windows users may require a WSL environment. Additionally, installing aoe requires compiling via Go or downloading a pre-compiled binary. Please refer to the installation guide in the official GitHub repository.
Key Features
Unlike managing agent sessions directly with tmux, `aoe` provides session-level metadata (such as tool type, group, status, creation time, etc.), supports organization by group and configuration files, and can automatically detect the current tmux session context, making command input more concise. Furthermore, `aoe`'s JSON output facilitates integration into automation scripts and monitoring dashboards.
Limitations
`aoe` requires the `aoe` binary and tmux (version ≥2.8) to be installed on the system. It is primarily designed for Unix-like systems; Windows users need to use it via WSL. `aoe` itself does not provide AI coding capabilities; it functions solely as a session management tool.
FAQ
Which AI coding agent tools does aoe support?
It supports Claude Code, Codex, OpenCode, and others. The tool type can be specified via the `-c` parameter, e.g., `-c codex`.
How can I view the real-time output of a specific session?
Use the `aoe session capture <id>` command to capture the content of the current tmux pane. Add the `--json` parameter to obtain structured data, including status, line count, text content, etc.
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-2/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-2/raw/index.md