HCl is a command-line tool for interacting with Harvest time sheets using the Harvest time tracking API.
NOTE This software is nowhere near complete. To try it out:
$ cp hcl_conf.yml.example hcl_conf.yml $ $EDITOR hcl_conf.yml $ ./bin/hcl show [date]
- Ruby (tested with 1.8.7)
- Ruby OpenSSL support (in debian/ubuntu: apt-get install libopenssl-ruby)
- Trollop option-parsing library (gem install trollop)
- Chronic date-parsing library (gem install chronic)
NOTE that add and rm are not yet implemented.
hcl show [date] hcl tasks hcl set <key> <value ...> hcl unset <key> hcl start (<task_alias> | <project_id> <task_id>) [msg ...] hcl note <msg ...> hcl stop hcl add (<task_alias> | <project_id> <task_id>) <duration> [msg ...] hcl rm [entry_id]
Starting a Timer
To start a new timer you need to identify the project and task. After you've used the show command you can use the tasks command to view a cached list of available tasks. The first two numbers in each row are the project and task IDs. You need both values to start a timer:
$ hcl show ------------- 0:00 total $ hcl tasks 1234 5678 ClientX Software Development 1234 9876 ClientX Admin $ hcl start 1234 5678 adding a new feature
Since it's not practical to enter two long numbers every time you want to identify a task, HCl supports task aliases:
$ hcl set task.xdev 1234 5678 $ hcl start xdev adding a new feature
Adding Notes to a Running Task
While a task is running you can append strings to the note for that task:
$ hcl note Found a good time $ hcl note or not, whatever...
Stopping a Timer
The following command will stop a running timer (currently only one timer at a time is supported):
$ hcl stop
Dates can be expressed in a variety of ways. See the Chronic documentation for more information about available date input formats. The following commands show the timesheet for the specified day:
$ hcl show yesterday $ hcl show last friday $ hcl show 2 days ago $ hcl show 1 week ago
See LICENSE for copyright details.