Agent of Empires
A session management tool for unified control of AI coding agents
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 session management tool for unified control of AI coding agents Full Skill content: https://321skill.com/skills/agent-of-empires-x-5/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 operations and chaotic state management when handling multiple AI coding agent sessions simultaneously. In real-world development, engineers often need to run multiple AI agents—such as Claude Code, Codex, and OpenCode—in parallel to handle different tasks. However, manually switching tmux windows, monitoring progress, and capturing outputs is highly inefficient and error-prone. Agent of Empires provides a dedicated command set that lets you manage AI agent sessions like containers.
Usage is straightforward: first install aoe and tmux, then run aoe add . -t "task name" -l to launch an AI agent session in the current directory and start it immediately. Advanced options are supported, including specifying the tool type (-c codex), group (-g backend), worktree (-w fix/issue), and Docker sandbox (-s). Afterwards, use aoe list to view all session statuses, aoe session start/stop/attach to control the lifecycle, and aoe session capture to retrieve output content. All operations are performed via natural language or command line—no manual tmux manipulation required.
It is particularly suitable for teams or individuals who need to run multiple AI coding agents concurrently, especially full‑stack developers, agent developers, and backend engineers. This tool is ideal for scenarios where users already employ tools like Claude Code or Codex but want to organize, monitor, and switch between multiple agent sessions more efficiently—for example, when processing multiple feature branches in parallel, debugging different modules simultaneously, or sharing agent configurations within a team.
We recommend using this tool consistently whenever multiple AI agents need to run at the same time, avoiding direct manipulation of raw tmux windows. Note that it is primarily designed for managing coding‑agent sessions and is not intended for general tmux window or pane management. Additionally, tmux and the aoe binary must be pre‑installed, and currently only Unix‑like systems are supported.
Key Features
Unlike manually managing windows directly with tmux, Agent of Empires provides dedicated commands for AI agents (such as add, capture, status) that automatically handle metadata like session IDs, titles, and tool types, and supports advanced features like grouping, worktrees, and Docker sandboxes—whereas tmux requires manual window creation, naming, and state tracking.
Limitations
Requires tmux and the aoe binary; only supports Unix‑like systems. Currently, it mainly supports specific tools like Claude Code, Codex, and OpenCode, and is not suitable for general‑purpose AI models or non‑coding agent scenarios.
FAQ
How can I view all running AI agent sessions?
Use `aoe list` for a human‑readable list, `aoe list --json` for JSON output, or `aoe status --json` to see statistics for each state.
How do I launch an agent with a worktree under a specific group?
Run `aoe add /path/to/repo -t "task description" -g group_name -w worktree_branch -l`, where `-l` starts the session immediately.
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-5/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-5/raw/index.md