​
Overview

We know that many product teams use project management software as their single source of truth for product development tasks.

Tusk integrates with popular project management platforms like Linear, Jira, Notion, and GitHub issues. Our app embeds directly into your current project management workflow, so you don’t have to change how you work.

You can assign a ticket to Tusk in one click. Just add one of the following labels to a ticket:

  • “Tusk” label (to create a PR)
  • “Tusk Investigator” label (Tusk will investigate the issue and provide advice on the ticket without creating a PR)

After reading this, we recommend that you read Best Practices for Using Tusk.

Before you begin, make sure that you have permissions to connect external apps to your project management app. This typically means being an admin user in your project management app.

​
Connecting to Linear

  1. Log into Tusk and go to the Settings page.

  2. Under the Integrations tab, find the Linear integration card under “Project management platform.” Click Connect.

  1. You’ll be redirected to the Linear app to grant Tusk access to your Linear workspace. Make sure to choose the correct workspace on the top left corner.

  1. Click Authorize Tusk once you have confirmed that you’re in the correct workspace.

  2. You will be redirected back to the Tusk app, where you should see a status badge saying “Connected” on the Linear integration card.

  1. To assign tickets to Tusk in your Linear workspace, go to any issue in Linear.
  1. There will be a “Tusk” label in your Linear workspace. Add the “Tusk” label to any issue to assign it to our AI agent.

If you already have a “Tusk” label created before setting up the integration, the same label will still work for assigning issues to Tusk.

  1. Tusk will comment on the issue telling you that it’s working on it. You can check the activity logs for the issue in the Tusk web app.
  1. Recommended: Integrate GitHub with your Linear workspace to link the Linear issue you assigned to Tusk with the corresponding Tusk-created PR. Tusk automatically adds the issue ID at the beginning of the PR’s title so that the PR shows up in the issue under “Links”.
  1. Once the Linear issue is linked to the Tusk-created PR, Linear automatically changes the status of the issue according to the status of the linked PR.

​
Connecting to Jira

  1. Log into Tusk and go to the Settings page.

  2. Under the Integrations tab, find the Jira integration card under “Project management platform.” Click Connect.

  1. You’ll be redirected to the Atlassian platform to grant Tusk access to your Jira site.
  1. Choose the correct Jira site under “Authorize for site” and click Accept.
  1. You’ll then be redirected back to the Tusk app, where you should now see a status badge displaying “Connected” on the Jira integration card.
  1. To assign tickets to Tusk in your Linear workspace, go to any issue in Jira.
  1. Create a new label for “Tusk”.
  1. Add the newly-created “Tusk” label to any issue to assign it to Tusk.
  1. Tusk will comment on the issue telling you that it’s working on it. The comment will be attributed to the person who originally granted Tusk access to your Jira site. You can check the activity logs for the issue in the Tusk web app.
  1. Recommended: Get the GitHub for Jira integration to link the Jira issue you assigned to Tusk with the corresponding Tusk-created PR. Tusk automatically adds the issue key at the beginning of the PR’s title so that the PR, with its latest status, shows up in the issue under the “Development” field.

​
Connecting to Notion

  1. Log into Tusk and go to the Settings page.

  2. Under the Integrations tab, find the Notion integration card under “Project management platform.” Click Connect.

  1. You’ll be redirected to Notion to grant Tusk access to your Notion workspace. Make sure to choose the correct workspace on the top right corner.
  1. Select the page that you want to grant Tusk access to. This should typically be the Tasks database where you create tasks for your engineering team. Click Allow access.
  1. You’ll then be redirected back to the Tusk app, where you should now see a status badge displaying “Connected” on the Notion integration card.

At this point, please contact support@usetusk.ai to finish setting up the Notion integration. We will respond promptly.

  1. To assign tasks to Tusk in your Notion database, go to any task in Notion.

  2. Check the “Assigned to Tusk” checkbox field to assign the task to Tusk.

  1. Tusk will comment on the task telling you that it’s working on it. You can check the activity logs for the issue in the Tusk web app.

  1. Recommended: Integrate GitHub with your Notion database to link the Notion task you assigned to Tusk with the corresponding Tusk-created PR.

  2. Once the Notion task is linked to the Tusk-created PR, Notion automatically changes the status of the task according to the status of the linked PR. Learn more about Notion’s GitHub integration.

​
FAQs

Security PolicyExample Issues