Managing an Army of AI Coding Agents with Agent of Empires

Agent of Empires is an open‑source project designed to solve the problem of managing many AI coding agents simultaneously. It provides a single interface for agents such as Claude Code, Codex, Gemini CLI, OpenCode, Mistral Vibe, Cursor CLI, and Copilot CLI.

What it can do

Run multiple AI agents at once – Different agents can operate on separate branches within the same project, each in an isolated session that does not interfere with the others.

Status at a glance – The TUI shows which agent is running, waiting for input, or idle. Press Ctrl+b d to detach a session and later return to the same state.

Mobile management – Press R in the TUI to expose an HTTPS web interface via Tailscale Funnel or Cloudflare Tunnel, allowing phone access through a QR‑code scan.

Docker sandbox isolation – Each agent can run inside its own Docker (or Podman/Apple Containers) container, preventing code errors from contaminating the host environment.

Branch and worktree handling – Agent of Empires automatically creates Git worktrees so that multiple agents can work on different branches in parallel, and it also supports multi‑repository workspaces.

Core features

TUI panel : Visual creation, monitoring, and management of sessions directly in the terminal.

Web Dashboard : Browser‑based access to agent terminals, session switching, command input, and diff viewing.

Remote phone access : QR‑code plus password authentication for secure mobile connections.

Session persistence : Conversations survive system reboots; reopening aoe restores the previous state.

Sound and push notifications : Audio alerts and browser push notifications when an agent requires input.

Diff view : Inline code change visualization without leaving the TUI.

Installation

The tool depends on tmux. Install it with one of the following commands:

# macOS and Linux
curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bash
# or via Homebrew
brew install aoe

Quick start

aoe          # launch the TUI
aoe add --cmd claude   # create a session that runs Claude Code
aoe serve    # start the web dashboard

Each agent runs in its own tmux session, so closing the TUI, disconnecting SSH, or a terminal crash does not stop the agents. Re‑opening aoe returns you to the same position.

GitHub: https://github.com/agent-of-empires/agent-of-empires<br/>Stars: 2,607+ | License: MIT | Language: Rust