blob: b4394d19d4b49baf6a34a36ca162f4c46469b4c3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
# HCl
HCl is a command-line tool for interacting with Harvest time sheets using the
[Harvest time tracking API][htt].
[htt]: http://www.getharvest.com/api/time_tracking
## Quick Start
You can install hcl directly from rubygems.org:
$ gem install hcl
or you can install from source:
$ rake install
If you're using HCl for the first time, the show command sets up your
Harvest credentials:
$ hcl show
## Usage
hcl [start] @<task_alias> [+<time>] [<message>]
hcl note <message>
hcl stop [message]
hcl resume [@<task_alias>]
hcl log @<task_alias> [+<time>] [<message>]
hcl show [date]
hcl tasks
hcl alias <task_alias> <project_id> <task_id>
hcl aliases
hcl (cancel | nvm | oops)
### Available Projects and Tasks
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.
$ hcl tasks
### Starting a Timer
Since it's not practical to enter two long numbers every time you want to
identify a task, HCl supports task aliases:
$ hcl alias tacodev 1234 5678
$ hcl @tacodev Adding a new feature
### Starting a Timer with Initial Time
You can also provide an initial time when starting a new timer.
This can be expressed in floating-point or HH:MM. The following two
commands are equivalent:
$ hcl @tacodev +0:15 Doing some stuff
$ hcl +.25 @tacodev Doing some stuff
### Adding Notes to a Running Task
While a task is running you can append lines to the task notes:
$ hcl note Then I did something else
### Stopping a Timer
The following command will stop a running timer (currently only one timer at
a time is supported). You can provide a message when stopping a timer as
well:
$ hcl stop All done doing things
### Resuming a Timer
You can resume a stopped timer. Specify a task to resume the last timer
for that task:
$ hcl resume
$ hcl resume @xdev
### Canceling a Timer
If you accidentally started a timer that you didn't mean to, you can cancel
it:
$ hcl cancel
This will delete the running timer, or the last-updated timer if one isn't
running. You can also use `nvm` or `oops` instead of `cancel`.
### Logging without Starting a Timer
You can log time and notes without leaving a timer running. It takes
the same arguments as start:
$ hcl log @xdev +1 Worked for an hour.
The above starts and immediately stops a one-hour timer with the given note.
### Bash Auto-completion of Task Aliases
You can enable auto-completion of task aliases by adding this to your bashrc:
eval `hcl completion`
### Date Formats
Dates can be expressed in a variety of ways. See the [Chronic documentation][cd]
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
[cd]: http://chronic.rubyforge.org/
## Author
HCl was designed and implemented by [Zack Hobson][zgh].
* Non-SSL support by [Michael Bleigh][mbleigh].
* Resume command by [Brian Cooke][bricooke].
* UI improvements by [Chris Scharf][scharfie].
See LICENSE for copyright details.
[zgh]: http://github.com/zenhob
[mbleigh]: http://github.com/mbleigh
[bricooke]: http://github.com/bricooke
[scharfie]: http://github.com/scharfie
|
