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

# GitHub

> Connect Missio with GitHub to automate repository management and development workflows

## Overview

The GitHub integration enables both the Missio Agent and Co-Pilot to manage issues, pull requests, and repository activities while maintaining context from conversations across all your integrated platforms.

## Available Tools

### Agent Capabilities

<Info>
  The Missio Agent can autonomously monitor and manage GitHub activities based
  on configured rules and detected patterns.
</Info>

**Repository Management:**

* Create/update issues
* Manage pull requests
* Review code changes
* Handle repository events
* Manage labels and milestones
* Track branch status
* Monitor workflows
* Manage discussions

**Automation Rules:**

* Auto-create issues from conversations
* Auto-label PRs and issues
* Auto-assign reviewers
* Auto-link related items
* Sync status updates
* Create release notes
* Schedule PR reviews
* Monitor CI/CD status

### Co-Pilot Commands

<Info>
  Use natural language commands in the Co-Pilot to manage your GitHub
  repositories directly from Missio.
</Info>

**GitHub Actions:**

# Issue Management

"Create a new issue for the API bug"
"Label all security-related issues as high priority"
"Assign this bug to the backend team"

# Pull Request Management

"Create PR from feature/auth branch"
"Request review from @techteam"
"Show all PRs waiting for review"

# Repository Actions

"Create a new release for v2.0.0"
"Show recent workflow failures"
"List open issues in the API repository"

# Cross-Platform Actions

"Create an issue from this Slack thread"
"Schedule a PR review meeting"
"Link this Linear ticket to the GitHub issue"

## Sample Workflows

### 1. Issue Management

When: Bug report comes in through Slack/Discord
Agent will:

1. Create GitHub issue with details
2. Apply relevant labels
3. Assign to appropriate team
4. Link conversation context
5. Create Linear ticket if needed

### 2. Pull Request Workflow

When: New PR is created
Agent will:

1. Add required reviewers
2. Apply standard labels
3. Run validation checks
4. Update linked issues
5. Notify relevant team members

### 3. Release Management

When: Using Co-Pilot
You can say:
"Prepare release by:

* Gathering merged PRs
* Creating release notes
* Updating version numbers
* Notifying stakeholders"

## Setup Instructions

1. Go to Missio Settings → Integrations
2. Select "GitHub" from development providers
3. Complete OAuth authentication
4. Configure Agent rules and Co-Pilot preferences

<Note>
  The GitHub integration requires specific repository permissions to manage
  issues, PRs, and other actions. Review the permissions carefully during setup.
</Note>

## Best Practices

* Use clear issue/PR templates
* Configure branch protection rules
* Maintain consistent labeling
* Set up automated workflows
* Regular repository maintenance
* Document contribution guidelines

## Limitations

* API rate limits apply
* Some features require GitHub Team/Enterprise plans
* Workflow permissions follow repository settings
* Action runner limitations may apply
* Branch protection constraints

Need help? Contact our support team or visit our [community forum](https://discord.gg/9CwnRH2Bgt).