Skip to content

Latest commit

 

History

History
69 lines (44 loc) · 3.09 KB

README.md

File metadata and controls

69 lines (44 loc) · 3.09 KB
Raw

Control your Harvest timers using Alfred.

  • 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)

Installation & Setup

  1. Ensure that you have node.js installed. You can check by running node -v in the Terminal.
  2. Download the latest version of the workflow from the Releases page.
  3. Open https://id.getharvest.com/developers and click on 'Create New Personal Access Token'.
  4. Give the token a name, such as 'Alfred workflow', and generate it.
  5. Copy the generated Account ID.
  6. Open the workflow's configuration and paste the Account ID. Save the configuration.
  7. Type hvs in Alfred and press enter.
  8. Paste the API token and press enter.
  9. Type hvn in 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.

How to use

Start a new timer

Start a new timer

  • Type hvn to list the available projects,
  • Select a project and press enter,
  • Select the task and press enter

Toggle timer

Toggle timer

  • Type hvt to list today's timers.
  • Press enter to stop/restart the selected task.

Tip: Hold alt to delete the selected task.

Adjust timer

Adjust timer

  • Type hva to 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.

Add notes

Add note

  • Type hvnt to 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.

Credits & thank you’s

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.