Skip to main content
fork creates a new machine that is an exact copy of an existing one β€” same filesystem, same installed packages, same data. The new machine gets its own name, HTTPS domain, and SSH port.

Usage

Specify a custom name:
With --json:
The fork gets its own 100 GB disk, copied from the source machine.
If the default name {source}-fork is already taken, the command fails. Use --name to pick a different name.

Use cases

Rollback

Fork before a risky change:

Experimentation

Try things without affecting your working machine:

Scaling

Need another instance of the same app:
Both machines run the same code and data from the moment of the fork. Changes after the fork are independent.

Forking a shared org machine

If you fork a machine that’s shared with your organization, the fork is private to you by default β€” the org keeps paying, but only you can reach the copy, and your agent logins (Claude Code, Codex, OpenCode) work in it again right away. It’s the clean way to take a shared golden machine and do focused, authenticated work on a copy without touching the shared original.
Forking a personal machine is unchanged β€” the fork stays personal.

Golden images

A β€œgolden image” is a long-running VM that has your app fully installed, configured, and running. You build it once β€” clone the repo, install dependencies, run setup scripts, start the services β€” then leave it running and fork from it whenever you need a warm copy. Every fork inherits the full state β€” code, dependencies, running services, data β€” and boots in ~160ms. No rebuild, no reinstall, no waiting for npm install or container layers to pull. Common patterns:
  • Per-PR previews. Fork on every pull request, apply the branch’s diff inside the fork, share the *.boxd.sh URL with reviewers. Destroy on merge.
  • Per-issue agent runs. Fork the golden, hand it to Claude Code via boxd machine exec, let the agent fix the bug inside the fork. The PR closes, the fork goes away.
  • Sandbox copies. Hand a fresh fork to anyone who wants to poke at the app without touching the source.
  • Reproducing bugs. Fork production state, reproduce the issue safely, throw the fork away.
Forks boot in ~160ms with no setup, and auto-suspend keeps idle cost near zero on both the golden and its short-lived forks. The /boxd-setup-golden and /boxd-setup-fix skills wire this whole loop up for you. See Skills.
Claude Code only for now β€” reach out for Codex, OpenCode, or any other agent.