TypeScript · 项目报告

AgentSystemLabs/agent-office

A cartoon 3D office where your team hires Claude Code workers at desks, shares live terminals, talks over voice, and tracks GitHub issues and PRs.

已完成 打开 GitHub
A
427星标
99Fork
15Issue
MIT许可证

分析结果

项目分析

Agent Office 是一个用 TypeScript 构建的“3D 虚拟办公室”式 AI 编程协作平台。它把每个 GitHub 仓库映射成一层办公楼,让团队在浏览器中雇佣 Claude Code、Codex、OpenCode、Grok、Muse、DeepSeek Harness 等 AI 编程代理坐在办公桌前工作,实时查看和接管它们的终端,并结合 GitHub Issues、PR、工作树、语音、聊天、屏幕共享和白板完成协作开发。项目采用 MIT 协议,当前 README 明确标注为 Work in progress,功能变化较快,适合愿意折腾和二次开发的开发者或小团队。

适用领域 AI 编程代理 / 多 Agent 协作 / 开发者工具 / GitHub 工作流 / 远程协作 / 代码审查与 PR 管理 / 终端共享 / MCP 工具集成 / 3D Web 应用 / DevOps 自动化部署
配置难度 中高。单人本地体验相对简单,一条安装脚本即可启动;但要稳定用于团队协作,需要理解 Node.js、GitHub CLI、Agent CLI 登录、git worktree、端口与认证、SSH Tunnel/Tailscale、云服务器部署以及权限隔离。对于熟悉 AI Coding Agent 和 DevOps 的开发者难度中等,对于普通前端或初级开发者会偏高。
商业价值 对已经重度使用 AI 编程代理的团队有较高探索价值。它把多个 AI Agent 的任务分配、终端监控、GitHub Issue/PR 流程和团队协作集中到一个可视化环境中,可能提升并行开发、代码修复、Issue 处理和原型迭代效率。对于中国开发团队而言,它更适合作为内部 AI 研发工作台、Agent 编排实验平台或二次开发基础,而不是立即作为稳定生产工具。由于项目早期且变化快,商业落地前应重点评估账号权限隔离、私有代码安全、模型成本、部署稳定性和团队开发规范适配。
01

技术亮点

  • 把 AI 编程代理可视化成 3D 办公室中的 worker,交互方式直观且有趣。
  • 支持多个主流 AI 编程 CLI,包括 Claude Code、Codex、OpenCode、Grok、Muse、DeepSeek Harness。
  • 每个 GitHub 仓库对应一个楼层,项目隔离清晰。
  • 可以直接在虚拟笔记本上观看和接管每个 worker 的实时终端。
  • GitHub Issues 和 PR 以看板形式呈现在办公室墙上,适合围绕任务流管理 AI 开发。
  • 支持为每个 worker 创建独立 git worktree,降低多 Agent 并行开发时的分支冲突。
  • 支持跨项目任务,一个任务可在多个仓库中创建相互链接的 PR。
  • 提供 MCP server 和 office-workers 命令,使 Agent 能够管理其他 Agent。
  • 支持语音、聊天、屏幕共享、共享白板,具备团队协作属性。
  • 提供 /lite 轻量界面,适合手机或低性能电脑使用。
  • 部署选项丰富,覆盖本地、AWS、Azure、Railway、Fly.io、Dokploy 和普通 Ubuntu/Debian 服务器。
  • MIT 许可证,方便企业或个人二次开发。
02

目标用户

  • 已经在使用 Claude Code、Codex、OpenCode、Grok 等 AI 编程 CLI 的个人开发者
  • 希望同时调度多个 AI Coding Agent 的技术负责人或独立开发者
  • 需要围绕 GitHub Issues 和 Pull Requests 组织 AI 开发任务的小型团队
  • 喜欢可视化、游戏化开发环境的开发者
  • 需要共享 AI Agent 终端、语音、屏幕、白板的远程协作团队
  • 愿意 fork 并按自身流程深度定制工具的高级开发者
03

