---
title: "lizard git"
description: "lizard git connects the GitHub App, reports repository status, and switches a service to another branch with a redeploy."
url: https://lizard.build/docs/cli/git/
updated: 2026-08-09
---

# lizard git

Manage the GitHub connection for the linked project and its services.

## Usage

```bash
lizard git connect
lizard git status
lizard git checkout <service> <branch> [flags]
```

## Subcommands

### `lizard git connect`

Connect the GitHub App to access private repositories.

### `lizard git status`

Show GitHub connection and repository status.

### `lizard git checkout <service> <branch>`

Switch a service to a different branch and redeploy.

| Flag | Description |
|------|-------------|
| `--detach` | Skip log streaming |

## Examples

### Connect the GitHub App

```bash
lizard git connect
```

### Check connection and repository status

```bash
lizard git status
```

### Switch a service to a different branch

```bash
lizard git checkout api staging
```

### Switch branches without streaming logs

```bash
lizard git checkout api staging --detach
```

## See also

- [Deploy from GitHub](https://lizard.build/docs/deploy/github.md) — connecting a repo, auto-redeploy on push, and monorepo setup
- [lizard add](https://lizard.build/docs/cli/add.md) — create a service from a GitHub repo