Humanlayer AI Agent

HumanLayer

HumanLayer runs coding agents (Claude Code, Codex, OpenCode, Pi) on your machines and lets your team steer them from one place: tasks, sessions, plans, and reviews, synced between a desktop app, a web app, and a daemon on each host.

This repo holds all of it. It's a Turborepo monorepo that uses Bun.

What's here

• apps/riptide-ui: the app, as a web app and inside the desktop shells
• apps/riptide-electron, apps/riptide-native: the macOS desktop apps (Electron, Tauri)
• apps/riptide-daemon: the daemon that runs agent sessions on a host
• apps/cli: the humanlayer CLI, which also ships the daemon
• apps/riptide-api: the oRPC + Hono API
• apps/riptide-electric-proxy: the auth proxy in front of Electric, which syncs Postgres to clients
• apps/riptide-cloud: the admin web app (organizations, invites, settings, install page)
• apps/riptide-migrator, apps/updater-server, apps/stale-daemon-sweeper, apps/database-maintenance-function: AWS Lambda jobs
• apps/riptide-claude-code-plugin, apps/riptide-opencode-plugin, apps/riptide-pi-extension: plugins that mirror Claude Code, OpenCode, and Pi sessions into HumanLayer
• apps/riptide-humanlayer-claude-plugin: the built-in HumanLayer skills
• apps/riptide-rpi-claude-plugin, apps/linear-cli: the Research-Plan-Implement skills and the Linear CLI
• apps/docs: the user docs
• apps/devstack: runs a full local stack per worktree
• packages/: shared libraries (db, schemas, ui, sync, ai, billing, ...)
• contracts/: the oRPC and Effect RPC contracts between the apps

Get started

You need Bun and Docker. Building apps/riptide-native also needs Rust.

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

bun --bun run devstack help explains how to run the whole stack locally. CONTRIBUTING.md lists every check a pull request must pass.

A build from source sends nothing to us: Sentry, PostHog, and the WorkOS client ID come from env, and stay off when unset. .env.example lists them.

Self-hosting

HumanLayer Cloud runs this code on AWS. .claude/skills/self-host-humanlayer/ holds a reference copy of our Pulumi stacks and GitHub Actions workflows, with every secret and HumanLayer-specific value replaced by a placeholder. It also covers the services, the order to deploy them in, and what you must change. Open it in Claude Code, or another agent that reads skills, and ask it to help you self-host HumanLayer.

It's a reference, not a supported install: expect to adapt it.

⚠️ note - If you use the Docker Compose file as a starter for self hosting, please note that it uses default/simple passwords that should be updated before you deploy.

License

Apache License 2.0. A few vendored folders keep their MIT licenses; NOTICE lists them.