Install the SDK
Install the SDK and its peer dependencies with your preferred package manager.@namespacelabs/sdk/devbox. The package root, @namespacelabs/sdk, also re-exports the same API.
Create your first Devbox
Create a Devbox from the Node.js image, run a command, and delete the Devbox when finished.Authenticate with Namespace
For CI/CD and other automated workloads, use workload identity federation to obtain short-lived Namespace credentials without storing a shared token. For local development, install the Devbox CLI and authenticate:devbox login, or a Namespace workload token. See Authenticate with Namespace for the complete resolution order and explicit token sources.
Explore the SDK
Create and manage Devboxes
Create Devboxes and control their lifecycle.
Run commands
Execute structured commands and shell scripts.
Use interactive terminals
Open and control pseudo-terminal sessions.
Work with files
Transfer and manipulate files and directories.
Interact with the display
Capture screenshots and send pointer input.
Use blueprints
Create reusable Devbox configurations.
Manage images
Register, inspect, and optimize images.
Handle errors and timeouts
Cancel operations and handle SDK failures.