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

# deepline git

> Git deploys (beta): link repositories and deploy plays on push.

## git

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git|projects [options] [command]

Git deploys (beta): link repositories and deploy plays on push.

Options:
  -h, --help                  display help for command

Commands:
  connect [options]           Connect a GitHub installation (browser step).
  status [options]            Show the workspace's GitHub installation and
                              whether it is still usable.
  repos [options]             List repos the workspace's GitHub installation can
                              reach.
  list [options]              List linked repositories.
  link [options] <repo>       Link a repository to this workspace for
                              deploy-on-push.
  get [options] <id>          Show one linked repository.
  set [options] <id>          Update a linked repository.
  unlink [options] <id>       Unlink a repository (live plays keep running, and
                              are released from it).
  deployments [options] [id]  Deployment history; pass an id for one deployment.
  cancel [options] <id>       Cancel a queued or running deployment before its
                              plays go live (admin).
  help [command]              display help for command
```

## git connect

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git connect [options]

Connect a GitHub installation (browser step).

Options:
  --json      Emit JSON output
  -h, --help  display help for command
```

## git status

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git status [options]

Show the workspace's GitHub installation and whether it is still usable.

Options:
  --json      Emit JSON output
  -h, --help  display help for command
```

## git repos

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git repos [options]

List repos the workspace's GitHub installation can reach.

Options:
  --installation <id>  GitHub installation id (required when several are
                       connected)
  --json               Emit JSON output
  -h, --help           display help for command
```

## git list

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git list [options]

List linked repositories.

Options:
  --all       Include unlinked repositories
  --json      Emit JSON output
  -h, --help  display help for command
```

## git link

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git link [options] <repo>

Link a repository to this workspace for deploy-on-push.

Arguments:
  repo                 Repo full name (owner/name) or numeric repo id

Options:
  --root-dir <path>    Base path inside the repo for this link
  --branch <name>      Production branch (default: repo default)
  --manifest <file>    Manifest file name under the base path (default:
                       deepline.json)
  --installation <id>  GitHub installation id (required when several are
                       connected)
  --no-pr-checks       Skip Check Runs on pull requests
  --json               Emit JSON output
  -h, --help           display help for command
```

## git get

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git get [options] <id>

Show one linked repository.

Arguments:
  id          Repository link id

Options:
  --json      Emit JSON output
  -h, --help  display help for command
```

## git set

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git set [options] <id>

Update a linked repository.

Arguments:
  id                 Repository link id

Options:
  --branch <name>    Production branch
  --root-dir <path>  Base path inside the repo for this link
  --manifest <file>  Manifest file name under the base path (default:
                     deepline.json)
  --pr-checks        Enable Check Runs on pull requests
  --no-pr-checks     Disable Check Runs on pull requests
  --disabled         Pause deployments for this link
  --enabled          Resume deployments for this link
  --json             Emit JSON output
  -h, --help         display help for command
```

## git unlink

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git unlink [options] <id>

Unlink a repository (live plays keep running, and are released from it).

Arguments:
  id          Repository link id

Options:
  --json      Emit JSON output
  -h, --help  display help for command
```

## git deployments

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git deployments [options] [id]

Deployment history; pass an id for one deployment.

Arguments:
  id           Deployment id (omit to list)

Options:
  --repo <id>  Filter to one repository link
  --limit <n>  Max rows (default 50)
  --json       Emit JSON output
  -h, --help   display help for command
```

## git cancel

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Usage: deepline git cancel [options] <id>

Cancel a queued or running deployment before its plays go live (admin).

Arguments:
  id          Deployment id

Options:
  --json      Emit JSON output
  -h, --help  display help for command
```


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