Skip to content

Latest commit

 

History

History
53 lines (30 loc) · 1.28 KB

README.md

File metadata and controls

53 lines (30 loc) · 1.28 KB

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.