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

# GitHub

> Connect GitHub to your UltraClaw AI assistant. Ask about PRs, issues, and code across your repositories.

# GitHub

Connect GitHub to your UltraClaw AI agent and stay on top of your repositories through conversation. Ask about pull requests, check issue status, review code changes, and get project summaries — without opening GitHub.

## What You Can Do

<CardGroup cols={2}>
  <Card title="Pull Requests" icon="code-pull-request">
    *"What PRs are open on the main repo?"*
    *"Summarize the changes in PR #42"*
    *"Any PRs waiting for my review?"*
  </Card>

  <Card title="Issues" icon="circle-exclamation">
    *"How many open issues are there?"*
    *"Show me bugs labeled 'critical'"*
    *"What's the status of issue #128?"*
  </Card>

  <Card title="Code & Repos" icon="code">
    *"What repos do I have access to?"*
    *"Show me the README for the API repo"*
    *"What was the last commit on main?"*
  </Card>

  <Card title="Project Overview" icon="chart-gantt">
    *"Give me a status update on the frontend repo"*
    *"How active has the project been this week?"*
    *"Who's contributed the most this month?"*
  </Card>
</CardGroup>

## Example Questions

* *"What pull requests need my review?"*
* *"Summarize what happened in the repo this week"*
* *"Are there any failing CI checks on open PRs?"*
* *"List all open issues tagged 'enhancement'"*
* *"What did the team ship this sprint?"*
* *"Show me the diff for the latest PR"*
* *"Who opened the most issues this month?"*

## How to Connect

<Steps>
  <Step title="Open Integrations">
    Go to **Integrations** in your [dashboard](https://ultraclaw.ai/dashboard), or tell your agent *"connect my GitHub."*
  </Step>

  <Step title="Authorize with GitHub">
    You'll be redirected to GitHub's authorization page. Sign in and select the account or organization you want to connect.
  </Step>

  <Step title="Choose repositories">
    Select which repositories your agent can access — all repos or specific ones.
  </Step>

  <Step title="Start coding">
    Your agent can immediately access your selected repositories, PRs, issues, and code.
  </Step>
</Steps>

## Permissions

| Permission              | What It Does                                                 |
| ----------------------- | ------------------------------------------------------------ |
| **Read repositories**   | Your agent can view code, commits, branches, and READMEs     |
| **Read pull requests**  | Your agent can view PR details, diffs, reviews, and comments |
| **Read issues**         | Your agent can view issues, labels, milestones, and comments |
| **Repository metadata** | Your agent can see repo stats, contributors, and activity    |

<Info>
  GitHub access is **read-only** by default. Your agent can view and summarize but won't create PRs, merge code, or modify issues unless you explicitly enable write access.
</Info>

<Tip>
  Set up a [cron job](/assistant/cron-jobs) to get a daily or weekly GitHub digest — your agent can text you a summary of new PRs, issues, and activity across your repos every morning.
</Tip>

## Best For

GitHub integration is perfect for:

* **Engineering managers** — get project status updates without context-switching
* **Solo developers** — keep track of issues and PRs across multiple repos
* **Team leads** — monitor team activity and review queues from your phone
* **Open source maintainers** — stay on top of community contributions

<Info>
  Revoke access anytime from your UltraClaw dashboard or from [GitHub Settings → Applications](https://github.com/settings/applications).
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Pair GitHub with your calendar for a complete dev workflow.
  </Card>

  <Card title="All Integrations" icon="plug" href="/integrations/overview">
    See every integration available.
  </Card>
</CardGroup>