Jira TimeReporter
Track time against Jira tickets while you work in VS Code. Jira TimeReporter detects a ticket from your Git branch or lets you choose one manually, pauses tracking when you are idle, and lets you review and submit worklogs to Jira Cloud when you are ready.
Screen recording
Jira TimeReporter stores tracked entries locally and never submits a worklog automatically. Every report is grouped by ticket and day, shown for review, and sent to Jira only after you confirm it.
Features
- Git branch detection — Infer the active Jira ticket from the current branch name, with a configurable regular expression.
- Manual controls — Start, pause, resume, stop, or switch tickets from the status bar or Command Palette.
- Idle detection — Pause the timer after a configurable period without VS Code activity. Activity can resume a timer that was paused automatically.
- Review dashboard — Filter entries by date or ticket, edit unreported entries, delete entries, and select entries for reporting.
- Favorite tickets — Save frequently used ticket keys in the dashboard. Using a favorite prefills the manual-entry form so you can review the time and note before adding it.
- Explicit reporting — Preview totals grouped by ticket and day before creating Jira worklogs. Failed reports remain unreported so they can be retried.
- End-of-day reminder — On weekdays, see a reminder with the day’s unreported total and open the dashboard to review it.
- Local persistence — Keep time entries in VS Code’s global storage between sessions.
Requirements
- VS Code
1.134.0 or newer.
- A Jira Cloud site.
- An Atlassian API token and the email address for the associated account.
- Jira permissions to view the relevant issues and add worklogs.
Getting Started
- Install the extension in VS Code.
- Open the Command Palette and run
Jira TimeReporter: Configure Jira Connection.
- Enter your Jira Cloud URL, account email, and API token. The connection is validated before the credentials are saved.
- Open a workspace with a Git repository and switch to a branch containing a Jira key, such as
PROJ-123-fix-login, or start a timer manually.
- Open
Jira TimeReporter: Open Dashboard to review tracked entries and report selected worklogs.
The API token is stored in VS Code Secret Storage. The email address and Jira base URL are stored in VS Code settings.
Extension Settings
This extension contributes the following settings:
jiraReporter.baseUrl: Base URL of your Jira Cloud site, such as https://your-domain.atlassian.net.jiraReporter.userEmail: Email address associated with your Atlassian API token.jiraReporter.idleTimeoutMinutes: Minutes without VS Code activity before a running timer pauses (default 5).jiraReporter.ticketKeyPattern: Regular expression used to extract a Jira ticket key from the current Git branch name.jiraReporter.autoStartOnBranchSwitch: Automatically start or switch the timer when the Git branch changes to one with an inferred ticket key (default true).jiraReporter.endOfDayReminderEnabled: Show the weekday end-of-day reminder (default true).jiraReporter.endOfDayReminderTime: Local weekday time for the reminder in HH:mm format (default 17:00).
Development
pnpm install
pnpm compile
Press F5 in VS Code to launch the Extension Development Host.
IntelliJ plugin module
An IntelliJ Platform plugin module is also included under intellij-plugin/. Its setup and build instructions are separate from this VS Code extension; see intellij-plugin/README.md.
Release Notes
0.0.1
Initial release of the Jira time tracking, dashboard review, and explicit worklog reporting flows.
0.0.2
- Manual ticket entry — Manually add time entries with a custom ticket key, duration, and note from the dashboard.
- Favorite tickets — Save frequently used ticket keys for quick access when adding or reviewing entries.
- Worklog history check — View previously reported worklogs in the dashboard to avoid duplicate submissions.
- End-of-day reminder — Get a weekday reminder showing your unreported total and open the dashboard for review.
- Idle detection auto-resume — Timer automatically resumes when activity is detected after idle pause.
- Duplicate prevention fix — Fix the bug that cannot record or report the same worklog period twice.
