Installing IDE Extensions

If you use JetBrains or VS Code, you must install the IDE extensions so Capacity Insights can understand where you spend your time.

For best results, add the issue key to the branch or the commit message.

JetBrains

When you save a file in JetBrains, commit, or checkout, the extension posts an event to the Tempo API that contains the current branch name, timestamp, and a commit message (if available).

Before You Begin

Install IntelliJ version 2020.3 or later.
This plugin requires Tempo Timesheets on Jira Cloud.

Setting Up the Time Tracking Plugin

Install the Tempo Time Tracking plugin from the JetBrains Plugin Marketplace. Once you've installed the Tempo Time Tracking plugin, you must use an API token to authenticate Tempo in JetBrains.

Select Apps in the Tempo sidebar.
In the JetBrains Plugin tile, click Install. You are redirected to the JetBrains Plugin Marketplace to download the plugin.
Click Get, select the plugin version, and then click Download.
Follow the onscreen directions to install the Tempo Time Tracking plugin in JetBrains.
After you've installed the Tempo plugin, restart your IDE.
A Tempo: token missing notification appears to remind you to set your Tempo API token.
In your Jira instance, navigate to Tempo > Settings > API Integration, and click New Token. This token can be either for full access or custom access.
To create a custom access token, the token must have the Produce activities scope at a minimum. Click Confirm to create the token.
Copy the token and open JetBrains. Click Configure in the prompt and paste the token.
Click Test to ensure the API token is set up correctly, and then restart JetBrains.

Now when you open a workspace within a git repository, the Tempo extension gives you the option to either Track, Ignore or Postpone all activity within the git repository. Repositories that have been tracked send time record suggestions to My Work in Tempo.

If Postponed is selected, you receive a reminder the next time you open a project for this repository. You can then manually configure it in Preferences > Other Settings >Tempo.

VS Code

When you save a file in VS Code or commit/checkout in git, the extension will post an event to the Tempo API containing the current branch name, timestamp, and a commit message (if there's a commit). A status indicator at the bottom bar in VSCode shows you how much time you have spent on various development tasks.

Setting Up the Time Tracking Extension

Make sure you have VS Code version 1.46 or higher. Download the extension from the marketplace or install from the Extensions View in VS Code.
Reload VS Code after the installation.
A notification appears asking you to authenticate the extension with Tempo. Click Authorize now.
Click Open to go to the go to the Atlassian authorization page. Click the Authorize for drop-down menu to open the list of sites (instances) you can authenticate with VS Code.
Select the site you want to authorize. Click Accept and then open VS Code to complete the authorization and you're all set to go. (If you have multiple active instances that can be matched with your token, you may be prompted to do this twice.)
When you open a workspace within a git repository, the extension will give you the option to either Track or Ignore all activity within the git repository.