Skip to content
/ tt Public

⏱️ simple time tracker app on the command-line

License

Notifications You must be signed in to change notification settings

gaborbata/tt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tt tests Gem Version

⏱️ simple time tracker app on the command-line

Usage:
  tt [command]              execute the given command
  tt [activity] [message]   start tracking time of a given activity, with an optional message

Commands:
  rep|report                show report for the last 7 days, grouped by activity
  ls|list [filter]          list the last 20 entries
  break   [message]         start break activity
  stop    [message]         stop tracking time of the current activity
  edit                      edit entries in text editor
  active                    list active jira issues
  upload  [from day offset] upload worklog for jira issues (default offset = 0, which means only today)

To work with Jira, please provide JIRA_API_USER, JIRA_API_TOKEN, JIRA_API_HOST environment variables.
To create an API token please visit: https://id.atlassian.com/manage-profile/security/api-tokens

An activity is considered a Jira ticket if matches the /\w+-\d+/ pattern.

time-tracker.csv file stores time entries which is saved into the $HOME folder of the current user.

How to install

gem install time-tracker-cli

Requirements

  • Ruby 2.6 or newer, or JRuby
  • nano - for editing entries in text editor

Most of the console applications support ANSI/VT100 escape sequences by default, however you might need to enable that in order to have proper colorized output.