agent-fleet

Agent Fleet 是一个用于以集群方式运行 AI 编程代理的自托管控制台。其核心优势在于您可以关闭笔记本电脑而代理仍能继续工作：团队通过一个浏览器控制台共享代理，成员可以通过 Discord、Slack 或手机检查进度或发送下一条指令，而无需一直坐在终端前。 README 中列出的支持的代理 CLI 包括 Claude Code、Codex CLI、GitHub Copilot CLI、Antigravity CLI、Cursor CLI、Kiro 和 OpenCode。每位团队成员都拥有一个隔离的个人环境——在 Docker 版本中为带有 cgroup CPU 和内存配额的 Docker 容器，在无需 Docker 的原生版本中则为 bubblewrap 沙箱——并配备持久化的主目录及其自身的 git 工作副本。会话的启动、跟踪和引导均在浏览器中完成。 由于是自托管，公司可以在自己的基础设施上运行部署，因此凭据、源代码和对话都保留在组织内部。相同的核心代码既可以运行在带有 Docker Compose 的单台 Linux 主机上，也可以运行在 AWS ECS 上。 仓库中描述的控制台功能包括： - 启动对话框：可选择代理 CLI、模型、推理强度、启动模式，以及是在全新的 git worktree 还是现有工作副本中运行。 - 聊天镜像：代理的问题、计划和权限提示以卡片形式出现，可直接在原处回答。 - 分割窗格：聊天镜像、通过 PTY 连接到 shell 会话的实时终端以及工作树更改可并排显示；窗格可弹出至独立标签页。 - 控制台内的 Git 工具：在所选提交的 diff 旁显示提交图，并支持针对每个工作副本和 worktree 进行暂存和提交。 - 使用情况标签页：提供 24小时/7天/30天的分功能堆叠 Token 图表，包含 Token、调用次数、缓存读取、等效 API 成本和未测量调用的 KPI 磁贴，并按功能、代理和模型细分。未报告 Token 的调用将被单独计数而非计为零。 界面提供英文或日文，可在设置中按用户切换；两种语言均有截图。 部署选项被定义为“二十分钟决策”：compose（默认，单台 Linux 主机上的团队 Docker 部署）、native（无需 Docker，单用户，如 WSL2 或个人 Linux 机器）、ecs / ecs-ec2（具有任务级隔离的 AWS）以及 ec2-single（AWS 小团队，单台 VM 上的 Compose）。发布的软件包从 GHCR 拉取固定镜像并发布到独立的发行仓库；命令流程与其操作对象共存（deploy/compose, deploy/native, deploy/aws/ecs）。从源码构建涉及复制 .env.example、生成 AF_MASTER_KEY 等密钥、构建个人工作区镜像并运行 docker compose。Caddy 通过 Let's Encrypt 处理 TLS，登录则使用控制平面自身的 OAuth。 文档按读者分类：guide/ 解释如何操作，并分发到每个工作区容器中，可通过控制台的“User guide”条目打开；docs/ 解释代码的工作原理及其原因。源码组织为 workspace/（代理及其镜像）、control-plane/ 和 console/，本地开发栈通过 deploy/local/run-dev.sh 启动（local = Docker, wsl, native, reset）。 README 还统一了术语：Workspace（工作区）是指为单个用户提供的具有主卷和运行进程的持久化容器环境；Working copy（工作副本）是指在 Workspace 内部克隆的 git 仓库的工作目录；Session（会话）是指对话、其设置和执行状态的逻辑单元，与工作副本绑定。会话并不一定意味着终端——Codex、OpenCode、Copilot、Cursor 和 Kiro 默认使用由聊天视图驱动的管理执行方法（Codex 和 OpenCode 运行在没有每会话 CLI 进程的共享运行时上），而 Claude、Antigravity 和纯 shell / SSM 会话则使用终端。 该项目采用 Apache License 2.0 许可，README 指出，公开处理凭据工具的源码以便每家公司审计加密和隔离实现是其产品主张的一部分。贡献指南位于 CONTRIBUTING.md，漏洞报告和威胁模型位于 SECURITY.md。