Agent of Empires
A command-line 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 command-line tool for managing AI coding agent sessions. Full Skill content: https://321skill.com/skills/agent-of-empires-x-3/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 issue of chaotic session management and the inability to centrally monitor when developers use multiple AI coding agents (such as Claude Code, Codex, OpenCode, etc.). In real-world development, developers often need to launch multiple agents simultaneously to handle different tasks. However, manually managing tmux windows, switching sessions, and tracking progress is time-consuming and prone to missing critical output.
Usage is straightforward: simply install aoe and tmux, then use the command aoe add . -t "task name" -l to quickly create and immediately launch an agent session. Afterwards, you can view the status of all sessions with aoe list, capture output in real-time with aoe session capture <id>, and control the lifecycle with aoe session start/stop/restart. All operations can be performed using natural language commands, eliminating the need for manual tmux manipulation.
It is well-suited for teams or individuals who need to manage multiple coding agents concurrently. This is especially useful for developers already using tools like Claude Code or Codex, or those engaged in parallel development or multi-branch work requiring simultaneous monitoring of multiple AI agent progress. DevOps engineers can also use it to centrally manage agent sessions, replacing manual tmux scripts.
It is recommended to adopt this tool uniformly in scenarios requiring frequent launching, monitoring, and switching of AI coding agents, as it can significantly boost efficiency. Note that it is primarily designed for AI coding agents and is not suitable for general tmux window management. Additionally, aoe depends on tmux; ensure tmux is installed on your system and that the aoe version is compatible with your agent tools.
Key Features
Unlike using raw tmux commands, aoe provides dedicated session management tailored for AI coding agents. It supports organizing agents by group and configuration profile, automatically detects agent status (running/waiting/idle), and allows for quick retrieval of agent output via `aoe session capture`. In contrast, tmux requires manual window switching and scroll capture.
Limitations
Depends on tmux and the aoe binary. Currently lacks native support for non-Unix systems (e.g., Windows), and performance may degrade with a very high number of sessions due to tmux limitations.
FAQ
How do I install aoe?
Clone from the GitHub repository or install via a package manager: `git clone https://github.com/agent-of-empires/agent-of-empires.git`. Ensure tmux is installed on your system.
How do I quickly create a new agent session?
Execute `aoe add . -t "task description" -l` in your project directory. This will create and immediately launch a session. The tool defaults to using Claude.
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-3/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-3/raw/index.md