{"id":25590680,"url":"https://github.com/injoongy/oriole","last_synced_at":"2025-08-10T00:12:47.203Z","repository":{"id":47190502,"uuid":"305165804","full_name":"injoongy/oriole","owner":"injoongy","description":"Make time fly 🐦","archived":false,"fork":false,"pushed_at":"2024-06-25T17:01:30.000Z","size":846,"stargazers_count":7,"open_issues_count":12,"forks_count":1,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-08-09T12:47:47.509Z","etag":null,"topics":["cli","conf","ink","javascript","node-fetch","pastel","react","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/injoongy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-18T18:08:58.000Z","updated_at":"2024-05-20T16:32:50.000Z","dependencies_parsed_at":"2024-11-10T01:57:48.874Z","dependency_job_id":"392bfb74-b9d4-4274-98dd-b9422de544af","html_url":"https://github.com/injoongy/oriole","commit_stats":null,"previous_names":["attilathehen/oriole"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/injoongy/oriole","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/injoongy%2Foriole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/injoongy%2Foriole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/injoongy%2Foriole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/injoongy%2Foriole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/injoongy","download_url":"https://codeload.github.com/injoongy/oriole/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/injoongy%2Foriole/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269655767,"owners_count":24454529,"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","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cli","conf","ink","javascript","node-fetch","pastel","react","typescript"],"created_at":"2025-02-21T09:22:53.114Z","updated_at":"2025-08-10T00:12:47.167Z","avatar_url":"https://github.com/injoongy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# oriole\n\nMake time fly 🐦\n\nA CLI app that automatically creates a [Harvest](https://www.getharvest.com/) time entry out of your git commits.\nMade using [Ink](https://github.com/vadimdemedes/ink) and [Pastel](https://github.com/vadimdemedes/pastel).\n\n## Install\n\n```bash\n$ npm install -g oriole\n```\n\n\n## Commands\n\n### `oriole setup`\nSet up your Harvest account info on your local machine so that the other `oriole`\ncommands can function properly.\n\nThis will ask you for your Harvest Personal Access Token and account ID (which you can find or create [here](https://id.getharvest.com/developers)), and save it to an encrypted JSON file using [conf](https://github.com/sindresorhus/conf).\nPlease refer to `conf`'s README to find the default location of this file (it depends on your OS). If you're using macOS, it should be:\n```bash\n~/Library/Preferences/oriole-nodejs/orioleStore.json\n```\nIf you're done using `oriole`, feel free to delete this file at any time. You'll just need to re-run `oriole setup` the next time you run a command.\n\n### `oriole init`\nInitialize the current repo with a Harvest project ID and task ID. These IDs\nwill then be used when running `oriole push` to create a Harvest timesheet\nentry.\n\nIf your current working directory is a valid git repository, this command will make a GET request to your Harvest account (using the token and account ID you provided in `oriole setup`) and show you a list of your available Harvest projects and their corresponding tasks.\n\nOnce you've selected a project and task, it will save those IDs to your encrypted `conf` store, and will be used when running `oriole push`. **Essentially, this command links your current local git repo with a Harvest project/task**.\n\n### `oriole push`\n\nAdditional arguments:\n```\n--hours, -h  Set the hours spent on this Harvest entry.    [number] [required]\n--date, -d   Get the commits made on the specified date.              [string]\n```\nThis is the main command for `oriole`. Using `oriole push`, you can create a timesheet entry out of the most recent git commit messages in your current repo\n(made either on the current day or on the specified date using `--date`). After confirmation, `oriole` will create a Harvest time entry using the previously-specified Harvest project/task, and POST it to your account.\n\nIn the event that the same project/task entry is already in your Harvest account on the day you specified (if, for example, you added it manually), `oriole` will ask whether you would like to replace that existing entry or create a new one. If there are multiple entries, choosing to replace will only replace the most recent entry.\n\n### `oriole pto`\nAdditional arguments:\n```\n--year, -y  The year for which you'd like to see the total number of PTO hours spent.\t[number]\n```\n\nRun this command to have `oriole` calculate the total number of PTO hours spent in the current calendar year. It will only calculate the PTO hours spent for the Tivix internal Harvest project and task.\n\nOptionally pass in a different year to get the total PTO hours for that year instead.\n\n### `oriole --help`\nShows the help text and the available commands.\n\n\n## Development\nIf you'd like to run the project locally, simply clone (or fork and clone) the repo and run `npm install`.\n\nThere are 2 available commands:\n\n- `npm run dev` - Start development mode and recompile on change\n- `npm run build` - Build a final distributable for npm\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finjoongy%2Foriole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finjoongy%2Foriole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finjoongy%2Foriole/lists"}