humanlayer/humanlayer

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

HumanLayer는 자체 머신에서 AI 코딩 에이전트를 실행하고 팀이 이를 제어할 수 있는 단일 장소를 제공하는 시스템입니다. 에이전트(예: Claude Code, Codex, OpenCode, Pi)는 컴퓨터에서 실행되며, 작업, 세션, 계획, 검토는 데스크톱 앱, 웹 앱, 각 머신의 백그라운드 프로그램(‘데몬’) 간에 동기화됩니다. 팀은 별도의 터미널을 전환하는 대신 통합 인터페이스에서 에이전트 작업을 보고 지시할 수 있습니다.

리포지토리 내용

이것은 모노레포입니다 — 많은 관련 앱과 라이브러리를 포함하는 단일 리포지토리 — 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가 있는 “Research-Plan-Implement”(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에 따라 라이선스가 부여되며, 일부 벤더 제공 폴더는 자체 MIT 라이선스를 유지합니다(NOTICE 파일에 나열됨).