Agent of Empires
A tmux 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 tmux tool for managing AI coding agent sessions Full Skill content: https://321skill.com/skills/agent-of-empires-x-11/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 chaos of managing multiple AI coding agent sessions (such as Claude Code, Codex, OpenCode) simultaneously. Developers often need to launch multiple agents across different project directories, manually switch tmux windows, monitor statuses, and capture outputs—a cumbersome and error-prone process. Agent of Empires (aoe) provides a unified command set, allowing developers to manage agent sessions like processes, including features for grouping, status queries, and output capture.
Usage is straightforward: simply install aoe and tmux in your terminal, then use the command aoe add . -t "task name" -l to create and start an agent session in the current directory. You can then view the status (running, waiting, idle, etc.) of all sessions via aoe list, capture real-time output from a session with aoe session capture, and attach to a specific session for interaction with aoe session attach. It also supports advanced features like grouping, worktrees, Docker sandboxes, and YOLO mode, all accessible through a natural language-style command-line interface.
It is ideal for teams or individuals who need to run multiple AI coding agents in parallel, especially those using various tools like Claude Code, Codex, and OpenCode while developing concurrently across different project branches. DevOps engineers can also use it to monitor the long-running status of agents, ensuring tasks don't waste compute resources due to agent hangs.
We recommend standardizing on aoe within teams to manage all coding agents, rather than directly operating tmux, as this provides session metadata and JSON output under a unified interface for easier integration with monitoring systems. Note that it depends on a tmux environment and is primarily designed for AI coding agent management, not for general tmux window/pane management scenarios.
Key Features
Compared to raw tmux, aoe is specifically designed for AI coding agent scenarios, supporting session metadata (tool name, project path, group, status) and structured JSON output for easy integration into dashboards or automation scripts. In contrast, tmux is a general-purpose terminal multiplexer with no awareness of agent behavior.
Limitations
Requires both aoe and tmux to be installed on the system. It only supports tmux as the session manager and cannot run in a pure terminal environment (without tmux).
FAQ
How do I list all AI coding agent sessions?
Use the `aoe list` command to view a human-readable session list; use `aoe list --json` to obtain JSON-formatted output for script parsing.
How do I capture the real-time output of a specific session?
Use the command `aoe session capture <session ID or title>`. You can combine it with the `--json` and `-n <number of lines>` parameters to control the output.
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-11/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-11/raw/index.md