Agent of Empires
Manage parallel AI coding sessions from a terminal or browser, with work that persists across disconnects.
- Source repo
- agent-of-empires/agent-of-empires
- Stars
- ★ 3.4k
- Last updated
- today
- License
- MIT
- Primary language
- Rust
- FA score
- 88/100 · Good
At a glance
- How it runs
- Works with
- Universal · cross-platformCodex · Claude Code
- Cost
- Free, no paid service needed
- Setup effort
- Low · running in minutes
- You'll need
- Typical use
- Developers working on several branches at once can keep a separate agent session for each task.
- Not a fit if
- Users who need native Windows support
- Source review
- 88/100 · Good
What does this agent do, and when should you use it?
Agent of Empires (AoE) is an AI coding session manager for Linux and macOS, operated through a terminal TUI, CLI, browser interface, and HTTP API. It runs each agent in its own tmux session, so processes continue after the interface closes or an SSH connection drops. Users can run agents in parallel across branches or multi-repository workspaces, with optional Git worktree and container isolation. The browser interface offers a desktop dashboard, terminal and diff views, plus a structured view for phones. AoE requires tmux on the host; Windows use is through WSL2 only.
After installing AoE and tmux, run aoe to open the TUI or aoe add --cmd claude to create a session running Claude Code. AoE starts and persists sessions in tmux, detects agent status, and supports Git worktrees, multi-repository workspaces, and isolation with Docker, Podman, or Apple Containers. Users can inspect sessions in the TUI or launch the web dashboard with aoe serve to access terminal and diff views in a browser. The HTTP API provides another interface, and aoe agents lists agents available on the machine.
- Developers working on several branches at once can keep a separate agent session for each task.
- People working on a remote development machine over SSH can reconnect and inspect sessions that kept running after a disconnect.
- Developers who want to check agent progress from a phone can use the browser's structured session view.
- Teams reviewing agent changes before committing or merging can inspect them in the diff viewer.
- Developers who want to constrain an agent's runtime environment can enable Docker, Podman, or Apple Containers sandboxing.
How do you install or deploy this agent?
AoE targets Linux and macOS and requires tmux. Docker, Podman, and Apple Containers can be used for container sandboxing. The shortest installation path is:
brew install aoeAn install script is also available:
curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bashWindows use requires WSL2. The README does not require API key setup.
How do you use this agent?
Launch the terminal interface:
aoeCreate a session running Claude Code:
aoe add --cmd claudeStart the web dashboard:
aoe serveList agents available on the machine:
aoe agentsPress Ctrl+b d to detach from a tmux session and return to the TUI; the session continues in the background.
What are this agent's strengths and limitations?
- tmux sessions keep running when the TUI closes, SSH disconnects, or a terminal crashes.
- Offers several management surfaces: TUI, CLI, browser interface, and HTTP API.
- Includes agent status detection, Git worktree and multi-repository support, notifications, and diff review.
- Container sandboxing can use Docker, Podman, or Apple Containers.
- Requires tmux on Linux or macOS; Windows is supported through WSL2 only.
- The README does not provide a complete fixed list of supported agents;
aoe agentsshows local availability. - Container sandboxing requires an additional container runtime; Docker is explicitly optional.
- The README does not describe HTTP API authentication or network exposure security settings.
How does this agent compare with similar options?
Compared with using tmux directly, AoE adds agent status detection, Git worktree management, container sandboxing, a web dashboard, phone access, and diff review. Users can still attach to an AoE session directly with tmux attach.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Agent of Empires This agent | 88 · Good | CLIFree | ★ 3.4k | today | Rust | Codex · Claude Code |
| Rove Terminal Agent Workspace | 69 · Some gaps | CLI | ★ 178 | today | TypeScript | Codex · Claude Code |
| zerostack | 57 · Major gaps | CLIFree + model costs | ★ 1.7k | today | Rust | OpenAI API · Claude API |
| dmux | 69 · Some gaps | CLIFree + model costs | ★ 1.8k | 2mo ago | HTML | Codex · Claude Code · OpenAI API |
How does FollowAgents rate this agent?
Why each dimension lost points
The documentation describes host and container mounts, environment-variable handling, credential stores, repository-hook trust, and approval for installing agent hooks, with concrete controls and recovery paths. Scores remain below full marks because YOLO mode, privileged-container options, host command hooks, and shared Claude credentials can have significant effects; disclosure and opt-ins exist, but least privilege and sensitive-data handling are not uniformly safe by default. Cargo dependencies are listed and CI actions are pinned by commit, but the supplied material shows no dependency vulnerability audit. The repository identifies derived code and its license; publisher identity is unverified, and maintenance responsibility points to contributor and maintainer documents without naming accountable owners in the supplied files.
The README, installation guide, configuration reference, and troubleshooting guide give many mutually consistent descriptions of core behavior and limitations. Installation and build dependencies are documented, but the material does not guarantee external dependency availability or establish that every agent tool and adapter remains available. Troubleshooting provides concrete error clues, log locations, and recovery steps, supporting a full score there. Self-consistency is not full: the supplied documents vary in how they state the sandbox image's default tag, and static evidence cannot establish runtime behavior.
The material clearly covers terminal, browser, mobile, SSH, multi-repository, container, and varied runtime scenarios, with ways to configure custom agents. Configuration distinguishes global, profile, repository, and trusted settings; repository overrides, prohibited settings, triggers, and prompts are documented. Requirements and limits for Linux, macOS, WSL2, Node, tmux, and multiple container runtimes are concrete, so audience coverage, boundaries, trigger precision, and environment fit score highly.
The README, installation, configuration, sandbox, repository-hook, and troubleshooting documents are clearly organized and include commands, examples, an FAQ, and known limitations. Install, update, downgrade, and uninstall instructions are detailed. The MIT license is present, and one Apache-2.0-derived file is separately disclosed. Naming and configuration evolution receive some explanation, but the supplied materials contain no changelog or version history beyond the package version and selected migration notes. A maintainer document is referenced, but specific owners and maintenance commitments are not clear from the evidence provided.
The product combines persistent tmux sessions, agent status detection, worktrees and container isolation, TUI and web surfaces, and diff review in one configurable tool. The README explains its added value over plain tmux, and the documentation provides usable commands and workflows. Cost-benefit earns partial credit because tmux is required, some features need containers, Node, or external agent adapters, and credential and isolation settings add operational complexity.
Core product claims in the README have concrete operational support in the installation, configuration, and troubleshooting documents. The material generally separates defaults, limitations, risks, and recommendations, supporting strong traceability and fact/inference separation. Cross-source corroboration receives partial credit: multiple documents and Cargo/CI configuration are available, but the supplied evidence lacks source-code detail, release history, or independent corroboration for this review. This assessment uses only the provided materials and did not execute or independently verify the product.
- Before enabling YOLO, host hooks, repository-hook trust, or privileged-container settings, review the commands, repository contents, and permission scope; sandboxing does not isolate every host resource.
- Claude credentials are shared across sandbox sessions; running /logout in a sandbox affects all of them. Debug logs attempt to scrub common token formats, but the documentation says scrubbing is best-effort.
- The supplied material shows no dependency vulnerability audit or execution verification, and publisher identity is unverified.
FAQ
Do sessions stop when I close AoE?
Which AI coding tools are supported?
aoe agents to see the current tools available on your machine.Can I use AoE over SSH?
aoe again.