GitHub
GitHub is a platform for hosting and collaborating on code repositories. Connecting GitHub to Duvo lets your assignments read and manage repositories, issues, pull requests, and more using a Personal Access Token.
Setup
Prerequisites
A GitHub account with access to the repositories your assignment needs to work with.
A Personal Access Token (PAT) generated from your GitHub account settings. Use a fine-grained token scoped to the specific repositories and permissions required.
Required Permissions
The permissions your token needs depend on what the assignment will do. Common scopes include:
Contents — Read or write files and code in repositories.
Issues — Read or manage issues and comments.
Pull requests — Read or create pull requests and reviews.
Metadata — Required for all fine-grained tokens; allows reading repository metadata.
Grant only the permissions the assignment needs. Avoid using a classic token with broad repo scope if a fine-grained token with narrower access is sufficient.
Connection Fields
Personal Access Token
A GitHub Personal Access Token with the permissions your assignment needs. Generate one at Settings → Developer settings → Personal access tokens in your GitHub account.
Third-Party Documentation
Capabilities
Read repository content — Access files, directories, branches, and commit history across your repositories.
Manage issues — Create, update, close, and search issues; add labels, assignees, and comments.
Work with pull requests — Open, review, merge, and comment on pull requests.
Search code and repositories — Find files, functions, or content across repositories using GitHub's search API.
Retrieve repository metadata — Read repository details, contributors, topics, and settings.
Key Benefits
Automate developer workflows — Triage issues, generate release notes, or open pull requests as part of a repeatable assignment.
Connect code to business processes — Link repository activity to project management, reporting, and communication workflows.
Minimal setup — A single Personal Access Token is all that is needed; no OAuth app or admin approval required.
Works Well With
Linear or Asana — Sync GitHub issues to a project management tool, or create GitHub issues automatically when new work items appear.
Slack or Microsoft Teams — Post pull request summaries or issue updates to team channels as part of a review or release workflow.
Confluence or Notion — Generate documentation or release notes from repository activity and publish them to your team wiki.
Last updated