> ## Documentation Index
> Fetch the complete documentation index at: https://daily-main.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# pipecat cloud github

> pipecat cloud github connects an organization to GitHub, inspects the App installation, and lists visible repositories and branches.

The `github` command group connects a Pipecat Cloud organization to GitHub by installing the Pipecat Cloud GitHub App. Once connected, agents can be built from a repository instead of an image — see [`agent link`](/api-reference/cli/cloud/agent#link) and [`deploy --repo`](/api-reference/cli/cloud/deploy).

The connection is per organization, not per agent. One installation covers every agent in the organization.

<Card title="Deploy from GitHub" icon="github" href="/pipecat-cloud/guides/deploy-from-github">
  The full walkthrough, from connecting an account to deploying on push
</Card>

## connect

Install the Pipecat Cloud GitHub App on a GitHub account and link it to your organization.

**Usage:**

```shell theme={null}
pipecat cloud github connect [OPTIONS]
```

**Options:**

<ParamField path="--organization / -o" type="string">
  Organization to connect. If not provided, uses the current organization from
  your configuration.
</ParamField>

The command opens the GitHub App install page in your browser and then waits, polling until the installation lands — there is nothing to copy back into the terminal. GitHub redirects to the API's own setup callback, which completes the link server-side, so the flow works the same as the dashboard's.

If the browser can't be opened, the URL is printed for you to open manually. The command gives up after 15 minutes; if you completed the install after that, `github status` will show it.

Connecting an organization that's already connected is not an error — the command reports the existing installation and leaves it alone. To connect a different GitHub account, run [`github disconnect`](#disconnect) first.

## status

Show the organization's GitHub connection.

**Usage:**

```shell theme={null}
pipecat cloud github status [OPTIONS]
```

**Options:**

<ParamField path="--organization / -o" type="string">
  Organization to inspect. If not provided, uses the current organization from
  your configuration.
</ParamField>

Reports the connected GitHub account and type, the installation ID, whether the App is active or suspended, and a link to manage it on GitHub. If the organization isn't connected, it says so and points at `github connect`.

<Warning>
  A suspended installation stops deploys. `status` flags it; reinstate the App
  from GitHub to resume.
</Warning>

## disconnect

Disconnect the organization from GitHub.

**Usage:**

```shell theme={null}
pipecat cloud github disconnect [OPTIONS]
```

**Options:**

<ParamField path="--organization / -o" type="string">
  Organization to disconnect. If not provided, uses the current organization
  from your configuration.
</ParamField>

<ParamField path="--yes / -y" type="boolean" default="false">
  Skip the confirmation prompt.
</ParamField>

This removes the installation and **every repository link in the organization**, so linked agents stop auto-deploying. What is already running is not touched.

The App itself stays installed on GitHub. Uninstall it there to revoke access entirely.

## repos

List the repositories the GitHub App can access.

**Usage:**

```shell theme={null}
pipecat cloud github repos [OPTIONS]
```

**Options:**

<ParamField path="--organization / -o" type="string">
  Organization to list repositories for. If not provided, uses the current
  organization from your configuration.
</ParamField>

Shows each repository's full name, default branch, and visibility. The list reflects what you granted the App on GitHub — if a repository is missing, widen the App's repository access from GitHub rather than from here.

## branches

List branches for a repository.

**Usage:**

```shell theme={null}
pipecat cloud github branches [ARGS] [OPTIONS]
```

**Arguments:**

<ParamField path="repo" type="string" required>
  Repository as `owner/repo`. Any other form is rejected before the request is
  made.
</ParamField>

**Options:**

<ParamField path="--query / -q" type="string">
  Prefix to search for. Runs a server-side search, which reaches branches past
  the plain list's cap — use it on repositories with many branches.
</ParamField>

<ParamField path="--organization / -o" type="string">
  Organization to list branches for. If not provided, uses the current
  organization from your configuration.
</ParamField>

```shell theme={null}
pipecat cloud github branches my-org/my-bot --query release/
```

## More Information

<CardGroup cols={2}>
  <Card title="Link an agent" icon="link" href="/api-reference/cli/cloud/agent#link">
    Point an existing agent at a repository and branch
  </Card>

  <Card title="Create from a repository" icon="rocket" href="/api-reference/cli/cloud/deploy">
    `deploy --repo` builds a new agent from GitHub
  </Card>
</CardGroup>