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-7/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 cumbersome and error-prone nature of manually managing tmux sessions when running multiple AI coding agents (such as Claude Code, Codex, OpenCode, etc.) simultaneously. In real-world development, developers often need to switch between multiple terminal windows, starting, monitoring, and stopping agents individually—a process that is inefficient and prone to oversight. Agent of Empires (aoe) provides a unified command-line interface that lets you manage agent sessions like containers.
Usage is straightforward: simply install aoe and tmux, then use the aoe add command to add a new session, specifying the project directory, title, tool, and group. You can then view all sessions and their statuses (running, waiting, idle, etc.) via aoe list, and control session lifecycles with commands like aoe session start/stop/attach. It also supports advanced features such as nested grouping, workspace isolation, Docker sandboxing, YOLO mode (skipping permission confirmations), and all operations can be performed using natural language instructions.
It is ideal for teams or individuals who need to manage multiple AI coding agents concurrently, especially developers already using tmux for terminal management. Agent developers, backend engineers, and full-stack engineers working on multiple feature modules in parallel can use it to centrally monitor agent progress, capture outputs, and avoid constant switching between windows. For scenarios requiring session isolation by project or team (e.g., development on different branches, code reviews for different clients), aoe's profile and group mechanisms are particularly useful.
It is recommended to use this tool uniformly within project directories to manage all AI coding agent sessions, avoiding mixing with native tmux commands. Note that it is primarily designed for coding agent scenarios and is not suitable for general tmux window management. Additionally, it depends on the aoe and tmux binaries, which must be installed in the environment beforehand; Windows users are advised to use it via WSL. In large projects managing dozens of sessions simultaneously, be mindful of tmux's resource consumption.
Key Features
Unlike manually creating and managing panes with tmux commands, aoe provides an abstraction layer tailored for AI coding agents, supporting session management by group and profile, and enabling structured status output via `--json` for easy integration into automation scripts or CI/CD pipelines. It also includes built-in features designed specifically for AI agent scenarios, such as session capture and status aggregation, which would require manual command combinations in native tmux to achieve similar results.
Limitations
Depends on aoe and tmux binaries; only supports Linux/macOS environments (Windows requires WSL); tmux version 2.1 or higher is needed for full functionality; tmux itself may become a performance bottleneck when managing a large number of sessions simultaneously.
FAQ
How can I start multiple AI agents at once?
You can execute the `aoe add` command multiple times to add different sessions, or write a script to loop the calls. It also supports immediately starting a session after adding it via the `-l` parameter.
How do I view real-time output from a specific agent?
Use the `aoe session capture <id-or-title>` command to capture text content from the tmux pane. It supports `--json` for structured output and `-n` to specify the number of lines, making it convenient for monitoring or pipeline processing.
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-7/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-7/raw/index.md