Overview

The GitHub integration ties your code to your work: link repositories to Scrambl projects, create branches and pull requests from tasks, move tasks automatically as pull requests open and merge, and track what shipped through deployments.

Who can do this

  • Owners and admins only: This is controlled by the workspace role (Owner or Admin), not by an access level, so it cannot be granted to other members.
  • After the GitHub App is installed, each member links their own GitHub account from Account settings → Integrations.
  • Personal accounts: Only the space owner and admins can do this.

Owners and admins review and change access levels in Settings → Administration → Members → Access levels.

Install the GitHub App

  1. An admin opens Settings → Administration → Integrations and clicks Connect GitHub on the GitHub card.
  2. Approve the Scrambl GitHub App installation on the GitHub account or organization that owns your repositories, choosing which repositories it can access.
  3. Back in Scrambl, the installation appears with its account name and repository count. Use Add account to connect more, Configure to adjust repository access on GitHub, and Sync after access changes.
  1. Open a project's Settings tab and find the GitHub repositories section.
  2. Choose a repository, a base branch, and a branch naming pattern, then click Add repository.
  3. Optionally set the automations: When a PR opens, move task to and When a PR merges, move task to — pick a task status for each, or leave them on Do nothing.

What shows up in Scrambl

WhereWhat you get
Task → Development sectionThe task's branches and pull requests, plus Create branch, Create PR (opens as a draft), and copy-branch-name buttons.
Task statusesTasks move automatically when their pull requests open or merge, per your repo automations.
DeploymentsWith the project's Deployments feature on, Scrambl tracks releases to your environments and detects what shipped from linked repositories.

In Account settings → Integrations, connect your personal GitHub account. When you create a branch or pull request from a task, Scrambl uses a connected identity with access to that repository, so the work is attributed to you on GitHub. You can connect more than one account.

Good to know: A repository can only be linked if the Scrambl GitHub App is installed by an owner or repository admin on the account that owns it — sharing access alone is not enough.


Troubleshooting

ProblemWhat to check
A repository is missing from the picker.Check the App's repository access under Configure on GitHub, then click Sync in Scrambl.
Tasks do not move when PRs merge.Confirm the repo's automations are set to a status, not Do nothing, and that the PR is linked to the task.
Branch creation fails for one user.That user should link a GitHub account with access to the repository in Account settings → Integrations.

Next steps