HumanLayer
HumanLayer는 코딩 에이전트(Claude Code, Codex, OpenCode, Pi)를 사용자의 장치에서 실행하고, 팀원들이 작업(tasks), 세션(sessions), 계획(plans), 검토(reviews) 등의 기능을 통해 한 곳에서 이들을 제어할 수 있게 합니다. 이러한 기능들은 데스크톱 앱, 웹 앱, 그리고 각 호스트의 데몬 간에 동기화됩니다.
이 저장소에는 모든 것이 포함되어 있습니다. 이는 Turborepo 모노레포(monorepo)이며 Bun을 사용합니다.
구성 요소
apps/riptide-ui: 웹 앱 및 데스크톱 셸 내부에서 사용되는 애플리케이션입니다.
apps/riptide-electron, apps/riptide-native: macOS용 데스크톱 앱(Electron, Tauri)입니다.
apps/riptide-daemon: 호스트에서 에이전트 세션을 실행하는 데몬입니다.
apps/cli: 데몬도 함께 제공하는 humanlayer CLI 도구입니다.
apps/riptide-api: oRPC + Hono API를 구현합니다.
apps/riptide-electric-proxy: Postgres를 클라이언트에 동기화하는 Electric 전면의 인증 프록시(auth proxy)입니다.
apps/riptide-cloud: 관리 웹 앱(조직, 초대, 설정, 설치 페이지)입니다.
apps/riptide-migrator, apps/updater-server, apps/stale-daemon-sweeper, apps/database-maintenance-function: AWS Lambda 작업들입니다.
apps/riptide-claude-code-plugin, apps/riptide-opencode-plugin, apps/riptide-pi-extension: Claude Code, OpenCode, Pi 세션을 HumanLayer로 미러링하는 플러그인들입니다.
apps/riptide-humanlayer-claude-plugin: 내장된 HumanLayer 스킬(skills)입니다.
apps/riptide-rpi-claude-plugin, apps/linear-cli: Research-Plan-Implement 스킬과 Linear CLI 도구입니다.
apps/docs: 사용자 문서입니다.
apps/devstack: 워크트리(worktree)당 전체 로컬 스택을 실행합니다.
packages/: 공유 라이브러리(db, schemas, ui, sync, ai, billing, ...)가 포함되어 있습니다.
contracts/: 앱 간의 oRPC 및 Effect RPC 계약서입니다.
시작하기
Bun과 Docker가 필요합니다. apps/riptide-native를 빌드하려면 Rust도 필요합니다.
bun install
cp .env.example .env
bun --bun run typecheck
...
bun --bun run devstack help 명령을 사용하여 전체 스택을 로컬에서 실행하는 방법을 설명할 수 있습니다. CONTRIBUTING.md 파일에는 풀 리퀘스트(pull request)가 통과해야 하는 모든 검사 항목이 나열되어 있습니다.
소스 코드에서 빌드된 경우, 저희에게는 아무것도 전송되지 않습니다: Sentry, PostHog, 그리고 WorkOS 클라이언트 ID는 환경 변수(env)에서 가져오며, 설정되지 않으면 작동하지 않습니다. .env.example 파일에 목록이 있습니다.
자체 호스팅 (Self-hosting)
HumanLayer Cloud에서 이 코드가 실행됩니다. 직접 실행하는 방법에 대한 가이드는 현재 작업 중입니다.
⚠️ 참고 사항 - 자체 호스팅을 위해 Docker Compose 파일을 시작점으로 사용하는 경우, 배포하기 전에 업데이트해야 하는 기본/간단한 암호가 사용된다는 점에 유의하십시오.
라이선스 (License)
Apache License 2.0. 몇몇 포함된(vendored) 폴더는 자체 MIT 라이선스를 유지하며, NOTICE에 목록이 있습니다.