A simple CLI tool that fetches worklog updates from Jira for the past week (Monday–Sunday), groups them by author and ticket, and prints a summary table with the total time spent per ticket.
npm install jira-worklog-trackerA simple CLI tool that fetches worklog updates from Jira for the past week (Monday–Sunday), groups them by author and ticket, and prints a summary table with the total time spent per ticket.
- Node.js: Version 18 or higher.
- Jira Cloud Account: With proper permissions.
- Jira API Token: Create one at Atlassian API Tokens.
- Atlassian Domain: (e.g., your-domain.atlassian.net).
Create a .env file in the folder where you will use the commands.
``bash`
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
JIRA_DOMAIN=your-domain.atlassian.net
Shows the summary table and saves it as a CSV file:
`bash`
npx jira-worklog --week 11 --csv ./your/file/path.csv
`bash``
┌─────────┬────────────────┬─────────────┬─────────────────────────┬─────────────────────┬────────────────────────┬────────────────────────┬───────────────────────────────────┐
│ (index) │ author │ issueKey │ issueComponents │ hoursSpent │ started │ updated │ comment │
├─────────┼────────────────┼─────────────┼─────────────────────────┼─────────────────────┼────────────────────────┼────────────────────────┼───────────────────────────────────┤
│ 0 │ 'John Doe' │ 'ABC-985' │ 'Frontend' │ 0.25 │ '03/18/2025, 4:20 PM' │ '03/24/2025, 2:17 PM' │ 'Lorem ipsum dolor sit amet' │
│ 1 │ 'Jane Doe' │ 'XYZ-3239' │ '' │ 1 │ '03/26/2025, 8:55 AM' │ '03/26/2025, 9:55 AM' │ '' │
│ 2 │ 'John Doe' │ 'ABC-985' │ 'Frontend' │ 0.08333333333333333 │ '03/24/2025, 8:30 AM' │ '03/24/2025, 2:17 PM' │ 'Lorem ipsum' │
│ 3 │ 'Jane Doe' │ 'XYZ-3239' │ '' │ 1 │ '03/21/2025, 11:41 AM' │ '03/24/2025, 12:42 PM' │ '' │
└─────────┴────────────────┴─────────────┴─────────────────────────┴─────────────────────┴────────────────────────┴────────────────────────┴───────────────────────────────────┘