Skip to main content

​
Overview

Gitar reads Jira issues, updates their status, and comments on them from your pull requests, so a ticket reflects what the code did without anyone retyping it.

Auto-Link Issues

Detect and link Jira issues even when ticket references are missing.

Post Merge Summaries

Add implementation summaries to linked issues when PRs merge.

Suggest Reviewers

Suggest reviewers based on Jira watchers and stakeholders.

Create Follow-ups

Create follow-up issues for unresolved comments and new TODOs.

​
Authentication Methods

How you connect depends on where Jira runs.

​
Connect Jira Cloud with the Gitar Atlassian app

A site admin installs the app once. Gitar reads and writes as the app, so no token of yours is stored and nothing expires when someone leaves.
1

Install the app on your Atlassian site

Ask Gitar support for your organization’s install link, open it as a site admin, and install the app.
2

Open the Gitar page in Jira

The app adds a Gitar page under your Jira administration settings. Open it and click to generate a connect code, which looks like GITAR-XXXX-XXXX-XXXX-XXXX and lasts 15 minutes.
3

Paste the code into Gitar

  1. Go to your organization’s Settings in the Gitar dashboard
  2. Open the Integrations section
  3. Find the Jira card under Ticketing & Documentation and click Connect
  4. Choose Gitar Atlassian app and paste the code

​
Connect Jira Data Center or Server with a token

1

Generate a token

Create a personal access token in your Jira instance under Profile > Personal Access Tokens, name it Gitar Integration, and copy it. Jira shows it once.
2

Enter PAT Credentials

Return to the Gitar Jira integration dialog.
  1. Choose Personal Access Tokens
  2. Enter your Jira Instance URL, for example https://jira.your-company.com
  3. Enter your Jira User Email
  4. Paste your Personal Access Token
3

Save Configuration

  1. Review your credentials
  2. Click Save to complete the connection
4

Connection Successful

Your Jira PAT integration is now active and ready to use.

​
Enable Jira Features

Once your Jira integration is connected, enable the Jira rules on each repository that should use them:
  1. Go to your repository in the Gitar dashboard
  2. Open Rules in the sidebar
  3. Find the Jira rules and toggle them on

​
Using Jira in Rules

Ask for Jira by name in a custom rule and the agent picks it up. See Rules for how to write one.

​
Frequently Asked Questions

​
What permissions does Gitar need?

Read issues and user information, and write to Jira, meaning create and update issues, add comments, and transition them.

​
Why did I see an Atlassian authorization screen instead of a code?

Signed in to Gitar as an Atlassian site admin, the card can prove you own the site directly instead of asking for a code. It confirms ownership only. Gitar keeps no token from it, and reads still run through the installed app.

​
Does anything expire?

Not on Jira Cloud. The Gitar Atlassian app holds no token of yours, so there is nothing to rotate and a departing admin does not break the connection.

​
What happens if my Data Center token expires?

Gitar’s Jira calls start failing. Generate a new token in Jira, then update it under Settings > Integrations > Jira > Configure.

​
Can I use Jira alongside Linear, Plane, or YouTrack?

Connect as many ticket trackers as you use. A bare key like PROJ-123 looks identical across all four, so Gitar attributes it by precedence: Jira first, then Linear, then Plane, then YouTrack. An org running two trackers never resolves a bare key to the second one.