Appearance
Install the CLI
Install the bakers command, sign in and check your workspace access. Most people let the setup wizard do this for them.
You need: Node.js ≥ 20.19 with npm, git and your team's server URL.
Install the CLI. Use
@bakers-build/bakers@<version>if your team pins a release.shnpm install -g @bakers-build/bakers bakers --versionConfirm your account and workspace access in the browser.
- Sign in at
<server-url>/user/login. - Create a workspace at
<server-url>/home/new-workspaceor accept an invitation at<server-url>/home/join/<invite>. - A workspace lead grants missing access; the CLI cannot create these prerequisites.
- Sign in at
Configure bakers.build. Run outside a project checkout and follow the prompts:
shbakers initThe local operator name identifies you on this machine, separately from your authenticated account. Setup writes machine/connection configuration, not project configuration.
Online: pendingmeans sign-in is still outstanding.Already configured bakers.build? Keep correct existing values and fill only what is missing.
Sign in. Open the displayed URL on any device and approve the code.
shbakers dropsh auth login bakers dropsh auth statusVerify the connection and workspace access.
shbakers config check --scope connection --online bakers infoCheck the selected server. Authentication must pass first; only then does an empty
workspace_idsmean missing workspace rank. Ask a workspace lead to grant it.
Done when: the CLI runs, authentication passes and bakers info lists a workspace.
Next
- Prepare a machine with your workspace manager and development environment.
- Worker on Linux? Claude and Codex runs need their OS sandbox: install
bubblewrapandsocat(sudo apt-get install -y bubblewrap socat), then runbakers oven checkin the connected project. See Sandbox prerequisites. - Unattended server? Use a machine connection with client credentials; see worker servers and connections.
- Command missing? Check Node.js and PATH, then troubleshooting.