Agent of Empires
A CLI 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 CLI tool for managing AI coding agent sessions Full Skill content: https://321skill.com/skills/agent-of-empires-x-10/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 and loss of control when managing multiple AI coding agent sessions (e.g., Claude Code, Codex, OpenCode) simultaneously. In real-world development, developers often need to switch between multiple projects. Manually managing tmux windows and sessions can easily lead to lost progress or confused context. Agent of Empires provides a unified session management entry point.
Usage is straightforward. After installing aoe and tmux, simply run aoe add . -t "Task Name" in your project directory to create an agent session. You can then use aoe list to view the status of all sessions, control their lifecycle with aoe session start/stop/attach, organize them into groups using the -g parameter, and switch between different configuration profiles with -p.
It's ideal for teams or individuals who need to run multiple coding agents concurrently. It's especially beneficial for full-stack developers, agent developers, or backend engineers who are already accustomed to using tmux but want to manage their AI coding workflows more efficiently, significantly reducing context-switching overhead.
We recommend using this tool when working on multiple feature branches or parallel development tasks. Note that it is primarily designed for AI coding agents, not for general tmux management. Do not use it to manage regular terminal windows. It also depends on tmux and a Unix-like environment.
Key Features
Unlike creating windows directly with tmux, Agent of Empires automatically assigns each agent session an ID, title, tool type, and project path. It provides status monitoring (running/waiting/idle, etc.) and supports grouping/profile management, eliminating the need to manually remember tmux window numbers.
Limitations
Only supports Unix-like systems. Requires tmux and the aoe CLI. Cannot be used directly in a native Windows environment.
FAQ
How do I view all active agent sessions?
Run `aoe list`. The output includes each session's ID, title, status, tool, and path.
How do I stop a stuck agent session?
Use `aoe session stop <session ID or title>`. It will safely terminate the process within tmux.
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-10/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-10/raw/index.md