humanlayer/humanlayer

The best way to get AI coding agents to solve hard problems in complex codebases.

HumanLayer 是一个系统，可以在你自己的机器上运行 AI 编码代理，并为你的团队提供一个统一的地方来操控它们。 代理（如 Claude Code、Codex、OpenCode 或 Pi）在你的计算机上执行，而任务、会话、计划和审查则在桌面应用、网页应用和每台机器上的后台程序（“守护进程”）之间保持同步。团队可以从一个统一的界面观看和指导代理工作，而不是在多个终端之间切换。

仓库内容

这是一个 monorepo —— 一个包含许多相关应用和库的单一仓库 —— 使用 Turborepo 和 Bun 运行时构建。组成部分：

面向用户的应用 —— 主要 UI（既可作为网页应用，也可在桌面外壳中使用），以及使用 Electron 和 Tauri 编写的 macOS 桌面应用。
守护进程 —— apps/riptide-daemon 在主机上运行代理会话。它也包含在 humanlayer 命令行工具（apps/cli）中。
后端组件 —— 使用 oRPC 和 Hono 构建的 API，以及 Electric（一个将 Postgres 数据同步到客户端应用的工具）前面的认证代理。
管理网页应用 —— apps/riptide-cloud 处理组织、邀请、设置和安装页面。
维护任务 —— 几个 AWS Lambda 函数：数据库迁移器、更新服务器、过期守护进程清理器和数据库维护函数。
插件和扩展 —— 将 Claude Code、Codex、OpenCode 和 Pi 会话镜像回 HumanLayer 的插件，以及带有自己 CLI 的“研究-计划-实施”（RPI）技能，和一个 Linear CLI。
文档和开发工具 —— 用户文档，以及 apps/devstack，它运行一个完整的本地开发栈。
共享代码 —— packages/ 包含库（数据库、模式、UI、同步、AI、计费等），contracts/ 包含定义应用之间通信方式的 RPC 契约。

入门

要从源码构建，你需要 Bun 和 Docker（如果你构建 Tauri 桌面应用，还需要 Rust）。基本步骤：

bun install
cp .env.example .env
bun --bun run typecheck
bun run test

bun --bun run devstack help 解释如何本地运行整个栈。CONTRIBUTING.md 列出了每个拉取请求必须通过的检查。

隐私说明

从源码构建不会向项目维护者发送任何数据。 像 Sentry（错误跟踪）、PostHog（分析）和 WorkOS 客户端 ID 等工具都从环境变量中读取，因此除非你自己设置这些变量，否则它们会保持关闭。.env.example 文件列出了它们。

自托管和许可证

HumanLayer Cloud 运行相同的代码。官方的自托管指南仍在编写中。该项目采用 Apache License 2.0 许可，少数 vendored 文件夹保留自己的 MIT 许可证（在 NOTICE 文件中列出）。