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.)

快速入门

  1. 按照 docs/SETUP_GUIDE.md 进行本地开发和贡献。
  2. 使用 docs/GETTING_STARTED.md 进行部署(Cloudflare Workers 和所选的沙箱基础设施 – Modal、Daytona、E2B、OpenComputer 等)。
  3. 创建第一个团队(指南中的步骤 10)并测试会话。
  4. 按照模型文档配置 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 构建。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目