Skip to main content
Declare remote development services in bead.toml, then run a service with a foreground localhost forward.

​
Configure a service

Use a template with Node and npm installed. Keep your server on the declared port.

​
Start it

The CLI syncs source once, starts the service and forwards HTTP and WebSocket traffic on 127.0.0.1. Follow the localhost address printed by the command. A dev invocation has a 24-hour timeout. Restart it when you need a longer session. To select another local port, or request an allocated port:

​
Apply local edits

Press Ctrl-C, then run bead worktree dev web again. Each invocation syncs once; local edits require a new invocation. Other managed commands report busy while dev owns the machine. If the CLI disconnects, use bead worktree stop to stop the service. Active services keep compute billed. See environment files for service-specific values and share a preview for expiring access links.