Your settings
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.
Seeing them
Section titled “Seeing them”spin settings getShell, editor and environment
Section titled “Shell, editor and environment”spin settings set shell /bin/zshspin settings set editor vimspin settings set env.GOPROXY directshell is your login shell. editor is your default editor. env.KEY sets the environment
variable KEY.
Dotfiles
Section titled “Dotfiles”Name a repository, and the command that installs it. The repository is cloned into new workspaces.
spin settings dotfiles --repo https://github.com/<user>/dotfilesspin settings dotfiles --repo https://github.com/<user>/dotfiles --branch main --install ./install.shspin settings dotfiles --clearWithout --branch the branch is main. Without --install the command is ./install.sh.
A Taskfile
Section titled “A Taskfile”A startup Taskfile runs when your workspaces start. Check a file before you save it:
--validate reads it and saves nothing.
spin settings taskfile --validate <taskfile.yml>spin settings taskfile --file <taskfile.yml>spin settings taskfile --clearA workspace’s own environment
Section titled “A workspace’s own environment”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.
spin workspace create --name <name> --env <KEY>=<value>spin workspace update <workspace> --env <KEY>=<value>When a workspace is not given them
Section titled “When a workspace is not given them”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.
Reference
Section titled “Reference”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.

