agent-of-empires/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.

Agent of Empires (AoE) – 快速概览

它是什么：一个轻量级会话管理器，让你可以在 Linux 或 macOS 上运行、监控和控制 AI 编码代理。每个代理都运行在独立的持久 tmux 会话中，因此即使你关闭终端或断开 SSH 连接，工作也会继续运行。

为什么重要：当你尝试多个 LLM 驱动的编码助手（Claude、GPT-4 等）时，通常需要独立的环境、git worktree 或容器沙箱。AoE 通过整洁的 TUI、Web 仪表板（桌面端 + 移动端）、CLI 和 HTTP API 将这一切整合在一起。

核心功能

功能	作用
多接口	TUI、Web UI、CLI 和 HTTP API – 选择最适合你工作流程的接口。
持久会话	代理在 `tmux` 内运行；它们能在终端关闭、SSH 断开或崩溃后继续存活。
Git worktree 和多仓库支持	为每个代理管理独立的 worktree，使分支特定工作变得简单。
容器沙箱	通过 Docker、Podman 或 Apple Containers 提供可选隔离。
结构化视图和差异审查器	在干净的 UI 中查看代理输出、文件差异和状态；支持手机友好视图。
自定义命令和钩子	为可重复的设置定义每个代理的命令、仓库钩子和配置文件。
通知和状态检测	当代理完成任务或遇到错误时提供实时反馈。

工作原理

AoE 为每个添加的 AI 代理创建一个 tmux 会话。
会话运行你指定的命令（例如，claude 用于 Claude Code）。
AoE 跟踪会话，通过 TUI、Web UI 或 API 暴露其状态。
你可以分离（Ctrl+b d）并在不丢失状态的情况下重新附加。
可选沙箱在 Docker/Podman/Apple Container 内运行会话，保持主机干净。

快速开始

# 安装（需要 tmux，Docker 可选）
brew install aoe                     # macOS Homebrew
# 或
curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bash

# 启动 TUI
aoe

# 添加编码代理（以 Claude Code 为例）
aoe add --cmd claude

# 启动 Web 仪表板（从任何浏览器访问）
aoe serve

完整文档：从 README 链接到快速入门、CLI 参考和 API 文档。

何时使用 AoE

多个代理：并排运行多个基于 LLM 的编码器，每个都有自己的 git 上下文。
长时间运行的任务：在 SSH 会话或终端崩溃后保持代理存活。
隔离需求：在容器中测试代码而不污染主机。
团队可见性：共享 Web 仪表板，让协作者可以从笔记本电脑或手机观看进度。

限制

仅适用于 Linux/macOS（Windows 通过 WSL2）。
依赖 tmux；没有原生 Windows 支持。
AI 工具支持取决于你能从命令行调用的内容；AoE 本身不提供模型。

贡献与社区

Discord：每周二上午 9 点（美国东部时间）有实时办公时间。
GitHub：按照 CONTRIBUTING.md 指南关注路线图、提交问题和提交 PR。
许可证：MIT（包含一个小型 Apache-2.0 组件）。

底线：Agent of Empires 是一个实用的开源 AI 编码代理编排器，为你提供持久、沙箱化和可观察的会话，而无需重新发明 tmux。