# spin git

**Spinbox is experimental: APIs change and data may be lost.** What is built and what proves it is on [Status](https://docs.spinbox.dev/reference/status.md); what Spinbox does not do is on [Limitations](https://docs.spinbox.dev/overview/limitations.md).

> spin git: Your accounts on forges: GitHub, connected through this installation's app.

<!-- Generated by tools/refgen from spin:cmd/cli. Edit the source, not this file. -->

```
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.
```

### spin git connect

```
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
```

### spin git disconnect

```
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
```

### spin git list

```
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
```

### spin git repos

```
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
```
