`sbxm prepare`

sbxm prepare [<project-id>]

Prepare builds the project image, creates the sandbox, clones the repository inside it, applies declared files, and creates the configured managed worktrees. In an interactive terminal, omit the project ID to choose a managed project. In a non-interactive terminal, an explicit project ID is required.

Before running it, register the project-specific GH_TOKEN custom secret printed by sbxm add. The secret proxy must cover the GitHub hosts the repository uses.

Prepare is a mutation. It refuses artifacts that cannot be proven to belong to the project instead of adopting or overwriting them.

Prepare is also the way to restore a neutral workspace directory that the host lost. When the sandbox record is still there and its directory is not, prepare creates the directory again, keeps the sandbox itself, and reports the path it created as a warning. It restores nothing inside that directory, because there is nothing in it: the repository is inside the sandbox.