Skip to main content
Skip table of contents

JetBrains Extension for Tempo Timesheets

Use the Tempo Time Tracking plugin with JetBrains to log your time faster in Jira from suggestions provided in Tempo Timesheets. Tempo's integration with JetBrains automatically detects the time you spend on coding activities and changes made to files in Git repositories. 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). This results in better suggestions for logging time in Tempo Timesheets.

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

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.

  1. Select Apps in the Tempo sidebar.

  2. In the JetBrains Plugin tile, click Install. You are redirected to the JetBrains Plugin Marketplace to download the plugin.

  3. Click Get, select the plugin version, and then click Download.

  4. Follow the onscreen directions to install the Tempo Time Tracking plugin in JetBrains.

  5. After you've installed the Tempo plugin, restart your IDE.

    JetBrains install.jpg

    A Tempo: token missing notification appears to remind you to set your Tempo API token.

    jetbrains needs a Tempo API token.jpg

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

    Refer to Using REST API integrations.

    Get API token for JetBrains.jpg

  7. Copy the token and open JetBrains. Click Configure in the prompt and paste the token.

    JetBrains_add_token.jpg

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

Extension Settings

The Tempo settings are included as an item in the Preferences dialog of the JetBrains IDE.

If you need information about the tracked repositories or the status of events sent to the Tempo API, navigate to Preferences.

JetBrains_Preferences_-_Tempo.jpg

Enable Debug mode to view event logs.

jetBrains_debug_mode.png
JetBrains_Debug.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.