HumanLayer
让编码智能体在你的机器上运行，团队在一个地方统一驾驭任务、会话、计划与审查。
- Star 数
- ★ 12k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 工程团队想并行运行多个 Claude Code 会话，并在统一的界面中审查、纠偏而不是逐个终端切换
- 不适合
- 需要一个开箱即用、无需自行部署的纯托管产品的团队——官方自托管指南仍在编写中
- 不用 Claude Code、Codex、OpenCode 或 Pi 的团队，因为会话镜像依赖这些插件
- 源码审查
- 49/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
HumanLayer 是一个开源的智能体编排平台，用于在开发者自己的机器上运行 Claude Code、Codex、OpenCode 和 Pi 等编码智能体。仓库是一个基于 Turborepo 和 Bun 的单体仓库，包含 Web 应用 riptide-ui、macOS 桌面端（Electron 与 Tauri 两套）、运行智能体会话的 riptide-daemon、humanlayer CLI 以及 oRPC + Hono 后端 API。各主机上的守护进程执行会话，数据通过 Electric 将 Postgres 同步到客户端，实现桌面端、Web 端与守护进程之间的任务、会话、计划与审查同步。riptide-claude-code-plugin、riptide-opencode-plugin、riptide-pi-extension 等插件将外部智能体会话镜像到 HumanLayer 中。HumanLayer Cloud 官方托管同一代码，仓库也支持从源码自部署。
在每个主机上通过 riptide-daemon 运行编码智能体会话（Claude Code、Codex、OpenCode、Pi），由 CLI humanlayer 随附部署。riptide-ui 提供 Web 与桌面（Electron/Tauri）界面，让团队从一处查看并引导任务、会话、计划与审查。riptide-api（oRPC + Hono）处理前后端通信，riptide-electric-proxy 位于 Electric 前面，把 Postgres 数据同步给客户端；会话数据由 riptide-claude-code-plugin、riptide-opencode-plugin、riptide-pi-extension 镜像进平台。riptide-cloud 提供组织、邀请、设置与安装页等管理功能，另有 updater-server、stale-daemon-sweeper 等 AWS Lambda 任务负责维护。仓库内置 Research-Plan-Implement 技能（riptide-rpi-claude-plugin）、linear-cli，以及本地开发用的 devstack。
- 工程团队想并行运行多个 Claude Code 会话，并在统一的界面中审查、纠偏而不是逐个终端切换
- 跨多台开发机器工作的开发者，希望任务与会话状态在桌面端、Web 端和各主机守护进程之间保持同步
- 已在使用 Codex、OpenCode 或 Pi 的团队，想通过镜像插件把会话集中到一处管理
- 需要自托管、数据不出自有机房的团队——从源码构建时 Sentry、PostHog、WorkOS 均默认关闭
- 采用 Research-Plan-Implement 工作流并配合 Linear（linear-cli）管理工程任务的团队
如何安装或部署这个 Agent？
前置要求：安装 [Bun](https://bun.sh) 与 Docker；构建 apps/riptide-native 还需要 Rust。
bun install
cp .env.example .env
bun --bun run typecheck
bun run test.env.example 中列出了 Sentry、PostHog、WorkOS client ID 等配置项；从源码构建时若这些环境变量未设置，相关上报功能保持关闭。
如何使用这个 Agent？
本地完整开发/运行栈：
bun --bun run devstack help该命令说明如何用 devstack 在本地按 worktree 运行整个栈（含 API、数据库同步代理等）。日常使用路径：在各主机部署 riptide-daemon（humanlayer CLI 随附守护进程），在桌面端或 Web 端创建任务、启动会话、编写计划并做审查；用 riptide-claude-code-plugin、riptide-opencode-plugin、riptide-pi-extension 把外部智能体会话镜像进来。PR 需通过的完整检查项见 CONTRIBUTING.md。
这个 Agent 有哪些优点和局限？
- 把运行在你自己机器上的多个编码智能体（Claude Code、Codex、OpenCode、Pi）统一到一个可审查、可纠偏的控制台
- 同时提供 Electron 与 Tauri 两套 macOS 桌面端、Web 端和 CLI，数据通过 Electric + Postgres 在三者间同步
- 从源码构建默认不向外发送遥测数据（Sentry、PostHog、WorkOS 均由环境变量控制）
- Apache-2.0 许可，且 HumanLayer Cloud 与自部署运行同一份代码
- 自托管指南仍在编写中，从源码部署需要 Bun、Docker、Postgres/Electric 同步链路以及多个 Lambda 任务，门槛不低
- Docker Compose 自托管起步文件使用默认/简单密码，部署前必须自行修改
- 桌面端目前仅有 macOS（Electron/Tauri），没有 Linux 或 Windows 桌面应用
- 构建 apps/riptide-native 额外需要 Rust 工具链；单体仓库体量大，本地开发需要 devstack 全栈
这个 Agent 与同类方案有什么区别？
仓库主题同时列出 claude-code、codex、opencode、amp，说明 HumanLayer 定位为在这些编码智能体之上的编排与人工监督层，而非与它们竞争的另一个智能体。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| HumanLayer 当前 | 49 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 12k | 今天 | TypeScript | Codex · Claude Code |
| 深度研究技能包（Deep Research Skills） | 43 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 2.4k | 2 个月前 | Python | Codex · Claude Code |
| PRO-LONG | 57 · 缺口较多 | 命令行工具免费 | ★ 459 | 2 个月前 | Python | Codex · Claude Code |
| MonoCode | 56 · 缺口较多 | 桌面应用免费 | ★ 3.4k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示遥测（Sentry/PostHog/WorkOS）默认关闭且由环境变量控制，构建时不外发数据，这对数据流透明和敏感数据是加分；package.json 中含 socket 安全扫描器；Docker Compose 默认弱口令有明确警告。但权限模型（daemon 执行 agent 会话、automation-run 测试中出现 permissionsMode: 'bypass'）、用户确认机制、回滚能力在提供的文件中均无说明，只能给低分。发布者身份未经核实，且 SECURITY.md 提到 HumanLayer Cloud，归属仅部分可见。
提供的三组 CLI 测试覆盖 token 刷新竞态、参数校验、错误信息格式化，错误消息带具体修复指引（如 `humanlayer login`），一致性尚可。但仅见测试文件、未见被测核心实现与 CI 测试结果，依赖（Bun/Docker/Rust）可用性只有声明级描述。
README 明确面向在自有机器上运行编码 agent 的团队，环境要求（Bun、Docker、Rust、Node>=24）写明。但自动化 CLI 默认 permissionsMode: 'bypass' 未在文档层面说明边界与风险，触发条件与能力边界缺乏文档。
信息架构是明显强项：README 逐目录说明 monorepo 结构；许可证 Apache-2.0 全文与 NOTICE（vendored MIT）齐备；安装步骤具体可执行；自托管进行中、Compose 默认口令等局限有提示。但无 CHANGELOG/版本策略说明，示例仅限命令，维护责任与更新路径未见治理文件（CONTRIBUTING 被引用但未提供）。
产品价值主张（集中管控多 agent 会话）清晰，但提供的文件无法证明输出可用性、相对替代方案的边际价值或成本收益；automation-run 的 bypass 权限暗示无人值守运行的成本/风险未被文档化。
README 声明可由 package.json 部分印证（socket 扫描器、env 控制），事实与推断大体可分；但关键声明（'sends nothing to us'、测试通过、daemon 行为）无法在所给文件中溯源到实现，缺少跨来源印证。
- 自动化运行路径的 permissionsMode: 'bypass' 意味着无人值守的 agent 可能绕过权限确认；部署前务必审查 daemon 与 automation 命令的权限边界。
- Docker Compose 自托管起始配置使用默认/简单口令，部署前必须修改。
- 发布者身份未经核实；依赖 lockfile 与供应链完整性需自行审计（bun.lock 等文件未在评审范围内）。
- 自托管指南仍在编写中，生产部署前缺乏完整文档。
- 本评审为静态源码评审，未执行任何测试或运行时验证。
常见问题
必须使用 HumanLayer Cloud 吗？
支持哪些编码智能体？
从源码构建会向外发送数据吗？
.env.example 列出了全部相关项。