Use GitHub with Twist


GitHub is a code hosting platform used for version control and collaboration, which helps you and your collaborators work together on projects from anywhere.

Adding the GitHub integration to Twist will let you and your team turn Twist posts (both from messages and threads) into new GitHub issues, with that post’s content pre-populated in the issue description.

Setting up the integration

  1. Log in to your Twist account in a browser.
  2. Open the main menu by clicking your Twist team name in the top-left corner of Twist.
  3. In the drop-down menu, select Settings & Members.
  4. Click Integrations.
  5. Select Browse.
  6. Find GitHub and click Add.
  7. Follow the instructions on the screen to complete the setup. 
  8. (Optional) By default, the integration will only be installed for you. If you are an admin, you have the option to install the integration for your whole team. You can do this by clicking Change and then selecting your team.

Note

When authenticating the extension, there may be repositories that you won’t be able to access immediately, such as an organization's repos. Click Request to request permission from the organization owners. Once the permission is given, you’ll be able to use the extension with those repos.

Using the integration

After you’ve set up the integration, you can use thread comments and messages to create new GitHub issues. Here’s how:

  1. Click the three dot icon next to a thread comment or a message. 
  2. Click Add GitHub issue.
  3. If you have not yet authenticated with GitHub, you will be prompted to do so in a new window. 
  4. A new window will open. Type the repository name (e.g., “org/repository” or “user/repository”) and fill in the details of the new issue. 
  5. Click Create issue.

Note

If you've added an issue to a repository before, that repository will appear in the dropdown menu (which will show you the previous 5 repositories used). If you have not added an issue to this repository in the past, you'll need to manually type in the repository name. 

 

This also applies to the assignees, any previously used assignees (up to 5) will be displayed in the dropdown.

FAQ

How can I remove the integration?

If you no longer want to use GitHub with Twist, please follow the instructions in this article to remove the integration.

Why am I unable to install this integration?

If you're having problems installing this integration, it may be because your admin has disabled this option in your team's security settings.