A tool for timekeeping and tracking. For now only for Redmine.

The configuration file need to be named .act.yaml and placed on the user's home directory.

On Windows it is the %userprofile%, on any Unix like it is the ~ path.

An example of configuration:

redmine:
  url: 192.168.3.41
  access_key: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

default:
  activity_id: 24

activities:
  dev: 24
  cr: 25

git:
  path: /usr/bin/git
  regex: '[0-9]*'

editor: vim

The commands to manage the tracking are start, stop, status, push and rm. A very simple workflow example:

act start

2017/10/19 20:17:01 Activity 1234 started.

act status

        Issue   Started At      Stopped At      Spent           Comment
{0}     #1234   8:17PM          -               5m40.367443079s ""

act stop

2017/10/19 20:22:47 Activity 1234 stopped. Time elapsed 0.10 (5m45.347366369s)

act status

        Issue   Started At      Stopped At      Spent           Comment
{0}     #1234   8:17PM          8:22PM          5m45.347366369s ""

act push

Added 0.10 hour(s) to the Issue #1234.

act spent 5.67 -i 12345 -a dev -d 2017-09-15 -m 'Making the world a better place for humans'

Parameters/Arguments:

1. time -- it can be informed as:
   • 1.5 -- (1 hour 30 minutes) As a fraction of hour
   • 1:45 -- (1 hour 45 minutes) As time with hour and minute

Options/Flags:

• -i --issue_id -- If not informed it will try retrieve it from the git branch name using the regex config
• -d --date -- It can be informed as:
  • 2017-09-22 -- Complete date
  • 09-22 -- Only the month and day. The year will be the current one
  • 22 -- Only the day. The year and month will be the current ones
  • -1 -- Informing how many days back from the current date
  • And if not informed, it will use the current date
• -m --comment -- If not informed it will try to use the defined text editor
• -a --activity -- The name of an activity ID defined on the configuration file under activities
• --activity_id -- The activity ID. It Can be defined a default value to be used at the configuration file

act log -i 12345

Options/Flags:

• -i --issue_id

act link -i 12345

Options/Flags:

• -i --issue_id

act start -i 12345

Options/Flags:

• -i --issue_id -- If not informed it will try retrieve it from the git branch name using the regex config

act stop

act push

act status

act rm 0

Parameters/Arguments:

1. activity index on status list (without the curly brackets).

act note -i 12345 "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec varius eu purus in aliquam. Ut pellentesque magna purus, eu imperdiet justo convallis ac."

act note -i 12345 -t mr

Parameters/Arguments:

1. note -- The string note. If not informed it will try open the configured editor.

Options/Flags:

• -i --issue_id -- If not informed it will try retrieve it from the git branch name using the regex config
• -t --template -- The name of a template file to be loaded to be edited. These template files need to be stored in templates inside .act in the home directory (~/.act/templates/text_file)

Act is released under the MIT License.