Skip to content
Spinbox is experimental: APIs change and data may be lost. Status lists what is built and what proves it.

Your settings

View Markdown

Your settings are yours, not a workspace’s. You save them once, and every workspace you own applies them as you saved them. A workspace’s own .spin.yaml goes over them.

Terminal window
spin settings get
Terminal window
spin settings set shell /bin/zsh
spin settings set editor vim
spin settings set env.GOPROXY direct

shell is your login shell. editor is your default editor. env.KEY sets the environment variable KEY.

Name a repository, and the command that installs it. The repository is cloned into new workspaces.

Terminal window
spin settings dotfiles --repo https://github.com/<user>/dotfiles
spin settings dotfiles --repo https://github.com/<user>/dotfiles --branch main --install ./install.sh
spin settings dotfiles --clear

Without --branch the branch is main. Without --install the command is ./install.sh.

A startup Taskfile runs when your workspaces start. Check a file before you save it: --validate reads it and saves nothing.

Terminal window
spin settings taskfile --validate <taskfile.yml>
spin settings taskfile --file <taskfile.yml>
spin settings taskfile --clear

A workspace can hold variables of its own, set when you create it or later. They go over your environment, in that workspace only: another workspace’s environment never reaches it.

Terminal window
spin workspace create --name <name> --env <KEY>=<value>
spin workspace update <workspace> --env <KEY>=<value>

A workspace with a guest in it, or cloned from somebody else’s snapshot, is given none of your dotfiles, environment or Taskfile. Letting a guest into a workspace that already applied them changes what it holds: What you set, and what a workspace applies says what is taken out and what stays.

spin settings lists every command and flag. SettingsService is the same over the API.

Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.