Skip to content

CLI tool to log worked hours using Jira + Tempo plugin

License

Notifications You must be signed in to change notification settings

FcoManueel/tempo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tempo logger

This is a tool to help with the repetitive task of opening Jira issues and using the Tempo plugin to log worked hours every day.

It was designed under the assumption that you want to manage your logs keeping a 1-1 relationship between worked days and Jira tickets.

Installation

go get github.com/FcoManueel/tempo 

Usage

The tempo tool has two commands, tempo see and tempo log, explained below. All date formats are YYYY/MM/DD. For usage help just type tempo.

Notes:
The following examples implicitly use the environment variables $JIRA_URL, $JIRA_PROJECT_KEY,$JIRA_USERNAME,$JIRA_TOKEN, and$TEMPO_TOKEN.
For information on how to provide that data through flags run tempo help and look for "global options".
For information on how to generate the required tokens go to the last section of this readme.

Log

To log 8-hours of work for a given date:

tempo log 2021/01/31

You can send log a second parameter indicating the amount of hours to log :

tempo log 2021/01/31 4

You can use today instead of today's date, and week to refer to this week's Mon—Fri.

tempo log today
tempo log week 

Lastly, you can use +#, -# suffixes for relative dates.

tempo log today-1   // yesterday
tempo log today+1   // tomorrow
tempo log week-3    // three week ago

Example: Log 4 hours of work for each workday of last week

tempo log week-1 4

See

If you want to inspect a particular date for entries created by this tool:

tempo see 2021/02/08

Syntactic sugar supported by log is supported by this command as well:

tempo see week-1
> https://foo.atlassian.net/browse/BAR-365  8h  2021/02/08 Monday
> https://foo.atlassian.net/browse/BAR-366  8h  2021/02/09 Tuesday
> https://foo.atlassian.net/browse/BAR-367  8h  2021/02/10 Wednesday
> https://foo.atlassian.net/browse/BAR-368  8h  2021/02/11 Thursday
> https://foo.atlassian.net/browse/BAR-369  8h  2021/02/12 Friday

Useful info

How to create a Jira Token

How to create a Tempo Token

  • Go to the Tempo settings on your Jira domain (e.g. https://<company>.atlassian.net/plugins/servlet/ac/io.tempo.jira/tempo-app#!/configuration/api-integration ). If you have trouble finding them check the Tempo docs for more info).
  • Click + New Token and assign it a name and durability.
    • Choose your token privileges. Minimum required is Worklogs scope.
  • Store the token locally before closing the modal.

About

CLI tool to log worked hours using Jira + Tempo plugin

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages