# agent-of-empires — Multi-Agent Manager for Claude Code

> AoE manages multiple AI coding agents with tmux-backed sessions, git worktrees, and an optional web dashboard you can access from phone or browser.

## Install

Copy the content below into your project:

## Quick Use

```bash
# Prerequisite: tmux (required)
brew install aoe
aoe

# Create a Claude Code session (example from README)
aoe add --cmd claude

# Start the web dashboard
aoe serve
```

## Intro

Agent of Empires (AoE) is a session manager that makes parallel AI coding agents practical: persistent tmux sessions, worktree isolation, and a dashboard for quick supervision.

**Best for:** Running 2–10 parallel coding agents across branches and repos

**Works with:** Linux/macOS; tmux required; Docker optional for sandboxing

**Setup time:** 10–20 minutes

### Key facts (verified)

- Supports multiple agent CLIs (Claude Code, Codex CLI, Gemini CLI, Cursor CLI) per README feature list.
- Quick install options include `brew install aoe` and a curl-based installer (README).
- GitHub: 2,191 stars · 187 forks; pushed 2026-05-12 (GitHub API verified).

## Main

AoE is most useful when you standardize three habits:

1) Use git worktrees for each agent session so changes never fight in one working tree.
2) Name sessions after intent (e.g., `lint-fix`, `perf-profile`) so you can triage quickly in the dashboard.
3) Keep a “human review loop”: let agents draft fixes, then review diffs inside AoE before merging.


### README excerpt (verbatim)

<p align="center">
  <img src="assets/logo.png" alt="Agent of Empires" width="128">
  <h1 align="center">Agent of Empires (AoE)</h1>
  <p align="center">
    <a href="https://trendshift.io/repositories/22434" target="_blank"><img src="https://trendshift.io/api/badge/repositories/22434" alt="njbrake%2Fagent-of-empires | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
  </p>
  <p align="center">
    <a href="https://github.com/njbrake/agent-of-empires/actions/workflows/ci.yml"><img src="https://github.com/njbrake/agent-of-empires/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
    <a href="https://formulae.brew.sh/formula/aoe"><img src="https://img.shields.io/homebrew/v/aoe" alt="Homebrew"></a>
    <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
    <a href="https://clawhub.ai/njbrake/aoe"><img src="https://img.shields.io/badge/ClawHub-aoe-blue" alt="ClawHub"></a>
    <br>
    <a href="https://www.youtube.com/@agent-of-empires"><img src="https://img.shields.io/badge/YouTube-channel-red?logo=youtube" alt="YouTube"></a>
    <a href="https://x.com/natebrake"><img src="https://img.shields.io/badge/follow-%40natebrake-black?logo=x&logoColor=white" alt="Follow @natebrake"></a>
    <a href="https://discord.gg/5N3QKX3f6s"><img src="https://img.shields.io/badge/Discord-Mozilla.ai-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
  </p>
</p>

A session manager for AI coding agents on Linux and macOS. Use it from the terminal (TUI) or from any browser ([web dashboard](https://www.agent-of-empires.com/guides/web-dashboard/)).

Run multiple AI agents in parallel across different branches of your codebase, each in its own isolated session with optional Docker sandboxing. Access your agents from your laptop, phone, or tablet.

## Why AoE?

Running one AI agent is easy. Running five of them across different branches, keeping track of which is stuck, which is waiting on input, and which just made a mess of your working tree, becomes a part-time job. AoE makes it a glance: one dashboard, one status column, git worktrees and Docker sandboxes set up for you, and sessions that outlive your terminal.

> If you find this project useful, please consider giving it a star on GitHub: it helps others discover the project!
>
> Want merch? Visit the [store](https://brake.printful.me/).

<p align="center">
  <img src="docs/assets/demo.gif" alt="Agent of Empires Demo" width="800">
  <br>
  <a href="https://www.youtube.com/watch?v=Kk8dX_F-P4E">Watch the getting started video</a>
</p>

### FAQ

**Q: Do sessions die when I close AoE?**
A: README FAQ says sessions persist as tmux sessions until you delete them.

**Q: Does AoE work on Windows?**
A: README FAQ says native Windows is not supported; WSL2 may work.

**Q: Is Docker required?**
A: README lists Docker as optional for sandboxing; tmux is required.

## Source & Thanks

> Source: https://github.com/njbrake/agent-of-empires
> License: MIT
> GitHub stars: 2,191 · forks: 187

---

<!-- ZH -->

## 快速使用

```bash
# 前置：tmux（必需）
brew install aoe
aoe

# 创建 Claude Code 会话（README 示例）
aoe add --cmd claude

# 启动 Web Dashboard
aoe serve
```

## 简介

Agent of Empires（AoE）把“并行跑多个编码 Agent”变得可控：tmux 持久会话、worktree 隔离与可视化面板用于快速监督。

**最适合：** 在多个分支/仓库并行运行 2–10 个编码 Agent

**适配：** Linux/macOS；依赖 tmux；Docker 可选用于沙箱隔离

**配置时间：** 10–20 分钟

### 关键事实（已验证）

- README 特性列表提到支持多种 Agent CLI（Claude Code、Codex CLI、Gemini CLI、Cursor CLI 等）。
- README 提供 `brew install aoe` 与 curl 一键安装两种方式。
- GitHub：2,191 stars · 187 forks；最近更新 2026-05-12（GitHub API 验证）。

## 正文

AoE 真正好用通常来自三个习惯：

1) 每个 Agent 用一个 git worktree，避免在同一个工作区互相踩踏。
2) 会话命名围绕意图（如 `lint-fix`、`perf-profile`），面板里更容易快速分诊。
3) 保留“人类复核回路”：让 Agent 先产出，再在 AoE 内查看 diff/修改后再合并。


