CLI
Clone an App
Use buildspace init to clone a managed Buildspace app repository and pull local environment variables.
Clone by Slug
buildspace init --app <generated-slug>This clones the Buildspace-managed git repository for the app slug into ./<generated-slug>.
Use the slug returned by buildspace app create.
Choose a Destination Directory
buildspace init --app <generated-slug> --dir ./apps/<generated-slug>What buildspace init Does
- resolves your stored CLI auth
- clones the app repository over the Buildspace git gateway
- writes pullable development variables to
.env.localwhen available
Typical Next Steps
cd <generated-slug>
bun install
bun devOnce you are inside the cloned repository, app-scoped commands such as buildspace deploy, buildspace env, and buildspace app hosting status can resolve the app from the git remote automatically.
Requirements
- a configured CLI token via
buildspace auth loginorbuildspace auth set - an existing app slug from your Buildspace account, usually returned when you created the app
Common Errors
Missing auth
If no token is configured, run:
buildspace auth loginGit hosting or template setup issues
If cloning fails immediately, the runtime git gateway or starter template configuration may not be fully set up yet. The CLI prints targeted diagnostics for common misconfigurations.