{"id":26712634,"url":"https://github.com/andrejilderda/alfred-harvest","last_synced_at":"2025-04-13T21:13:43.647Z","repository":{"id":41813070,"uuid":"218126822","full_name":"andrejilderda/alfred-harvest","owner":"andrejilderda","description":"Control your Harvest timers directly from Alfred.","archived":false,"fork":false,"pushed_at":"2024-01-03T11:06:57.000Z","size":573,"stargazers_count":43,"open_issues_count":2,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-24T18:55:39.870Z","etag":null,"topics":["alfred-workflow","harvest","harvestapp","javascript","time-tracker"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrejilderda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-10-28T19:17:35.000Z","updated_at":"2023-08-29T02:22:17.000Z","dependencies_parsed_at":"2024-01-03T06:27:51.596Z","dependency_job_id":"73de1168-7df2-4bc8-ba7c-73d4cfa68d1a","html_url":"https://github.com/andrejilderda/alfred-harvest","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Falfred-harvest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Falfred-harvest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Falfred-harvest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Falfred-harvest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrejilderda","download_url":"https://codeload.github.com/andrejilderda/alfred-harvest/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245838236,"owners_count":20680728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alfred-workflow","harvest","harvestapp","javascript","time-tracker"],"created_at":"2025-03-27T11:37:36.267Z","updated_at":"2025-03-27T11:37:36.824Z","avatar_url":"https://github.com/andrejilderda.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Control your [Harvest](https://www.getharvest.com/) timers using [Alfred](https://www.alfredapp.com/).\n\n- Start, stop and adjust timers\n- Delete timers\n- Add/append notes\n- API token is stored securely in Keychain (no password used for authenticating)\n- Uses the latest Harvest API (v2)\n\n## Installation \u0026 Setup\n\n1. Ensure that you have [node.js](https://nodejs.org/en/) installed. You can check by running `node -v` in the Terminal.\n2. Download the latest version of the workflow from the [Releases](https://github.com/andrejilderda/alfred-harvest/releases) page.\n3. Open https://id.getharvest.com/developers and click on 'Create New Personal Access Token'.\n4. Give the token a name, such as 'Alfred workflow', and generate it.\n5. Copy the generated Account ID.\n6. Open the workflow's configuration and paste the Account ID. Save the configuration.\n7. Type `hvs` in Alfred and press \u003ckbd\u003eenter\u003c/kbd\u003e.\n8. Paste the API token and press \u003ckbd\u003eenter\u003c/kbd\u003e.\n9. Type `hvn` in Alfred to start your first timer.\n\nNote: Make sure you have the [Alfred Powerpack](https://www.alfredapp.com/powerpack/) installed to use workflows.\n\n\\*The first time you run the workflow you may be prompted to grant access to the API token (which is stored in your Keychain).\n\n_Note: In order to install workflows you need the [Alfred Powerpack](https://www.alfredapp.com/powerpack/)._\n\n## How to use\n\n### Start a new timer\n\n![Start a new timer](https://user-images.githubusercontent.com/487182/68616415-48858600-04c5-11ea-921c-38d3b8d0217b.gif)\n\n- Type \u003ckbd\u003ehvn\u003c/kbd\u003e to list the available projects,\n- Select a project and press \u003ckbd\u003eenter\u003c/kbd\u003e,\n- Select the task and press \u003ckbd\u003eenter\u003c/kbd\u003e\n\n### Toggle timer\n\n![Toggle timer](https://user-images.githubusercontent.com/487182/68616434-4f13fd80-04c5-11ea-8379-77b7ba7919e0.gif)\n\n- Type `hvt` to list today's timers.\n- Press \u003ckbd\u003eenter\u003c/kbd\u003e to stop/restart the selected task.\n\n**Tip:** Hold \u003ckbd\u003ealt\u003c/kbd\u003e to delete the selected task.\n\n### Adjust timer\n\n![Adjust timer](https://user-images.githubusercontent.com/487182/68617779-3bb66180-04c8-11ea-8ea8-2b35ebe934ad.gif)\n\n- Type `hva` to list today's timers,\n- Select a timer by pressing \u003ckbd\u003eenter\u003c/kbd\u003e,\n- Type a new time for the task in digit (`2.5`) or time (`2h30m`) format.\n\n**Tip:** Add a `+`/`-` in front of your timer to add or subtract time, i.e. `-30m` will subtract 30 minutes from your timer.\n\n### Add notes\n\n![Add note](https://user-images.githubusercontent.com/487182/68617778-3bb66180-04c8-11ea-9951-ee7d23e10fdc.gif)\n\n- Type `hvnt` to list today's timers,\n- Select a timer by pressing \u003ckbd\u003eenter\u003c/kbd\u003e,\n\n**Tip:** Your newly typed note will be appended by default. If you want to overwrite the note, hold down the \u003ckbd\u003ealt\u003c/kbd\u003e-key when selecting a task from the list.\n\n## Credits \u0026 thank you’s\n\nThis workflow was inspired by Neil Renicker’s [Harvest workflow](https://github.com/tinystride/alfred-harvest) which I've used for years (but stopped working for me).\n\nAll icons (except the Harvest logo) are from Daniel Bruce’s [Entypo](http://www.entypo.com/)-pack, and are distributed under the [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)-license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrejilderda%2Falfred-harvest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrejilderda%2Falfred-harvest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrejilderda%2Falfred-harvest/lists"}