Agent Of Empires
Manage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.
Last verified:
What is Agent Of Empires?
Agent of Empires (AoE) is an open-source terminal session manager for AI coding agents on Linux and macOS. It lets developers run multiple AI coding agents (like Claude Code, OpenCode, Codex CLI, Gemini CLI, and many others) in parallel from a single beautiful TUI dashboard. The tool wraps tmux to provide session persistence, meaning agents keep running even when you close the terminal or disconnect SSH.
Key features include Git worktrees for automatic branch and worktree creation (preventing code conflicts between agents), Docker sandboxing for isolated and safe agent execution, a web dashboard (beta) accessible from any browser including mobile, and remote phone access via HTTPS with QR pairing. AoE also includes status detection showing when agents are working, waiting for input, or idle, a built-in diff viewer to review git changes, multi-repo workspace support, and tmux persistence for session survival across restarts.
AoE is designed for developers who run two or more CLI-based AI coding agents simultaneously. It's ideal for developers using local LLMs (which run slower and benefit from parallel execution), teams orchestrating multiple agents across different branches, and anyone frustrated by terminal chaos when managing multiple AI sessions. The tool is free and open source, written in Rust, and supports over a dozen AI coding agents with auto-detection of installed tools.
Agent Of Empires pricing
Pricing model: Freemium
Free and open source. There is no paid tier or subscription. The tool is completely free with all features included, including TUI dashboard, web dashboard (beta), Docker sandboxing, Git worktrees, and remote access. Installation is free via brew install aoe, curl install script, or nix run.
Agent Of Empires pros
- Free and open source with no paid tiers
- Beautiful TUI dashboard for managing all agents
- Supports 12+ AI coding agents including Claude Code, OpenCode, Codex, Gemini CLI
- Git worktrees automatically create isolated branches per agent
- Docker sandboxing provides secure isolated container execution
- Sessions persist in tmux and survive terminal crashes
- Web dashboard (beta) accessible from any browser or mobile device
- Remote phone access via HTTPS with QR pairing
- Status detection shows running, waiting, idle, or error states at a glance
- Built-in diff viewer to review git changes without context switching
- Multi-repo workspace support for driving sessions across several repositories
- Automatic worktree creation and cleanup when starting/deleting sessions
- Per-repo configuration with .agent-of-empires/config.toml for project-specific settings
- Keyboard shortcuts enable fast navigation without mouse
- Configurable volume mounts and persistent auth in Docker sandbox
- Browser-based terminal accessible even on phone via PWA install
- Cockpit (alpha) provides mobile-first native rendering with swipe-to-approve
Agent Of Empires cons
- Only supports Linux and macOS (no Windows support)
- TUI interface may be intimidating for non-CLI developers
- Web dashboard is still in beta with rough edges
- Cockpit mobile interface is alpha quality
- Requires tmux knowledge for advanced troubleshooting
- Docker sandboxing is optional and must be configured manually
- Early adopters reported tmux-related bugs (mostly fixed)
- Not ideal for developers using only one AI agent
- Bare git repo setup is recommended but requires initial configuration
- No built-in MCP management (intentionally excluded to stay focused)
Frequently asked questions about Agent Of Empires
What is Agent of Empires (AoE)?
Agent of Empires is an open-source AI agent orchestration tool. It's a terminal-based dashboard that helps developers manage, monitor, and command multiple AI coding agents working in parallel without the usual chaos of scattered terminals and conflicting branches.
Does AoE replace coding agents like Claude or Gemini?
No. AoE is not an AI agent itself. It's a management layer that sits above your existing agents (like Claude Code, Gemini CLI, local LLMs, OpenCode, Codex CLI, etc.), helping you run them more effectively together from a single dashboard.
Who is the ideal user for AoE?
AoE is designed for developers who are running two or more command-line interface (CLI) based AI coding agents simultaneously. If you only use one agent, you likely don't need this tool. It's especially valuable for developers using slower local LLMs who want to run multiple agents in parallel.
How does AoE prevent code conflicts between agents?
AoE utilizes Git worktrees, a feature of Git that allows multiple working trees attached to the same repository. Each agent is assigned its own worktree, effectively giving it an isolated branch and directory to work in, preventing collisions and merge conflicts.
How do I install Agent of Empires?
On Mac, run 'brew install aoe' then 'aoe' to launch. On Linux or macOS, you can also run 'curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bash'. Installation takes under a minute.
What AI coding agents does AoE support?
AoE supports Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Antigravity CLI, Cursor CLI, Copilot CLI, Pi.dev, Factory Droid, Hermes, Kiro CLI, and Qwen Code. It auto-detects which agents are installed on your system.
How does Docker sandboxing work in AoE?
AoE integrates optional Docker sandboxes to run agents in isolated containers. You can configure volume mounts for your project, set up persistent authentication across containers, and benefit from automatic lifecycle management. This keeps agents contained and protects your host system.
Can I access AoE from my phone?
Yes. Press R in the TUI to expose the dashboard over HTTPS with QR pairing using Tailscale Funnel or Cloudflare Tunnel. The web dashboard is also a PWA that can be installed on desktop and mobile for native-like access.
Do my agents keep running if I close AoE?
Yes. AoE wraps tmux, so sessions persist in tmux. Your agents keep running when you close the TUI, disconnect SSH, or even if your terminal crashes. You can reattach to sessions anytime by running 'aoe' again.
What is the recommended project setup for AoE?
The recommended setup uses a 'bare repo' structure where the main repository and all worktrees live under a single directory. This keeps everything organized, is sandbox-friendly for Docker, and makes navigation easier. AoE can also work with non-bare repos but creates worktrees in a sibling directory by default.