Agent of Empires
AI Coding Agent Session Management and Monitoring Tool
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: AI Coding Agent Session Management and Monitoring Tool Full Skill content: https://321skill.com/skills/agent-of-empires-x-4/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 problem of chaotic AI coding agent session management. In real-world development, developers often need to launch multiple AI coding agents like Claude Code, Codex, and OpenCode simultaneously. Manually managing tmux windows is not only cumbersome but also makes it difficult to track each agent's runtime status, output content, and associated project. Agent of Empires (aoe) provides a unified command-line toolset, allowing developers to manage AI coding agent sessions like containers.
Usage is straightforward: simply install aoe and tmux (a system dependency), then use the command aoe add . -t "task name" -l to launch a coding agent session in the current directory. After that, you can use natural language commands to view all session lists (aoe list), capture session output (aoe session capture), start/stop/restart sessions (aoe session start/stop/restart), and even manage sessions in groups (-g backend) or create sub-sessions (-P <parent-id>). All operations support JSON output for easy script integration.
It is particularly suitable for teams or individuals who frequently use AI coding agents. This includes developers already using tools like Claude Code and Codex for assisted development, as well as full-stack engineers who need to manage multiple project branches and execute coding tasks in parallel. It is also applicable for operations personnel who need to monitor agent status to determine if they are stuck or waiting for input.
It is recommended to consistently use this tool to manage AI coding agents when starting new projects or switching branches. Note that it primarily focuses on session management for AI coding agents and is not intended for general tmux window/pane management. Additionally, aoe requires tmux to be installed on the system, and all operations run within tmux sessions, making it unsuitable for Windows environments where tmux cannot be used.
Key Features
Unlike managing sessions directly with tmux, aoe is specifically designed for AI coding agents. It can automatically identify agent states (running/waiting/idle, etc.), supports organizing sessions by project and group, and provides the ability to capture output content, whereas tmux itself only offers basic window management functionality.
Limitations
Requires aoe and tmux to be pre-installed on the system. Primarily supports Linux/macOS environments; Windows requires WSL. Each session occupies an independent tmux session, which may consume significant system resources over prolonged runtime.
FAQ
Which AI coding agents does aoe support?
It supports mainstream AI coding agents like Claude Code, Codex, and OpenCode, and also allows for custom tools (specified via the -c parameter).
How can I view the real-time output of a specific session?
Use the command `aoe session capture <id-or-title>` to capture text content from the tmux pane. Combine with the --json parameter to obtain 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-4/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-4/raw/index.md