> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# devbox setup-github

> Configure GitHub CLI and Git authentication on a Devbox.

Configure GitHub CLI and Git authentication on a Devbox using the token from your local GitHub CLI.

The command runs `gh auth token` locally, activates the selected Devbox if necessary, passes the token to `gh auth login --with-token` on the Devbox, and runs `gh auth setup-git`. Install `gh` and authenticate locally before running it.

## Usage

```bash theme={null}
devbox setup-github [name] [flags]
```

## Examples

### Configure a named Devbox

```bash theme={null}
devbox setup-github my-devbox
```

```text Output nocopy theme={null}
All done.
```

If you omit the name, the CLI prompts you to select a Devbox.

## Options

**--show\_all** `boolean` (default: false)

Include Devboxes created by other users when selecting a target.

## Related topics

> [card] [Create a Devbox](https://namespace.so/docs/reference/devbox-cli/create.md)
>
> Use `--setup_github` to perform the same setup while creating a Devbox.

> [card] [Spec file](https://namespace.so/docs/reference/devbox-cli/spec-file.md)
>
> Set `github.share_auth` to forward your local GitHub authentication at create time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.