See FORKINFO.md for information on how this fork differs from the below.
- Start, stop and adjust timers
- Delete timers
- Add/append notes
- API token is stored in keychain (no password used for authenticating)
- Uses the latest Harvest API (v2)
Install the latest version which you can find under Releases.
- Make sure you have node.js installed. To check run
node -vfrom your terminal. - Go to https://id.getharvest.com/developers › 'Create New Personal Access Token' and give it a name, i.e. 'Alfred workflow'.
- Copy the access token and remember your Account ID.
- Type
hvsand press enter, - Paste the API token and press enter,
- Type your 6-digit Account ID and press enter,
- Type
hvnand start your first timer!
*The first time you run the workflow you may be prompted to grant access to the API token (which is stored in your Keychain).
Note: In order to install workflows you need the Alfred Powerpack.
- Type hvn to list the available projects,
- Select a project and press enter,
- Select the task and press enter
- Type
hvtto list today's timers. - Press enter to stop/restart the selected task.
Tip: Hold alt to delete the selected task.
- Type
hvato list today's timers, - Select a timer by pressing enter,
- Type a new time for the task in digit (
2.5) or time (2h30m) format.
Tip: Add a +/- in front of your timer to add or subtract time, i.e. -30m will subtract 30 minutes from your timer.
- Type
hvntto list today's timers, - Select a timer by pressing enter,
Tip: Your newly typed note will be appended by default. If you want to overwrite the note, hold down the alt-key when selecting a task from the list.
This workflow was inspired by Neil Renicker’s Harvest workflow which I've used for years (but stopped working for me).
All icons (except the Harvest logo) are from Daniel Bruce’s Entypo-pack, and are distributed under the CC BY-SA 4.0-license.