GitHub Integration - ZeroTwo Docs

The GitHub integration connects ZeroTwo to your GitHub repositories via Model Context Protocol (MCP), enabling you to manage code, issues, pull requests, and more through natural language.

What you can do

Browse repositories

Search and explore your GitHub repositories and code

Manage issues

Create, update, and track issues and bug reports

Review pull requests

Analyze PRs, review code changes, and manage reviews

Commit and push

Make commits and push changes through AI assistance

Connecting GitHub

Open integrations

Settings → Integrations → GitHub

Authorize

Connect your GitHub account and grant permissions.Permissions requested:

Read repository contents
Create and manage issues
Create and review pull requests
Commit and push code (optional)
Manage repository settings (optional)

Select repositories

Choose which repositories to grant access to.

Confirm

GitHub integration is active via MCP.

This integration uses the Model Context Protocol for secure GitHub access. Learn more about MCP.

Using GitHub

Repository operations

"List all my GitHub repositories"
"Show recent commits in the main branch"
"Find files containing 'authentication' in the API repo"
"Display the README from my project repository"

Issue management

"Create a GitHub issue: Fix login button styling"
"Open an issue about the API timeout error with details"
"Create a bug report for the broken navigation menu"

"Find open issues assigned to me"
"Show all high-priority bugs in the project"
"List issues created this week"

"Close issue #123 with a comment explaining the fix"
"Add label 'enhancement' to issue #45"
"Assign issue #67 to alice"

Pull requests

Create PRs
Review PRs
Manage PRs

"Create a pull request from feature-branch to main"
"Open a PR for my latest commits with title 'Add user authentication'"
"Create a draft PR for the API refactoring"

"Review pull request #89 and summarize the changes"
"What files changed in PR #45?"
"Analyze the code quality in the latest PR"

"Merge pull request #78"
"Add a review comment to PR #56 about the error handling"
"Request changes on PR #34 regarding the tests"

Code operations

"Read the contents of src/auth/login.js"
"Show me the recent changes to the database schema"
"Find all TypeScript files in the components directory"
"Display the git history for the main branch"

Advanced features

Code analysis

"Analyze the code in PR #45 for potential security issues"
"Review the recent commits for code quality"
"Find TODO comments across the repository"

Branch management

"List all branches in the repository"
"Create a new branch called feature-user-profiles"
"Show differences between main and develop branches"

Repository insights

"Show repository statistics and activity"
"Who are the top contributors this month?"
"What files have changed most frequently?"

Automation

"Create issues for all TODO comments in the codebase"
"Generate a changelog from commits since last release"
"Check if CI/CD is passing for the latest commits"

Workflows

Bug triage

"Show me all unassigned bug reports"
"Analyze bug #123 and suggest potential causes"
"Assign bug #123 to the backend team with priority label"

Code review

"List all open pull requests awaiting review"
"Review PR #45 and check for security concerns"
"Add review comments and approve if tests pass"

Release preparation

"List all closed issues since last release"
"Generate release notes from recent merges"
"Create a release checklist issue"

Privacy and permissions

Access scope:

Only repositories you explicitly grant access to
Code and issues accessed only when requested
No repository data stored permanently
GitHub tokens encrypted and securely stored

Permission levels:

Read: View code, issues, and PRs
Write: Create issues and PRs, comment
Admin: Manage repository settings (optional)

Troubleshooting

Repository access denied

Solutions:

Verify you granted access to the specific repository
Check your GitHub account permissions for the repo
Reconnect integration if permissions changed
For organization repos, ensure the integration is approved

Can't create issues or PRs

Solutions:

Confirm write permissions are granted
Check repository settings allow issue creation
Verify you’re not in read-only mode
Ensure branch protection rules don’t block your action

Sync delays

Solutions:

GitHub API may have brief caching delays
Wait 1-2 minutes for recent changes to appear
Refresh the integration connection
Check GitHub’s status page for API issues

Use cases

Development workflow

"Create an issue for the new feature, then create a branch and PR for it"

Code review assistant

"Review all my open PRs and summarize what needs attention"

Project management

"Show sprint progress: how many issues are complete vs in progress?"

Documentation

"Generate API documentation from the source code comments"

Linear

Issue tracking

Notion

Documentation

MCP overview

Learn about MCP

Next steps

Custom extensions

Build custom GitHub workflows

Code interpreter

Run and test code

​What you can do

Browse repositories

Manage issues

Review pull requests

Commit and push

​Connecting GitHub

​Using GitHub

​Repository operations

​Issue management

​Pull requests

​Code operations

​Advanced features

​Code analysis

​Branch management

​Repository insights

​Automation

​Workflows

​Bug triage

​Code review

​Release preparation

​Privacy and permissions

​Troubleshooting

​Use cases

​Development workflow

​Code review assistant

​Project management

​Documentation

​Related integrations

Linear

Notion

MCP overview

​Next steps

Custom extensions

Code interpreter

What you can do

Connecting GitHub

Using GitHub

Repository operations

Issue management

Pull requests

Code operations

Advanced features

Code analysis

Branch management

Repository insights

Automation

Workflows

Bug triage

Code review

Release preparation

Privacy and permissions

Troubleshooting

Use cases

Development workflow

Code review assistant

Project management

Documentation

Related integrations

Next steps