Oddjob, a simple tool for tracking time
Perl
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
COPYING
README.md
oj

README.md

OddJob

A simple tool for tracking time.

Like many unix admins, I always have terminals open. Other time tracking tools carry a lot of overhead, and I only wanted to quickly estimate how much time the unexpected non-project time takes. OddJob should allow me to log these without too much overhead.

OddJob stores its data in a text file called .oddjob, kept in your home directory, 1 line per entry.

OddJob requires perl5, but should work with any reasonably current version. It doesn't need any unusual modules. Works fine on Linux, Solaris and OS X. Not tested on Windows.

Usage

Usage:
  oj add <time> <category> <description>
  oj list|ls [string]
  oj list|ls [-lines]
  oj edit <id> (date|time|cat|desc)=<new value>

To add a new entry:

oj add 1h code First effort at oddjob

oj list
0	2011-07-18	1h	code	First effort at oddjob

Editing:

oj edit 0 time=2h

Multiple categories:

oj edit 0 cat=code,git

oj list
0	2011-07-18	2h	code,git	First effort at oddjob

It is also possible to limit the list to the final entries:

oj list -10

You can also search by passing any other text:

oj list effort

TODO

Summary/stats scripts.

License

OddJob is released under the GPLv2 license. See the COPYING file for details.