# pier github

> GitHub push-to-deploy

URL: https://pier.run/docs/cli/reference/github

```bash
pier github <command>
```

GitHub push-to-deploy.

## Subcommands

### pier github connect

```bash
pier github connect [flags]
```

Connect this project to a GitHub repository.

| Flag          | Value    | Default | Description                    |
| ------------- | -------- | ------- | ------------------------------ |
| `--repo`      | `STRING` |         | GitHub repository (owner/repo) |
| `-y`, `--yes` |          |         | Skip confirmation prompt       |

### pier github set

```bash
pier github set [flags]
```

Configure deploy triggers for push-to-deploy.

| Flag       | Value    | Default | Description                                                                |
| ---------- | -------- | ------- | -------------------------------------------------------------------------- |
| `--app`    | `STRING` |         | App slug to set the trigger on (flag mode — skips the interactive prompt)  |
| `--site`   | `STRING` |         | Site slug to set the trigger on (flag mode — skips the interactive prompt) |
| `--target` | `STRING` |         | Target name (default: the resource's only target)                          |
| `--branch` | `STRING` |         | Branch or pattern to deploy on push (e.g. main, release-\*)                |
| `--remove` |          |         | Remove the trigger instead of setting one                                  |

### pier github disconnect

```bash
pier github disconnect [flags]
```

Disconnect GitHub from this project.

| Flag          | Value | Default | Description              |
| ------------- | ----- | ------- | ------------------------ |
| `-y`, `--yes` |       |         | Skip confirmation prompt |

### pier github status

```bash
pier github status
```

Show GitHub connection status.

[Global flags](/docs/cli/reference#global-flags) apply to every command.