配置要求

  • Node.js 20 或更高版本,部署脚本中可能使用 Node 22。
  • git 必需。
  • GitHub CLI gh 必需,用于克隆仓库、读取 Issues/PR、推送 PR,通常需要执行 gh auth login。
  • 至少一个 AI Agent CLI,并以运行 Agent Office 的系统用户身份登录,例如 Claude Code、Codex、OpenCode、Grok、Muse、DeepSeek Harness。
  • 如果使用 Claude Code,可通过 claude setup-token、Anthropic API Key 或在 worker 终端中 /login 完成认证。
  • 默认本地监听 127.0.0.1;如设置 --host 0.0.0.0 可被局域网访问,但普通 HTTP 下语音和屏幕共享可能不可用。
  • 团队共享建议部署到服务器,并通过 SSH 隧道、Tailscale HTTPS 或具备证书的安全入口访问。
  • 办公室密码保存在 ~/agent-office/.agent-office/config.json,可通过 --password 指定。
  • 项目默认克隆到用户选择的目录,例如 ~/agent-office、~/code、~/Workspace 下的 owner/repo 路径。
  • AWS 部署需要 AWS CLI 登录、ssh、curl;Azure 部署需要 Azure CLI 登录、ssh、curl。
04

适用场景

  • 为一个 GitHub 仓库创建虚拟办公楼层,并在其中管理多个 AI 编程代理
  • 把 GitHub Issue 分配给不同 AI Agent,让它们在独立 git worktree 中完成任务
  • 实时查看每个代理的终端输出,并在需要时人工接管输入
  • 让一个任务跨多个项目执行,并在多个仓库中生成相互关联的 PR
  • 通过 GitHub PR 看板跟踪 AI 生成代码的开发、提交和合并状态
  • 让代理之间互相管理,例如列出、雇佣、发送消息、关闭其他 worker
  • 在远程团队中共享 AI 编程会话,包括语音、聊天、屏幕共享和白板
  • 在手机或低性能设备上通过 /lite 轻量 2D 界面查看 worker 状态和终端
  • 在 AWS、Azure、Railway、Fly.io、Dokploy 或自有 Ubuntu/Debian 服务器上部署团队共享环境
05

部署与配置

  • 确保运行机器安装 Node.js 20+、git、GitHub CLI,并完成 gh auth login。
  • 至少安装并登录一个支持的 Agent CLI,例如 claude、codex、opencode、grok、muse 或 dsh。
  • macOS/Linux 本地安装:curl -fsSL https://raw.githubusercontent.com/AgentSystemLabs/agent-office/main/install.sh | bash
  • Windows PowerShell 安装:irm https://raw.githubusercontent.com/AgentSystemLabs/agent-office/main/install.ps1 | iex
  • 首次启动时根据终端向导选择项目克隆目录、配置 GitHub、选择第一个 GitHub 仓库。
  • 启动后浏览器会自动打开登录链接;终端会打印 office password,可用于其他浏览器登录。
  • 进入 3D 办公室后走到空办公桌,按 E 选择并雇佣一个 worker。
  • 如需从源码安装:git clone https://github.com/AgentSystemLabs/agent-office && cd agent-office && npm install && npm install -g . && agent-office
  • 常用启动参数包括:agent-office --port 4700、agent-office --password 'correct horse'、agent-office --agent claude、agent-office --no-open。
  • 团队部署可使用 deploy/aws.sh、deploy/azure.sh 或其他平台部署脚本,并建议通过 SSH Tunnel 或 Tailscale 暴露服务。
06

风险与注意事项

  • README 明确标注为 Work in progress,并说明项目是围绕作者个人工作流快速迭代,可能存在频繁破坏性变更。
  • 功能较多且涉及 AI CLI、GitHub CLI、git worktree、终端共享、WebRTC/语音屏幕共享、云部署等,排障复杂度较高。
  • 多人共享时 GitHub Token 和 Agent 账号可能被办公室内用户共同使用,存在权限和审计风险。
  • AI Agent 自动推送代码和创建 PR,可能引入低质量代码、安全漏洞或不符合团队规范的变更。
  • 如果 --host 0.0.0.0 直接暴露到网络,且未正确配置 HTTPS、认证和访问控制,可能产生安全风险。
  • 依赖外部 Agent CLI 和模型服务,成本、速率限制、登录状态和服务稳定性会影响使用体验。
  • 3D 场景和丰富交互可能对浏览器性能有要求,低配设备需要使用 /lite。
  • 当前 star 数和 fork 数显示项目有一定关注度,但仍属于早期工具,生产级稳定性需要自行验证。
  • 企业环境中使用语音、屏幕共享、终端共享和自动化 GitHub 操作,可能需要额外合规审查。

历史记录

热榜历史快照

2026-10-01 第25名 新收录 · github_search