Introduction

The rtimelog program is a time-tracking and reporting system that has grown over several years to meet my needs. It’s main features are a simple log file format and a straight-forward command line tool.

Unlike many time-trackers, rtimelog focuses on entering tasks easily and simple reporting, rather than fancy GUI interfaces. The idea is that in a fancier tracking tool, you are more likely to spend time using the tool to track time rather than getting work accomplished. Moreover, I am quite comfortable working with a command line, that’s all I focused on.

Conventions

Since this is a command line tool, most of the examples show running the program in a shell. The code that you would type in the command line will be in a block and preceded by a $ character. Any lines shown without the $ in the same block are the response from the program.

This is a command without any response.

  $ rtimelog start +project @Code

This is a command with a response.

  $ rtimelog curr
  +project @Code