> For the complete documentation index, see [llms.txt](https://docs.nexos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexos.ai/workspace/integrations/github.md).

# GitHub

### Overview

The GitHub integration connects nexos.ai with your GitHub account so you can search for and reference repositories, issues, pull requests, and other GitHub content directly in your workspace. It helps you summarize changes, review context, and answer questions using the same source your team works in every day.

### Setting up the integration (organization admin)

1. Open **Settings**.
2. Go to **Organization** → **Integrations**.
3. Find **GitHub** in the list.
4. Set the integration to **Active** (enabled).

<figure><img src="/files/E9JXDeA3h6QFZSQORFJA" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
After it’s enabled here, team members can connect their own GitHub accounts.
{% endhint %}

### Connecting your account&#x20;

1. Open **Settings** (select your email/profile at the bottom of the left sidebar, then **Settings**).
2. Select **My Integrations**.
3. Find **GitHub** and select **Connect**.

<figure><img src="/files/yXwLQBFWXvwYoB2XlObX" alt="" width="563"><figcaption></figcaption></figure>

4. You will be redirected to GitHub. Sign in if prompted.
5. Review the access request screen and select **Authorize** (or **Allow**) to approve.
6. Return to nexos.ai. GitHub should now show as connected in **My Integrations**.

<figure><img src="/files/BNt2lZ3iOU6CQVmFa9ZU" alt=""><figcaption></figcaption></figure>

### Use GitHub in Chat (turn it on for a conversation)

1. Open **Chat** (or an Agent chat).
2. Select the **Tools** icon.
3. Turn **GitHub** **on** to use it in that conversation.

### Use GitHub in Agents (turn it on for an agent)

1. Open **Agents** and select the agent you want to update.
2. Select the **Studio** icon (top-right), then open **Settings**.
3. Scroll to **Integrations** and turn **GitHub** **on**.
4. **Save** your changes, then test the agent by asking it to pull context (for example, “Summarize PR #123” or “List the open issues related to X”).

{% hint style="info" %}
**Alternative (quick method)**\
You can also tell the agent in plain language to add the GitHub integration (for example, “Add the GitHub integration for this agent”), and it will enable GitHub for itself automatically so you can continue without leaving the conversation.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexos.ai/workspace/integrations/github.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.