Superthread allows you to link pull requests to cards and automatically change the status of a card when the pull request changes. This enables your team to:
  • See the status of a PR from within a Card.
  • Configure Superthread to automatically move a Card to a new status when PRs are created or merged.

​
Connect your GitHub account

This only needs to be done once by any member of your team. Just head to Settings > Integrations > Github Currently you can only connect one GitHub account to a workspace. Once connected, you can use the ‘Copy git branch name’ button in the header of the card. This copies a suggested branch name that includes the card title and card-ID to your clipboard. If you include the card-ID in your branch name, Superthread will automatically create a link between the card and the branch. You can also include the card-ID in the PR title:
  • Branch name (e.g. “ST-123” or “username/ST-123”)
  • Pull request title (e.g. “GitHub Workflow ST-123”)

​
Pull request automation

When a card is linked to a pull request, Superthread can automatically move the card to the appropriate status in your Board when the pull request changes. This is fully configurable on a per Board basis, across all your Boards and Spaces, meaning you have complete flexibility in how you set up the integration. Simply head to Settings > Spaces > Boards to configure PR automation for each board.

​
Branch-specific automation

You can add automation rules that target specific branches. These will override the default automation rules you have setup. For example, if a PR is merged to staging, you can move the card to In QA status. However, if a PR is merged to main, then move the card to Deployed status.

​
Viewing PR Status

Once linked, you can see the PR status directly from the card:
  • PR status (open, merged, closed)
  • Branch name
  • Link to the PR on GitHub
  • Latest PR activity

​
Need help?

If you encounter any issues with the GitHub integration:
  • Check that your GitHub account is properly connected
  • Verify that the card-ID is correctly included in branch names or PR titles
  • Review your automation rules in the board settings
  • Get in touch with our support team