Agent of Empires

Manage parallel AI coding sessions from a terminal or browser, with work that persists across disconnects.

Stars
★ 3.4k
Last updated
today
License
MIT
Primary language
Rust

At a glance

How it runs
CLIWeb app
Works with
Universal · cross-platformCodex · Claude Code
Cost
Free, no paid service needed
Setup effort
Low · running in minutes
You'll need
tmuxDocker (optional)Podman (optional)Apple Containers (optional)Shell / CLILocal filesystem
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.

  1. Developers working on several branches at once can keep a separate agent session for each task.
  2. People working on a remote development machine over SSH can reconnect and inspect sessions that kept running after a disconnect.
  3. Developers who want to check agent progress from a phone can use the browser's structured session view.
  4. Teams reviewing agent changes before committing or merging can inspect them in the diff viewer.
  5. 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 aoe

An install script is also available:

curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bash

Windows use requires WSL2. The README does not require API key setup.

How do you use this agent?

Launch the terminal interface:

aoe

Create a session running Claude Code:

aoe add --cmd claude

Start the web dashboard:

aoe serve

List agents available on the machine:

aoe agents

Press 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?

Pros
  • 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.
Limitations
  • 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 agents shows 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?

FollowAgents source review · FARS-2.1
Good
88/ 100 5-point scale 4.4 / 5
Trust 24/29
Reliability 11/14
Adaptability 18/18
Convention 16/18
Effectiveness 12/13
Verifiability 7/8
Why each dimension lost points
Trust24 / 29 · 4.1/5

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.

Reliability11 / 14 · 3.9/5

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.

Adaptability18 / 18 · 5.0/5

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.

Convention16 / 18 · 4.4/5

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.

Effectiveness12 / 13 · 4.6/5

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.

Verifiability7 / 8 · 4.4/5

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.

Risks and how to mitigate them
  • 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.
Evidence confidence: Low Reviewed Oct 21, 2026 Reviewed revision 4f72cb0273fa
See the full review method →

FAQ

Do sessions stop when I close AoE?
No. Sessions run in the background as tmux sessions and are removed only when you delete them.
Which AI coding tools are supported?
The README names Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, and Factory Droid Coding. Run aoe agents to see the current tools available on your machine.
Can I use AoE over SSH?
Yes. Sessions persist through SSH disconnects; reconnect and run aoe again.
Does AoE run natively on Windows?
No. AoE depends on tmux and POSIX process handling, so Windows use is through WSL2.
Does AoE cost anything?
The repository is MIT licensed. The README does not specify an AoE usage charge or the service costs of the agents it manages.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents