Skip to main content

​
Overview

Connect GitHub to create branches, edit files, manage issues & sub-issues, review & merge pull requests, run workflows, monitor security alerts, handle discussions, gists, releases, tags, and search across code and org data.

​
1. Connect (OAuth)

1

Open Integrations

Settings → Integrations → GitHub.
2

Authenticate

Click Connect GitHub and approve scopes (repo, workflow, org).
3

Select Scope

Choose orgs / repos to expose (start small).
4

Test

Ask: “List my open pull requests.”
Revoke anytime in GitHub → Settings → Applications.

​
2. Capabilities

Repos & Branches

Create/list repos, fork, create/list branches.

Files & Content

View, create, update, delete files; push multiple changes.

Issues & Sub-Issues

Search/create/update issues, comments, manage sub-issues, assign Copilot.

Pull Requests & Reviews

Create/update PRs, diffs, files, status, request/submit reviews, merge, update branch.

Discussions

List/create/fetch discussions, categories, comments.

Gists

List, create, update personal gists.

Notifications

List, detail, mark read, dismiss, manage subscriptions.

CI / Workflows

List workflows/runs/jobs, run/rerun/cancel, artifacts, logs, usage.

Security & Quality

Code scanning, secret scanning, Dependabot, advisories (repo/org/global).

Releases & Tags

List releases/tags, latest release, release by tag.

Search & Discovery

Search code, issues, PRs, repos, users, orgs.

Teams & Org

List teams, members, get profile (me).

Advanced

Request Copilot review, structured automation actions.
Write actions can prompt for confirmation before execution.

​
3. Quick Commands

List my open pull requests
Create branch feature/refactor-auth from main
Create issue: Improve onboarding flow (labels: enhancement, ux)
Add comment to issue 42: Clarify acceptance criteria
Request review on PR 87
Show diff for PR 87
Merge PR 87 after checks pass
Search code for "retryPolicy" in backend repo
Run workflow "Deploy" on main
List failed workflow runs today
List Dependabot alerts in api-service
Describe code scanning alerts for security-service
List discussions in platform repo
Create discussion: Release Planning Q1
List my notifications
Mark all notifications read
Push updated README and CHANGELOG to main

​
4. Common Patterns

  • Issues
  • Pull Requests
  • Security
  • Workflows
  • Files & Branches
Create issue: Payment timeout bug (labels: bug, high-priority)
Add sub-issue under issue 55: Investigate gateway logs
Reprioritize sub-issue 55.2 to High
Search issues: label=security state=open

​
5. Best Practices

GoalTip
Clean PRsSmall focused branches + clear titles
Fast reviewsProvide context & tests before requesting
Issue clarityUse labels + consistent templates
Security hygieneTriage new alerts daily
Workflow efficiencyRetry only failed jobs, not entire runs
Branch disciplineDelete merged branches regularly
Noise reductionDismiss obsolete notifications in bulk
TraceabilityLink issues, PRs, discussions, releases

​
6. Troubleshooting

IssueFix
Missing repoExpand scope or verify access rights
Permission deniedReconnect with required scopes / org approval
PR merge blockedCheck required checks / branch protection
File update failedVerify branch exists & latest commit base
Workflow run not foundConfirm workflow file path & branch
Empty searchBroaden keywords or remove filters
Security alerts missingEnsure security scanning enabled in repo
Notifications staleRefresh after marking read

​
7. Security

  • OAuth tokens only; revocable anytime
  • Scoped access (org/repo granularity)
  • No persistent code storage; processed transiently
  • Confirmation prompts for destructive actions (delete, merge, cancel)

​
8. Sample Flow

Search issues label=bug in payments
Create branch fix/payment-retry from main
Get file contents src/payments/retry.ts
Update file with improved exponential backoff
Create pull request fix/payment-retry → main title "Fix payment retry logic"
Request review on PR
Run workflow Tests
Merge PR after checks pass
List Dependabot alerts (ensure none new)
GitHub connected. You can now manage repos, issues, PRs, workflows, security, and code via chat.
Need deeper analytics? Combine GitHub with project, task, or KPI tools in a workflow.