GitHub Integration

Connect Git Canopy to GitHub to manage pull requests alongside your worktrees.

Table of contents

1. Connect to GitHub
2. View pull requests
3. Create a pull request
4. Link PRs to worktrees
   1. Manual linking
5. PR actions
6. GitHub Enterprise

---

Connect to GitHub

To use GitHub features, you need a personal access token.

1. Go to GitHub Settings > Developer settings > Personal access tokens
2. Click Generate new token (classic)
3. Select scopes: repo (full control of private repositories)
4. Copy the generated token
5. In Git Canopy, open Settings > GitHub
6. Paste your token and click Save

Your token is stored securely in the macOS Keychain.

View pull requests

The Pull Requests sidebar shows all open PRs for your repository.

• Click a PR to see its details
• Use the filter to show All, Ready for review, or Drafts only
• Click Refresh to fetch the latest PRs

Each PR row shows:

• PR number and title
• Author avatar
• Branch name
• Draft badge (if applicable)

Create a pull request

From any worktree with commits ahead of the base branch:

1. Click Create PR in the worktree lane footer
2. Select the target branch (usually main)
3. Enter a title and description (or use AI to generate them)
4. Toggle Draft if you’re not ready for review
5. Click Create

Git Canopy pushes your branch if needed and opens the new PR on GitHub.

Link PRs to worktrees

Git Canopy automatically links PRs to worktrees when the branch names match.

When a PR is linked:

• The PR status appears in the worktree lane footer
• You can click to open the PR on GitHub
• The PR state (open, merged, closed) is visible at a glance

Manual linking

If auto-matching doesn’t work:

1. Right-click the worktree lane header
2. Select Link Pull Request
3. Choose the PR from the list

PR actions

From a PR row in the sidebar:

Action	Description
Changes	View the PR diff in the compare view
Worktree	Switch to the linked worktree
Open in Worktree	Create a new worktree from the PR branch
Open on GitHub	Open the PR page in your browser

Double-click any PR to open it on GitHub.

GitHub Enterprise

For GitHub Enterprise Server:

1. Open Settings > GitHub
2. Enter your Enterprise URL (e.g., https://github.mycompany.com)
3. Add your token for the Enterprise instance

Git Canopy will use your Enterprise URL for API calls when working with repositories hosted there.