- Start, stop and adjust timers
- Delete timers
- Add/append notes
- API token is stored securely in Keychain (no password used for authenticating)
- Uses the latest Harvest API (v2)
- Ensure that you have node.js installed. You can check by running
node -vin the Terminal. - Download the latest version of the workflow from the Releases page.
- Open https://id.getharvest.com/developers and click on 'Create New Personal Access Token'.
- Give the token a name, such as 'Alfred workflow', and generate it.
- Copy the generated Account ID.
- Open the workflow's configuration and paste the Account ID. Save the configuration.
- Type
hvsin Alfred and press enter. - Paste the API token and press enter.
- Type
hvnin Alfred to start your first timer.
Note: Make sure you have the Alfred Powerpack installed to use workflows.
*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.