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

# GitHub

> Connect GitHub to Myrmex by installing the Myrmex GitHub App on your organization.

import { Note, Steps, Step, CardGroup, Card } from '@mintlify/components';

Connect **GitHub** so Myrmex's agents can clone repositories, open pull requests, and run security audits across your organization's repositories. Myrmex connects through the **Myrmex GitHub App** — you install it on your org and choose exactly which repositories it can access. The agents operate the GitHub API live, reading and acting on demand, with nothing stored on the Myrmex side.

## What Myrmex Can Do

<CardGroup cols={2}>
  <Card title="Read repositories" icon="code-branch">
    Clone and inspect code and configuration on demand.
  </Card>

  <Card title="Open pull requests" icon="code-pull-request">
    Propose fixes and changes as pull requests — with approval.
  </Card>

  <Card title="Security audits" icon="shield-halved">
    Audit repositories for issues; feed findings into a [Security Posture](/documentation/security-posture/overview) review.
  </Card>

  <Card title="Scoped access" icon="lock">
    Access is limited to the repositories you select when installing the App.
  </Card>
</CardGroup>

## Before You Start

* A **GitHub organization** (or account) where you can install apps — you need to be an owner, or have an owner approve the request.
* The list of **repositories** Myrmex should access (all, or a subset).

## Step 1 — Install the Myrmex GitHub App

GitHub uses an App installation instead of a manually created token.

<Steps>
  <Step title="Start from Myrmex">
    In Myrmex, choose **Add Integration → GitHub**. You're redirected to GitHub.
  </Step>

  <Step title="Choose where to install">
    Select the organization (or account) to install the **Myrmex GitHub App** on.
  </Step>

  <Step title="Select repositories">
    Choose **All repositories** or **Only select repositories**, then review the requested permissions.
  </Step>

  <Step title="Install & authorize">
    Click **Install & Authorize**. GitHub sends you back to Myrmex.
  </Step>
</Steps>

<Note>
  If you're not an organization owner, GitHub records your request so an owner can approve the installation.
</Note>

## Step 2 — Add the Integration in Myrmex

Because installation happens on GitHub, Myrmex captures the connection details automatically when you return:

| Field               | Description                                                               |
| ------------------- | ------------------------------------------------------------------------- |
| **Name**            | A unique name for this GitHub connection.                                 |
| **Organization**    | The org or account login where the App was installed — set automatically. |
| **Installation ID** | The GitHub App installation reference — set automatically.                |

## Connect

Save to finish. The organization appears under **Environment → Integrations**. To change which repositories Myrmex can reach later, manage the **Myrmex GitHub App** from your GitHub organization settings. New to integrations? See the [Integrations overview](/documentation/integrations/overview).