ColeMurray/background-agents
An open-source background agents coding system
Open‑Inspect(后台代理)
它是什么 – 一个开源平台,允许 AI 编码代理在真实开发环境(Node、Python、git、浏览器、VS Code)后台运行。用户通过 Web 界面、Slack、GitHub、Linear 或 webhook 启动会话,代理在处理任务时用户可以处理其他事情。
核心理念
- 单租户、可信团队部署 – 所有用户属于同一组织;无需租户隔离。
- 完整的开发沙箱 – 每个会话获得一个全新的沙箱,包含 Node 24、Python 3.12、git、浏览器自动化等。
- 多模型支持 – Anthropic Claude、OpenAI Codex、xAI Grok、OpenCode Zen 等,每个会话可选。
- 实时协作 – 多人可以查看并提示同一会话;提交归属于发起提示的用户。
- 自动化 – cron 式调度、Sentry 警报、GitHub 工作流触发或自定义 webhook 可以在无需人工输入的情况下启动会话。
关键特性
- 快速启动 – 快照和预构建镜像让会话即时恢复。
- 多仓库会话 – 最多可并行克隆 10 个仓库;环境可以保存,并带有各自的机密和镜像。
- 托管技能 – 可重用的指令包(技能),在会话启动时自动注入。
- 子会话 – 代理可以在独立沙箱中生成并行子会话。
- 客户端集成 – Web 界面(Next.js)、Slack 机器人、GitHub 机器人(自动审查、@提及)、Linear 机器人、通用 webhook。
- 提交归属 – git 提交记录发起提示的用户的姓名/邮箱。
- 安全沙箱 – AES‑256‑GCM 加密的机密,按仓库或按环境作用域,隔离的运行时。
架构快照
Clients (Web, Slack, GitHub, Linear, Webhooks)
│
▼
Control Plane (Cloudflare Workers + Durable Objects)
│ – stores session metadata, websockets, event streams, GitHub integration
│ – D1 DB holds repo‑scoped secrets
▼
Data Plane (Sandbox Backend)
│ – Supervisor → Harness (Claude / OpenCode) → Bridge
│ – Full dev environment (Node, Python, git, browser automation)
▼
External services (GitHub, Slack, Linear, Sentry, etc.)
快速入门
- 按照 docs/SETUP_GUIDE.md 进行本地开发和贡献。
- 使用 docs/GETTING_STARTED.md 进行部署(Cloudflare Workers 和所选的沙箱基础设施 – Modal、Daytona、E2B、OpenComputer 等)。
- 创建第一个团队(指南中的步骤 10)并测试会话。
- 按照模型文档配置 AI 模型凭据(Claude Agent、OpenAI OAuth、Grok 订阅)。
典型使用场景
- 为常规代码更改(依赖升级、lint 修复)自动生成 PR。
- 持续分类 Sentry 警报或 GitHub Action 失败。
- 计划维护任务(如夜间 lint、代码库健康检查)。
- 协作结对编程,人类指导 AI 助手。
- 无需离开 UI 即可快速原型化多仓库重构。
许可证 – MIT。
致谢 – 灵感来自 Ramp 的 Inspect;使用 Modal、Daytona、Vercel Sandbox、OpenComputer、E2B、Cloudflare Workers、OpenCode、Claude Agent SDK 和 Next.js 构建。
相关
- 项目
- 项目
- 项目
- 项目
- 项目