Agent of Empires CLI
Agent of Empires (AoE)
A session manager for coding agents: runs Claude Code, OpenCode, Codex and other CLIs in parallel, isolated tmux sessions with a TUI and web dashboard
- 4,226 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Launches and controls coding-agent processes, including their access to project files
- Optional container isolation requires rights to run Docker
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/agent-of-empires-aoeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Launches and controls coding-agent processes, including their access to project files
- Optional container isolation requires rights to run Docker
This is third-party code. Review the repository files before installing.
What it does
AoE runs each coding agent in its own persistent tmux session, so agents keep working after you close the terminal, lose the SSH connection or the shell crashes. It shows the status of every running agent, sends notifications when one finishes, and can open several sessions across different git worktrees or repositories at once. You control it from a terminal TUI, from a browser on your phone, or through an HTTP API. Sessions can optionally run isolated in Docker, Podman or Apple Containers, with a diff viewer built into the dashboard.
Who it is for. For developers who run several coding agents on different tasks at once and want to track them from one place.
Good fit when
- You need to run several coding agents in parallel on different branches
- An agent should keep working after SSH disconnects or the terminal closes
- You need to check session status from a phone browser
- You need each session isolated via a git worktree or container
Not a fit when
- You work with a single agent in one terminal without parallel tasks
- You need native Windows support without WSL2 — AoE depends on tmux and POSIX
Example request
Start Claude Code in a background session on task X, I will check the status later from my phoneLimitations
Runs on Linux and macOS; on Windows only through WSL2. Requires tmux to be installed, and Docker or an equivalent for container isolation. AoE does not replace coding agents, only manages their sessions.
How to disable. Remove the aoe binary (brew uninstall aoe or delete it from PATH) and stop any remaining tmux sessions manually with tmux kill-session.
FAQ
What happens if I close AoE?
Nothing: sessions keep running in tmux in the background and are removed only manually.
How is this different from plain tmux?
tmux gives you persistent sessions; AoE adds agent status detection, git worktree management, container isolation, a web dashboard with phone access, and a diff viewer. You can still attach to any AoE session with plain tmux attach.
Discussion
No questions or reviews yet.
Related
CLI toolsA self-hosted control center for coding agents: Claude Code, Codex, Copilot, OpenCode and Pi from your phone, desktop and terminal
A native macOS terminal built on Ghostty with vertical tabs and notifications when an agent needs your input
A Docker sandbox for coding agents: a Debian image with Copilot CLI, Codex and Pi, and SSH, RDP and Docker enabled by flags.
A local dashboard for Claude Code and Codex sessions: who is working, who waits for you, plus a 3D aquarium and Stream Deck
The reach CLI points a coding agent at any machine over SSH: keys and conversation stay with you and the target installs nothing
AgentBox runs Claude Code, Codex and Open Code in separate virtual machines on your PC, a self-hosted server or a cloud.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Agent of Empires (this card) | no | 4,226 | |
| multi-agent-shogun | no | 1,421 | ten AI agents in tmux panes |
| agent-manager | no | 691 | a tmux-based TUI that runs Claude Code |
README in short
The README describes AoE as a session manager for coding agents on Linux and macOS. Each agent runs in its own tmux session with optional isolation via git worktree, Docker, Podman or Apple Containers. It offers a TUI, a web dashboard with a mobile view, a CLI and an HTTP API. Install via Homebrew, Nix, an install script, or building from Rust source. Supported agents include Claude Code, OpenCode, Codex, Cursor agent, Gemini CLI, GitHub Copilot CLI and Factory Droid. MIT licensed.