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

spin git

View Markdown
Your account on a forge is what clones and pushes your workspaces' private repositories: the
control plane keeps its token, and the host your workspace runs on sets it on the requests a
network policy brokers to the forge, so no workspace's disk ever holds it.
You connect an account with spin git connect, which gives you a code to enter on the forge's page,
or in the dashboard (Settings → Git): either way the forge asks you to authorize this
installation's app, and the token it grants stays with the control plane.
Usage:
spin git [flags]
spin git [command]
Available Commands:
connect Connect your account on a forge, with a code you enter on the forge's own page
disconnect Forget your account on a forge, and have the forge revoke its token
list List your connected accounts
repos List the repositories your account reaches, or those whose name has query in it
Flags:
-h, --help[=true|false] help for git
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Use "spin git [command] --help" for more information about a command.
Connect your account on a forge through this installation's app. The control plane asks the
forge for a code; you enter it on the forge's page, signed in as the account to connect, and
authorize the app. The command waits until you have, and the control plane keeps the token: it
never reaches this machine.
The installation's GitHub App must have "Enable Device Flow" checked in its settings on the forge.
Usage:
spin git connect [flags]
Flags:
--forge string The forge (default "github")
-h, --help[=true|false] help for connect
--no-browser[=true|false] Do not open the forge's page in a browser
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Forget your account on a forge, and have the forge revoke the token this installation held: your
workspaces stop reaching your private repositories within the hour their host keeps it.
Usage:
spin git disconnect <forge> [flags]
Flags:
-h, --help[=true|false] help for disconnect
-y, --yes[=true|false] Skip confirmation
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
List your connected accounts
Usage:
spin git list [flags]
Flags:
-h, --help[=true|false] help for list
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
List the repositories your account reaches, or those whose name has query in it
Usage:
spin git repos [query] [flags]
Flags:
--forge string The forge (default "github")
-h, --help[=true|false] help for repos
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false

Generated by task reference from spin/cmd/cli at 51f7e0dea.

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