​
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.

Ticketing Integration Screen
  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.
Linear Integration 2

  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.

Linear Integration 3
  1. To assign tickets to Tusk in your Linear workspace, go to any issue in Linear.
Linear Integration 4
  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.
Linear Integration 5

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.
Linear Integration 6
  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”.
Linear Integration 7
  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.
Linear Integration 8

​
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.

Ticketing Integration Screen
  1. You’ll be redirected to the Atlassian platform to grant Tusk access to your Jira site.
Jira Integration 2
  1. Choose the correct Jira site under “Authorize for site” and click Accept.
Jira Integration 3
  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.
Jira Integration 4
  1. To assign tickets to Tusk in your Linear workspace, go to any issue in Jira.
Jira Integration 5
  1. Create a new label for “Tusk”.
Jira Integration 6
  1. Add the newly-created “Tusk” label to any issue to assign it to Tusk.
Jira Integration 7
  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.
Jira Integration 8
  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.
Jira Integration 9

​
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.

Ticketing Integration Screen
  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.
Notion Integration 2
  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.
Notion Integration 3
  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.

Notion Integration 4

  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.

Notion Integration 5
  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.
Notion Integration 6

  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.

​
Disconnecting Tusk

To disconnect Tusk from your project management app, go to Applications or Connections in your project management app’s Settings and—depending on the app—click “Remove access” or “Revoke access” for Tusk.

Security PracticesGitHub Workflow