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

# GitHub

Connect Sola and GitHub to get security insights

## Overview

The GitHub connector brings Sola AI into your GitHub organization, allowing it to create and comment on issues, and read repository, team, and security alert data directly from conversations.

The GitHub connector helps close the loop on findings surfaced elsewhere in Sola by turning them into tracked work in the repositories where your teams already operate.

With the GitHub integration, you can:

* Search, create, update, and comment on GitHub issues directly from Sola AI conversations.
* List and create pull requests, including committing files to a new branch or pushing additional commits to an existing one, directly from Sola AI conversations.
* Track code scanning, Dependabot, secret scanning, and security advisory findings across your repositories.
* Monitor organization members, teams, team membership, and repository collaborator access.
* Review repository metadata, file contents, the file tree, branches, commits, tags, and code search for context during an investigation.

{% hint style="warning" %}
**Sola can only perform the actions you approve.**

Connectors require explicit permission to access or act on external systems. Permissions are securely managed at the workspace, project, and chat level to ensure control at every step.
{% endhint %}

## Set up GitHub connector integration with Sola

{% columns %}
{% column width="75%" %}
Go to ***Integrations*** > [***Connectors***](https://app.sola.security/integrations/connectors) > click ***New connector*** > select ***GitHub***.

*The Sola wizard will take you through the steps.*
{% endcolumn %}

{% column width="25%" %} <a href="https://app.sola.security/integrations/connectors?connector=github" class="button primary">Set up GitHub -></a>

{% endcolumn %}
{% endcolumns %}

### Connect GitHub to Sola

To connect GitHub, you'll need a GitHub account with organization owner permissions or admin access to the repositories you want to connect.

{% tabs %}
{% tab title="Github App" %}
Recommended for secure, production use.

This method leverages a GitHub App to grant Sola temporary, permissioned access to your GitHub resources, at either the repository or organization level, based on your choice. It minimizes risks associated with personal tokens and long-term credentials by enforcing strict, scoped access.

Install Sola’s GitHub App to securely and easily grant access to your organization’s GitHub data.
{% endtab %}
{% endtabs %}

## Available actions with the GitHub connector

* **Manage Issues** - List, search, create, update, and comment on GitHub issues.
* **Manage Pull Requests** - List and fetch pull requests, create new pull requests with file commits to a new branch, and push additional commits to an existing pull request.
* **Read Security Alerts** - Retrieve code scanning, Dependabot, secret scanning, and security advisory findings for a repository.
* **Read Repository Data** - Access repository metadata, file contents, the file tree, branches, commits, tags, and code or commit search.
* **Read Organization Data** - Retrieve organization members, teams, team membership, and repository collaborators.


---

# 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.sola.security/integrations/connectors/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.