BoxHaven Documentation

BoxHaven runs remote development boxes for AI coding agents. Use these docs to install the CLI, connect to a hosted or self-hosted backend, create boxes, run agents inside persistent sessions, and operate the backend.

Start here

• Getting started: install bh, log in, create a box, run an agent, disconnect, reattach, and use normal SSH clients.
• Agent skill: install with Vercel's Skills CLI to teach Codex or Claude box creation, persistent agents, parallel tasks, project sync, and previews.
• CLI reference: every command and flag for boxes, direct SSH, sync, teams, images, auth, and config.
• Self-hosting: run the Fastify/Better Auth control plane with your own provider credentials.

Operate boxes

• Teams: team-owned boxes, roles, invitations, and moving boxes between teams.
• Golden images: save, select, and remove team VM images by name.
• Cloud providers: configure DigitalOcean and Hetzner Cloud provider settings.

Security and operation

• Security model: short-lived SSH certificates, the backend user CA, and forwarded credentials.
• External policy service: optional create policy and native account-page integration for operators.

Documentation for agents

llms.txt lists the documentation pages and their Markdown URLs. For example, commands.md is the source of the CLI reference. The website and these exports are built from the same files.

Source and license

BoxHaven is open source under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). The source code, copyright notice, and full license text live in the BoxHaven GitHub repository.