### README 原文节选（verbatim）

<p align="center">
  <img src="assets/logo.png" alt="Agent of Empires" width="128">
  <h1 align="center">Agent of Empires (AoE)</h1>
  <p align="center">
    <a href="https://trendshift.io/repositories/22434" target="_blank"><img src="https://trendshift.io/api/badge/repositories/22434" alt="njbrake%2Fagent-of-empires | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
  </p>
  <p align="center">
    <a href="https://github.com/njbrake/agent-of-empires/actions/workflows/ci.yml"><img src="https://github.com/njbrake/agent-of-empires/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
    <a href="https://formulae.brew.sh/formula/aoe"><img src="https://img.shields.io/homebrew/v/aoe" alt="Homebrew"></a>
    <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
    <a href="https://clawhub.ai/njbrake/aoe"><img src="https://img.shields.io/badge/ClawHub-aoe-blue" alt="ClawHub"></a>
    <br>
    <a href="https://www.youtube.com/@agent-of-empires"><img src="https://img.shields.io/badge/YouTube-channel-red?logo=youtube" alt="YouTube"></a>
    <a href="https://x.com/natebrake"><img src="https://img.shields.io/badge/follow-%40natebrake-black?logo=x&logoColor=white" alt="Follow @natebrake"></a>
    <a href="https://discord.gg/5N3QKX3f6s"><img src="https://img.shields.io/badge/Discord-Mozilla.ai-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
  </p>
</p>

A session manager for AI coding agents on Linux and macOS. Use it from the terminal (TUI) or from any browser ([web dashboard](https://www.agent-of-empires.com/guides/web-dashboard/)).

Run multiple AI agents in parallel across different branches of your codebase, each in its own isolated session with optional Docker sandboxing. Access your agents from your laptop, phone, or tablet.

## Why AoE?

Running one AI agent is easy. Running five of them across different branches, keeping track of which is stuck, which is waiting on input, and which just made a mess of your working tree, becomes a part-time job. AoE makes it a glance: one dashboard, one status column, git worktrees and Docker sandboxes set up for you, and sessions that outlive your terminal.

> If you find this project useful, please consider giving it a star on GitHub: it helps others discover the project!
>
> Want merch? Visit the [store](https://brake.printful.me/).

<p align="center">
  <img src="docs/assets/demo.gif" alt="Agent of Empires Demo" width="800">
  <br>
  <a href="https://www.youtube.com/watch?v=Kk8dX_F-P4E">Watch the getting started video</a>
</p>

### FAQ

**关掉 AoE 会话会消失吗？**
答：README FAQ 表示会话作为 tmux 会话在后台持久存在，直到你手动删除。

**Windows 能用吗？**
答：README FAQ 表示原生 Windows 不支持，可能需要 WSL2。

**必须装 Docker 吗？**
答：README 说明 Docker 仅用于可选沙箱隔离；tmux 才是必需项。

## 来源与感谢

> Source: https://github.com/njbrake/agent-of-empires
> License: MIT
> GitHub stars: 2,191 · forks: 187


---
Source: https://tokrepo.com/en/workflows/agent-of-empires-multi-agent-manager-for-claude-code
Author: Agent Toolkit