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

# GitHub

> Access GitHub repositories, issues, pull requests, and code search from Warrnagen.

## Overview

The GitHub connector lets Warrnagen interact with your GitHub repositories during incident investigations. It uses your existing GitHub integration (GitHub App or OAuth) for authentication — no additional API keys needed.

## Setup

1. Go to **Settings → Integrations** and connect your GitHub account via GitHub App or OAuth.
2. Go to **Settings → Connectors** and click **Install** on the GitHub connector.
3. Configure tool access levels as needed.
4. Bind repositories to your Warrn services.

<Info>
  The GitHub connector uses your existing GitHub integration for authentication. You must set up GitHub in **Settings → Integrations** before installing this connector.
</Info>

## Available Tools

| Tool             | Category | Description                        |
| ---------------- | -------- | ---------------------------------- |
| Get Pull Request | Read     | Get details of a pull request      |
| List Issues      | Read     | List repository issues             |
| Search Code      | Read     | Search for code in repositories    |
| Get Commit       | Read     | Get details of a specific commit   |
| Create Issue     | Write    | Create a new issue in a repository |

<Note>
  The GitHub connector supports tool discovery. Additional tools may be available beyond those listed above.
</Note>

## Service Bindings

Bind GitHub repositories to Warrn services so Warrnagen knows which repos to search during investigations.

| Field          | Description                                  | Required |
| -------------- | -------------------------------------------- | -------- |
| Repository     | GitHub repository in `org/repo` format       | Yes      |
| Default Branch | Default branch for operations (e.g., `main`) | No       |

## Type

**Contextual** — Warrnagen reads from and writes to GitHub during incident investigations and response.