GitHub integration

Install the GitHub App, link commits and PRs to tasks via #123, auto-close on merge, and sync issues both ways.

The GitHub integration links repository activity directly to Frostbyte tasks. Reference a task in a commit or PR with #123 and Frostbyte attaches the link automatically. Drop a close keyword in the PR description and the task auto-completes on merge.

Available on Basic and above.

Installation

From the project's GitHub settings page (gear icon → GitHub), click Connect repository. You'll be redirected to GitHub to install the Frostbyte GitHub App on the repository (or organisation) you want to connect.

The app needs read access to commits, PRs, and issues, plus write access for the issue-sync feature if you enable it. Permissions are scoped per repository.

Reference syntax

Mention a task by its short ID anywhere GitHub captures text, commit messages, PR titles, PR descriptions, issue bodies. The format is #<task-id>:

fix: handle edge case in upload validator (#A1b2c3)

The first time Frostbyte sees a reference, it creates a GitHubLink connecting that commit/PR to that task. The link shows up in the task modal under "GitHub" with a clickable URL.

Close keywords

Use any of these in a PR title or description to auto-close the linked task on merge:

  • Fixes #A1b2c3
  • Closes #A1b2c3
  • Resolves #A1b2c3

When the PR merges to its base branch, Frostbyte updates the task's status to done and records an activity entry attributed to "GitHub". Close keywords are case-insensitive.

You can disable auto-close per project in GitHub settings if you'd rather mark tasks done manually.

Issue sync

Optional bidirectional sync with GitHub issues. When enabled:

  • Creating a GitHub issue creates a Frostbyte task tagged with the configured area.
  • Closing a GitHub issue marks the corresponding Frostbyte task done.
  • Renaming the issue or task syncs the title across.
  • Assignee changes sync both ways (matched by GitHub username → Frostbyte member email).

Issue sync is opt-in per project. Configure which area new issues land in via the integration settings.

Milestone sync

Optional. When enabled, Frostbyte releases sync to GitHub milestones with the same name. Tasks attached to a release also link to the corresponding milestone's issues.

This is useful if you split work across both Frostbyte (planning) and GitHub Issues (engineering execution) and want them to stay in step.

Disconnecting

Disconnect from GitHub settings. The app remains installed on your repo (you can uninstall from GitHub directly), but Frostbyte stops creating new links. Existing GitHubLink records persist so historical references stay clickable.

Webhook delivery

The integration uses GitHub's webhook delivery. If GitHub can't reach Frostbyte (rare), webhooks retry per GitHub's standard policy. You can verify recent deliveries in your GitHub App's installation settings.

What's next

Last updated