Buildspace
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.local when available

Typical Next Steps

cd <generated-slug>
bun install
bun dev

Once 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 login or buildspace 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 login

Git 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.

On this page