jtt calculate#

The net amount that came into being in a period, per issue, for the whole project or one person.

jtt calculate for a week, then one person's share

$ jtt calculate --from 2026-09-21 --to 2026-09-28
$ jtt calculate --from 2026-09-21 --to 2026-09-28 --user daniel --attribution holder

Each row is an issue whose tracked field changed in the period, or that was created in it with a value, and its net change. How jtt counts explains where each number comes from.

--user narrows it to one person. With the default --attribution was, their issues are the ones they held at some point in the period, and every change on those counts. With --attribution holder, only the changes made while they held the issue count (whose work counts).

More detail#

$ jtt calculate --from 2026-09-25 --to 2026-09-26 -v
$ jtt calculate --from 2026-09-25 --to 2026-09-26 -vv
$ jtt calculate --from 2026-09-25 --to 2026-09-26 -vvv

-v adds each issue’s current value, type, status and assignee. -vv adds the unchanged issues and a timeline of every change. -vvv adds the query sent to Jira, every API request, and the changes outside the period (levels of detail).

Time amounts can be shown in another unit for one report:

$ jtt calculate -p OPS --from 2026-09-21 --to 2026-09-28 --as days

Options#

jtt calculate [OPTIONS]

Option

Default

Description

-p, --project TEXT

Project key; defaults to the one set by init.

--from TEXT

First day, included (YYYY-MM-DD).

--to TEXT

Last bound, excluded (YYYY-MM-DD). Defaults to tomorrow, so today counts.

--period TEXT

Named period instead of –from/–to: today, yesterday, this-week, last-week, this-month, last-month, this-quarter, last-quarter, this-year, last-7-days, last-30-days.

-u, --user TEXT

Account id, ‘me’, or part of a name or email.

--attribution [was|holder]

was

With –user: ‘was’ credits every in-period change on issues they held at some point; ‘holder’ only the changes made while they held the issue.

--as [points|seconds|minutes|hours|days|weeks]

Show time amounts in another time unit.

--exclude-parents

Leave out issues that have subtasks or child issues, so work estimated on both a story and its subtasks is counted once.

--workers INTEGER

8

Parallel changelog requests. From 1 to 32.

-v, --v

More detail, repeatable. -v adds columns, -vv (–vv) adds per-issue timelines and unchanged issues, -vvv (–vvv) adds the JQL, the HTTP trace and out-of-period changes.

-h, --help

Show the command’s help and exit.