Tracemoor

Set up ticket providers

The account of a provider is configured once for the app. The Jira project that belongs to a project is set per exploration.

Connect Jira

You need a Jira Cloud site and an API token from your Atlassian account (id.atlassian.com, Security › API tokens).

  1. Choose Tracemoor › Settings… (Windows/Linux: Edit › Preferences…) and open the Jira tab.
  2. Enter the Base URL, for example https://acme.atlassian.net.
  3. Enter the Account email and the API token.
  4. Click Save.
  5. Click Test. The result appears below the buttons.

The token is stored in the operating system's keychain. Base URL and email are stored in jira-config.json next to the AI settings. Clear removes the account and the token.

Set the Jira project of an exploration

  1. Choose Analysis › Project Settings….
  2. In Jira Project Key (optional), enter the key, for example PROJ.
  3. Click Save.

The key is the default project of the Tickets view, of the ticket picker and of new issues.

Below the field, the dialog shows the query the ticket picker runs. If you saved your own JQL in the picker, it overrides the key, and the dialog says so. Reset JQL to default removes the saved JQL. When you change the key, a saved JQL that names the old key is updated. A JQL that names a different project stays as it is.

If an older version stored the project key globally, the field shows it with the note "Inherited from the old global Jira setting". Save to keep it for this exploration.

GitHub and Bitbucket

GitHub Issues and Bitbucket Issues need no separate setup. Tracemoor derives the provider from the Git remote of the repository and uses the token that the pull request integration uses:

  1. Choose Tracemoor › Settings… (Windows/Linux: Edit › Preferences…) and open the Git providers tab.
  2. Enter the token under GitHub (personal access token with repo scope) or Atlassian / Bitbucket.

Bitbucket is read-only: you can import Bitbucket issues, but not create or change them. Many Bitbucket repositories have issues switched off. The provider then reports "Bitbucket issues are disabled" instead of showing an empty list.