帝国代理人 (AoE)

适用于 Linux 和 macOS 上 AI 编码代理的终端会话管理器。基于 tmux (终端复用器) 构建，使用 Rust 编写。

在代码库的不同分支上并行运行多个 AI 代理，每个代理都在其独立的隔离会话中，并可选择 Docker 沙箱机制 (Docker sandboxing) 进行隔离。

如果您觉得这个项目有用，请考虑在 GitHub 上给它一个星标：这有助于其他人发现该项目！

功能特性

• 多代理支持 -- Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI, Copilot CLI, Pi.dev, 和 Factory Droid
• TUI 仪表板 -- 用于创建、监控和管理会话的文本用户界面 (TUI) 可视化界面
• 代理 + 终端视图 -- 使用 t 键在 AI 代理和配对的 Shell 终端之间切换
• 状态检测 -- 查看哪些代理正在运行、等待输入或处于空闲状态
• Git 工作树 -- 在同一仓库的不同分支上运行并行代理
• Docker 沙箱 -- 将代理隔离在容器中，共享认证卷
• 差异视图 -- 无需离开 TUI 即可查看 git 更改和编辑文件
• 按仓库配置 -- .aoe/config.toml 用于项目特定设置和钩子
• 配置文件 -- 为不同项目或客户分离工作区
• CLI 和 TUI -- 两个界面均具备完整功能 (CLI 即命令行界面)

工作原理

AoE 封装了 tmux。每个会话都是一个 tmux 会话，因此当您关闭 TUI 时，代理仍在运行。重新打开 aoe，一切依旧存在。

需要了解的关键 tmux 快捷键：Ctrl+b d 可分离会话并返回到 TUI。

安装

前置条件： tmux (必需), Docker (可选，用于沙箱)

# Quick install (Linux & macOS)
curl -fsSL \
  https://raw.githubusercontent.com/njbrake/agent-of-empires/main/scripts/install.sh \
  | bash

# Homebrew
brew install aoe

# Nix
nix run github:njbrake/agent-of-empires

# Build from source
git clone https://github.com/njbrake/agent-of-empires
cd agent-of-empires && cargo build --release

快速开始

# Launch the TUI
aoe

# Add a session from CLI
aoe add /path/to/project

# Add a session on a new git branch
aoe add . -w feat/my-feature -b

# Add a sandboxed session
aoe add --sandbox .

在 TUI 中：按 n 创建会话，按 Enter 附加，按 t 切换终端视图，按 D 查看差异，按 d 删除，按 ? 获取帮助。

文档

• 安装 -- 前置条件和安装方法
• 快速开始 -- 第一步和基本用法
• 工作流指南 -- 推荐设置，包括裸仓库和工作树
• Git 工作树 -- 在不同分支上并行运行代理
• Docker 沙箱 -- 代理的容器隔离
• 仓库配置与钩子 -- 项目级设置和自动化
• 差异视图 -- 在 TUI 中查看和编辑更改
• tmux 状态栏 -- 集成的会话监控
• 音效 -- 可听的代理状态通知
• 配置参考 -- 所有配置选项
• CLI 参考 -- 完整的命令文档
• 开发 -- 贡献和本地设置

常见问题

当我关闭 aoe 时会发生什么？

没什么。会话是后台运行的 tmux 会话。您可以随时打开和关闭 aoe。只有当您明确删除它们时，会话才会被移除。

支持哪些 AI 工具？

Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI, Copilot CLI, Pi.dev, 和 Factory Droid。AoE 会自动检测您系统上安装了哪些。

故障排除

在移动 SSH 客户端（Termius, Blink 等）中使用 aoe

从移动设备连接时，请在 tmux 会话内运行 aoe：

tmux new-session -s main
aoe

附加到代理会话后，使用 Ctrl+b L 切换回 aoe。

Claude Code 闪烁

这是一个已知的 Claude Code 问题，不是 aoe 的问题：https://github.com/anthropics/claude-code/issues/1913

开发

cargo check          # Type-check
cargo test           # Run tests
cargo fmt            # Format
cargo clippy         # Lint
cargo build --release  # Release build

# Debug logging (writes to debug.log in app data dir)
AGENT_OF_EMPIRES_DEBUG=1 cargo run

Star 历史

致谢

灵感来源于 agent-deck (Go + Bubble Tea)。

作者

由 Nate Brake (@natebrake) 创建

许可证

MIT 许可证 -- 详情见 LICENSE。

Agent of Empires (AoE) 快速上手指南

Agent of Empires (AoE) 是一款专为 Linux 和 macOS 设计的 AI 编码代理终端会话管理器。它基于 tmux 构建，支持在代码库的不同分支上并行运行多个 AI 代理，并提供可视化的 TUI 界面进行管理。

环境准备

在使用 AoE 之前，请确保您的系统满足以下要求：

• 操作系统: Linux 或 macOS
• 核心依赖: tmux（必需）
• 可选依赖: Docker（用于沙盒隔离功能）
• 开发语言: Rust（仅当从源码编译时需要）

安装步骤

推荐使用以下任一方式安装最新版本：

1. 脚本安装（推荐）

适用于 Linux 和 macOS：

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

2. Homebrew 安装

适用于 macOS 及部分 Linux 发行版：

brew install aoe

3. 源码编译

如需自定义版本：

git clone https://github.com/njbrake/agent-of-empires
cd agent-of-empires && cargo build --release

基本使用

启动管理界面

直接运行命令即可进入 TUI 仪表盘：

aoe

创建会话

您可以通过命令行添加项目会话：

• 添加普通项目：

  aoe add /path/to/project
  

• 在新 Git 分支上运行：

  aoe add . -w feat/my-feature -b
  

• 使用 Docker 沙盒运行：

  aoe add --sandbox .
  

TUI 常用操作

在 TUI 界面中，您可以使用以下快捷键进行交互：

快捷键	功能
n	创建新会话
Enter	附加到会话
t	切换终端视图（查看 Shell）
D	查看 Diff 视图
d	删除会话
?	显示帮助信息

会话管理提示

AoE 底层基于 tmux 会话，关闭 TUI 不会停止后台运行的代理。

• 分离会话：按 Ctrl+b d 可返回 TUI 界面，会话保持运行。
• 重新连接：再次运行 aoe 即可查看并恢复之前的所有会话状态。