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-8/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 chaotic session management issue when running multiple AI coding agents (such as Claude Code, Codex, OpenCode) simultaneously. In real-world development, developers often need to frequently switch between multiple tmux windows, manually track agent states, and capture outputs, which is inefficient and prone to oversight. Agent of Empires (aoe) provides a unified command-line interface, allowing you to manage agent sessions like processes.
Usage is straightforward: simply execute aoe add . -t "task name" -l in the terminal to create and start an agent session in the current directory. You can then use aoe list to view the status of all sessions (running, waiting, idle, etc.), and use aoe session attach and aoe session capture for interactive attachment and output capture, respectively. It also supports advanced features like grouping, worktrees, Docker sandboxes, and sub-sessions—all operable through natural command-line arguments.
It is well-suited for teams or individuals who need to run multiple AI coding agents in parallel, especially in scenarios where tools like Claude Code and Codex are already used for multitask development—such as simultaneously handling multiple feature branches, parallel code reviews, or multi-project context switching. For operations engineers and agent developers, aoe's JSON output and status monitoring capabilities also facilitate integration into automated workflows.
It is recommended to uniformly use aoe instead of raw tmux commands for managing agent sessions in development workflows. Note that it is primarily designed for coding agent scenarios and is not suitable for general tmux window management. Before use, ensure tmux (version >= 3.3) is installed on the system and the aoe command is correctly configured in the PATH environment variable.
Key Features
Unlike managing sessions directly with tmux, aoe is specifically designed for AI coding agents. It automatically identifies session states (waiting/running/idle/error), provides structured JSON output for easy script integration, and supports advanced features like grouping, configuration files, and sub-sessions—eliminating the need to manually memorize window layouts and commands.
Limitations
Requires tmux (version >= 3.3) installed on the system and only supports Linux and macOS; Windows requires WSL. Depends on both the `aoe` and `tmux` binaries.
FAQ
How do I install aoe?
Run `npm install -g @agent-of-empires/agent-of-empires`, then ensure tmux is installed on your system.
How do I view the status of all sessions?
Run `aoe list` for a human-readable list, or `aoe list --json` for 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-8/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-8/raw/index.md