redclock

redclock is a CLI to track time entries in Redmine.

Installation

Use cargo to compile & install redclock:

$ cargo install redclock

Or download an appropriate binary from our release page.

Usage

Servers

redclock saves time entries in a Redmine instance, therefore you need to add a server to your local configuration first:

$ redclock server add https://redmine.example.com --token <YOUR_API_TOKEN_HERE>

In case you are using a password manager that offers a CLI, use this instead for maximum security:

$ redclock server add https://redmine.example.com --command "<PASSWORD_MANAGER> <COMMAND>"

# example using 'pass'
$ redclock server add https://redmine.example.com --command "pass show redmine.example.com/api-key"

Time Tracking

Once you have added at least one server, you can start tracking time. Redmine supports tracking time on both projects and issues.

$ redclock track start

The above command will ask you questions on which activity you are starting & which project/issue you are working on. You can specify those on the command line directly in case you do not like fuzzy selection.

Once you are done with your work, call:

$ redclock track stop

This will save the amount of hours you have worked on a project/issue in your Redmine instance.