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-6/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 chaotic and disorganized experience of managing multiple AI coding agent sessions simultaneously. In real-world development, developers often need to run multiple AI coding agents (such as Claude Code, Codex, OpenCode, etc.) concurrently to handle different tasks. However, manually managing tmux windows, tracking session states, and switching project directories is cumbersome, error-prone, and can lead to oversights.
Usage is straightforward. After installing aoe and tmux in your terminal, simply run aoe add . -t "Task Title" -l to create and launch an AI agent session in the current directory. You can then use aoe list to view the status of all sessions, manage their lifecycle with aoe session start/stop/attach, and capture agent output via aoe session capture—all without manually operating tmux.
It is ideal for teams or individuals who need to use multiple AI coding agents in parallel, especially developers who already use tmux to manage their development environment and wish to integrate AI agent sessions into a unified workflow. It significantly boosts efficiency in scenarios involving the maintenance of multiple project branches or frequent context switching.
We recommend adopting this tool within teams to standardize AI agent session management, utilizing the -g grouping and -p profile configuration features to organize different projects or environments. Note that it is primarily designed for AI coding agents and is not suitable for general-purpose tmux window management.
Key Features
Unlike using tmux directly, Agent of Empires provides specialized commands for AI coding agents. For example, `aoe add` automatically creates a session and specifies the tool type, and `aoe status` aggregates states (waiting/running/idle) without requiring manual management of tmux windows and processes.
Limitations
Depends on the `aoe` and `tmux` binaries. Only supports Unix-like systems (Linux/macOS). Requires a runtime environment such as Go or Node.js to be installed.
FAQ
How do I install aoe?
You can install it via Homebrew: `brew install agent-of-empires`, download the binary from GitHub Releases, or install via npm: `npm install -g agent-of-empires`.
How can I view the status of all sessions?
Use `aoe status --json` to get aggregated statistics (waiting/running/idle, etc.) for all sessions. Use `aoe list --json` to get detailed information for each individual session.
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-6/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-6/raw/index.md