Skip to main content
Use a cloud development environment while keeping your editor, coding agent and Git on your laptop. Each Git worktree uses its own persistent bead machine for Linux builds and services.

​
What runs in your remote development environment

Tools installed on your laptop are not available remotely. Use macOS or Linux. On WSL2, use the Linux CLI and keep the checkout in the Linux filesystem. Native Windows is unsupported.

​
Your local files are authoritative

Managed execution syncs selected source files before it runs. Sync is one way: remote edits are not merged into your local files. Guest-only caches and build outputs survive sync. Use artifact pulls to retrieve outputs separately. Git stays local. The guest has an initialized Git repository and files, without your Git history. Use BEAD_GIT_COMMIT and BEAD_GIT_BRANCH for version stamping.

​
Worktree isolation

bead worktree up creates or recovers the binding. prepare reconciles dependencies explicitly. exec runs a command; dev runs a declared service and forwards localhost traffic. Active commands and services keep compute billed. Idle pause preserves state and bills storage. down deletes the bound machine; templates and prepared snapshots have separate lifetimes. Start with Set up a worktree, then read configuration and recovery.