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

# Ask Oqo in GitHub (CI/CD)

> Ask about your Oqoqo projects in GitHub issues and pull requests. Ask Oqo answers in the thread, with the repository's code and its project.

> [!NOTE]
>
> Ask Oqo in GitHub is in private beta. Email [support@oqoqo.ai](mailto:support@oqoqo.ai) to enable it for your organization.

Use [Ask Oqo](https://docs.oqoqo.ai/operate/ask-oqo.md) on GitHub through the **Oqoqo AI** GitHub app. Mention **@oqoqo-ai** in a comment on an issue, a pull request, or a line of a review, and it answers in that thread with the repository's code and the Oqoqo project that the repository uses.

## Connect a GitHub account

Connect each GitHub account once. Its repositories need no step of their own.

**1. Open the project your repositories are about**

The account takes the project you have open as its default project. You can change it later.

**2. Open Ask Oqo in GitHub (CI/CD)**

Select **Ask Oqo in GitHub (CI/CD)** under **Automate** in the sidebar or on **Home**, or **GitHub** in the Ask Oqo header. It opens the tab of the same name in **Organization settings**. If the tab shows **Connect GitHub**, select it, connect GitHub on **Profile → Integrations**, and return.

**3. Add your GitHub account**

Select **Add GitHub account**. GitHub asks which account gets the Oqoqo AI app and which repositories the app can read. In a GitHub organization, an owner may have to approve the install.

GitHub returns you to the tab, and the account shows **Connected** with its **Default project**. Ask Oqo now answers in every repository the app can read, including repositories you add on GitHub later:

![Ask Oqo in GitHub (CI/CD) tab: a connected account with its Default project, and two repositories, one on the default project and one set to No project.](https://mintcdn.com/oqoqo/IQAlW1koq7TOkotr/images/screenshots/ask-github-settings-light.png?fit=max\&auto=format\&n=IQAlW1koq7TOkotr\&q=85\&s=9d03e0b81c27633656e65e23ad81b68a)

* **The app was already installed on the account:** the account shows **Not connected**. Select **Connect** on its row.
* **Each person links their own GitHub account:** everyone who wants to ask must connect GitHub on **Profile → Integrations** and open the **Ask Oqo in GitHub (CI/CD)** tab once, so that Oqoqo knows which GitHub account is theirs.

## Ask on GitHub

Mention **@oqoqo-ai** in a new comment and ask your question. Ask Oqo reacts with eyes when it starts, then replies in the thread.

```text theme={null}
@oqoqo-ai which experiments ran last week?
```

```text theme={null}
@oqoqo-ai what were the top frictions in the latest experiment?
```

```text theme={null}
@oqoqo-ai does this pull request fix any frictions from the latest experiment?
```

| Where | What Ask Oqo has |
| - | - |
| **Issue** | The repository at its default branch |
| **Pull request** | The pull request's changes and its code |
| **Review comment on a line** | The pull request's changes and its code, in that review thread |

* **Mention it every time.** Ask Oqo reads only comments that mention it. A follow-up comment with a mention continues the same conversation.
* **Each comment runs as its author.** Ask Oqo answers only people whose GitHub account is linked to an Oqoqo account in your organization, each with their own access.
* **Approvals are comments.** Ask Oqo asks before the same [actions as in the dashboard](https://docs.oqoqo.ai/operate/ask-oqo.md#what-ask-oqo-can-do). It posts the question as a comment, and only the person who asked can answer, in a reply that mentions **@oqoqo-ai**.
* **A reply is a comment.** Everyone who can open the repository can read it, and in a public repository that is everyone.
* **It reads one repository.** Ask Oqo reads the code of the repository the comment is in, and it can't change the repository.

## Change projects and accounts

Manage everything on **Organization settings → Ask Oqo in GitHub (CI/CD)**. Each account and repository name opens its page on GitHub. You install the app and choose its repositories on GitHub; Oqoqo keeps each account's default project and what you chose for a repository.

| To | Do this |
| - | - |
| Use another project for one repository | Select it in the repository's **Project** list. It overrides the account's default project. |
| Turn Ask Oqo off in one repository | Select **No project** in the repository's **Project** list. |
| Change the project of every repository on the default | Select another **Default project** on the account's row. **No default project** leaves only the repositories that have their own project. |
| Change which repositories the app can read | Select **Choose repositories on GitHub** above the account's repositories. |
| Stop using a GitHub account | Select **Disconnect** in the account's **⋯** menu. Its default project and its repositories' projects are removed, and the app stays installed on GitHub. |
| Remove the app | Uninstall it in the account's settings on GitHub. |

A thread follows its repository: after a repository gets another project, the next comment in an older thread is answered for the new project.

## From the CLI and the plugin

| Task | CLI | Plugin (MCP) |
| - | - | - |
| List accounts and repositories | [`oqoqo github repos list`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-github-repos-list) | [`list_github_repositories`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#list_github_repositories) |
| Connect an account or set its default project | [`oqoqo github accounts connect`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-github-accounts-connect), [`default-project`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-github-accounts-default-project) | [`manage_github_repository`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#manage_github_repository) |
| Choose or remove a repository's project | [`oqoqo github repos link`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-github-repos-link), [`unlink`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-github-repos-unlink) | [`manage_github_repository`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#manage_github_repository) |
| Disconnect an account | [`oqoqo github accounts disconnect`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-github-accounts-disconnect) | [`disconnect_github_account`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#disconnect_github_account) |

Installing the app, choosing its repositories, and connecting GitHub to your profile stay in the browser. The list returns the links to those pages and the name to mention.

## Troubleshooting

| What you see | What to do |
| - | - |
| "This repository doesn't have an Oqoqo project yet." | The account has no default project, or the repository is set to **No project**. Select a project for it on the **Ask Oqo in GitHub (CI/CD)** tab, then ask again. |
| "I don't recognize your GitHub account yet." | Connect GitHub on **Profile → Integrations**, open the **Ask Oqo in GitHub (CI/CD)** tab once, then ask again. Ask Oqo sends this reply only in private repositories. |
| No reaction and no reply | Check that the comment mentions **@oqoqo-ai**, that the repository's GitHub account shows **Connected**, and that the app can read the repository (**Choose repositories on GitHub**). In a public repository, also check that your GitHub account is linked. |

## Next steps

> [card] [Ask Oqo](https://docs.oqoqo.ai/operate/ask-oqo.md)
>
> Explore Ask Oqo capabilities, approvals, and models.

> [card] [Ask Oqo in Slack](https://docs.oqoqo.ai/operate/ask-oqo-in-slack.md)
>
> Ask from Slack direct messages and channels.


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