# noust github

This server's GitHub App: private repositories, push and pull request events.

```bash
noust github [OPTIONS] COMMAND [ARGS]...
```

Subcommands: [`host`](#noust-github-host), [`installations`](#noust-github-installations), [`remove`](#noust-github-remove), [`repos`](#noust-github-repos), [`setup`](#noust-github-setup), [`status`](#noust-github-status)

## noust github host

The GitHub the App talks to: github.com, or a GitHub Enterprise host.

```bash
noust github host [OPTIONS] COMMAND [ARGS]...
```

Subcommands: [`reset`](#noust-github-host-reset), [`set`](#noust-github-host-set), [`show`](#noust-github-host-show)

## noust github host reset

Go back to github.com.

```bash
noust github host reset [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--force` | Change it although the server has an App. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github host set

Point the App at a GitHub Enterprise Server or Cloud (data residency) host.

```bash
noust github host set [OPTIONS] HOST
```

Arguments: `host`

| Option | What it does | Default |
|---|---|---|
| `--force` | Change it although the server has an App. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github host show

Show which GitHub this server's App talks to.

```bash
noust github host show [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--json` | Print the host as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github installations

List the accounts the App is installed on.

```bash
noust github installations [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--sync` | Ask GitHub first and record what it lists. |  |
| `--json` | Print the installations as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github remove

Forget the App's credentials and installations on this server.

```bash
noust github remove [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `-y`, `--yes` | Do not ask for confirmation. |  |
| `--json` | Print the outcome as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github repos

List the repositories the App can deploy, with the source to deploy each as.

```bash
noust github repos [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--json` | Print the repositories as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github setup

Explain how the App is created; with --print-manifest, show its manifest.

```bash
noust github setup [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--print-manifest` | Print the manifest the console would post to GitHub. |  |
| `--origin` | The console's address as your browser reaches it. | `http://localhost:8080` |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust github status

Show the App, where it is installed, and where GitHub delivers its events.

```bash
noust github status [OPTIONS]
```

| Option | What it does | Default |
|---|---|---|
| `--json` | Print the status as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |