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 Indie 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 if you enable issue sync. 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 links that commit or PR to the 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 marks the task 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 two-way 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 task done.
  • Renaming the issue or task syncs the title across.
  • Assignee changes sync both ways, matched by GitHub username to 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, and tasks attached to a release link to the corresponding milestone's issues.

Useful if you plan in Frostbyte but execute through GitHub Issues and want the two to stay in step.

Disconnecting

Disconnect from GitHub settings. The app stays installed on your repo (uninstall from GitHub directly if you want it gone), but Frostbyte stops creating new links. Existing links persist, so historical references stay clickable.

What's next

Last updated