{"id":13709590,"url":"https://github.com/clok/hev-cli","last_synced_at":"2025-03-21T19:32:53.560Z","repository":{"id":39911997,"uuid":"349891329","full_name":"clok/hev-cli","owner":"clok","description":"H-E-V: Here Everyone's Vaccinated - This tool is intended to help those who qualify for the COVID-19 vaccine at H-E-B find an appointment.","archived":false,"fork":false,"pushed_at":"2025-03-05T14:34:45.000Z","size":57,"stargazers_count":4,"open_issues_count":9,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-18T04:35:29.169Z","etag":null,"topics":["cli","covid","covid-19","covid19","go","golang","golang-cli","vaccine-availability"],"latest_commit_sha":null,"homepage":"https://clok.sh/hev-cli/","language":"Go","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/clok.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["clok"]}},"created_at":"2021-03-21T03:28:07.000Z","updated_at":"2022-10-09T09:44:15.000Z","dependencies_parsed_at":"2023-09-29T02:34:04.529Z","dependency_job_id":"539fa155-fae3-45b1-9031-cb29c4853e44","html_url":"https://github.com/clok/hev-cli","commit_stats":{"total_commits":46,"total_committers":3,"mean_commits":"15.333333333333334","dds":"0.17391304347826086","last_synced_commit":"857f73875c95a2e14d1ecd2171ef1e6094a7def3"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clok%2Fhev-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clok%2Fhev-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clok%2Fhev-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clok%2Fhev-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clok","download_url":"https://codeload.github.com/clok/hev-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244855680,"owners_count":20521678,"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":["cli","covid","covid-19","covid19","go","golang","golang-cli","vaccine-availability"],"created_at":"2024-08-02T23:00:42.128Z","updated_at":"2025-03-21T19:32:53.176Z","avatar_url":"https://github.com/clok.png","language":"Go","funding_links":["https://github.com/sponsors/clok"],"categories":["Repositories"],"sub_categories":[],"readme":"# hev-cli\n\n\u003e H-E-V: Here Everyone's Vaccinated\n\nPlease see [the docs for details on the commands.](./docs/hev.md)\n\n- [Docs](./docs/hev.md)\n- [About](#about)\n- [What it does](#what-it-does)\n- [Installation](#installation)\n  - [Linux \u0026 Mac OS](#linux--mac-os)\n  - [Windows](#windows)\n  - [docker](#docker)\n- [Usage](#usage)\n- [How do I find my latitude and longitude?](#how-do-i-find-my-latitude-and-longitude)\n- [Important Links](#important-links)\n- [License](#license)\n\n## About\n\nThis tool is intended to help those who qualify ([SEE RULES](https://vaccine.heb.com/scheduler)) for the COVID-19 vaccine at H-E-B find an appointment.\n\nPlease goto the [COVID-19 vaccines at H-E-B Pharmacy Scheduler](https://vaccine.heb.com/scheduler) to read up on the qualification rules.\n\n## What it does\n\n1. `hev` processes the vaccine schedule API on a regular cadence (every 5 seconds by default).\n1. It will check the availability posted for ALL H-E-B locations in the list to determine if there are shots available.\n1. It will then determine if the location is within a radius of miles based on your lat/long (user provided)\n1. If the available shot is within your radius, it will alert you and open a browser directly to the appointment sign up page.\n\n\u003e PLEASE NOTE: Slots are taken up FAST. Once the browser opens, it is very possible that the slot has been taken. Keep trying. Stay persistent. You will get one.\n\n## Installation\n\n### Linux \u0026 Mac OS\n```\n$ curl https://i.jpillora.com/clok/hev-cli! | sed s/PROG=\\\"hev-cli\\\"/PROG=\\\"hev\\\"/ | bash\n```\n\n### Windows\n\n1. Goto [Releases](https://github.com/clok/hev-cli/releases)\n1. Download `hev_\u003cversion\u003e_windows_amd64.zip`\n1. Unzip (extract all)\n1. Run the app in a Terminal\n\n### [docker](https://www.docker.com/)\n\nThe compiled docker images are maintained on [GitHub Container Registry (ghcr.io)](https://github.com/users/clok/packages/container/package/hev-cli).\nWe maintain the following tags:\n\n- `edge`: Image that is build from the current `HEAD` of the main line branch.\n- `latest`: Image that is built from the [latest released version](https://github.com/clok/hev-cli/releases/releases)\n- `x.y.z` (versions): Images that are build from the tagged versions within Github.\n\n```bash\ndocker pull ghcr.io/clok/hev-cli\ndocker run -v \"$PWD\":/workdir ghcr.io/clok/hev-cli --version\n```\n\n## Usage\n\nRun the tool with a 50-mile radius, and a 2-second refresh rate. (The lat/long here is fake)\n\n```\n$ hev watch --miles 50 --delay 2 --lat 12.345 --long -12.345\n```\n\nHelp output\n\n```\nNAME:\n   hev - scan H-E-B vaccine availability and open a browser when there is one available within a radius of miles\n\nUSAGE:\n   hev [global options] command [command options] [arguments...]\n\nVERSION:\n   v0.3.0\n\nCOMMANDS:\n   watch, w         start the watcher\n   publish          start the publisher\n   websocket        start the websocket server\n   install-manpage  Generate and install man page\n   version, v       Print version info\n   help, h          Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --help, -h     show help (default: false)\n   --version, -v  print the version (default: false)\n```\n\n## How do I find my latitude and longitude?\n\nGoto [https://map.google.com](https://map.google.com) and enter your address. Right-Click on the Pin marker that shows up. Click the first line, the lat/long. That will copy the value.\n\n![image](https://user-images.githubusercontent.com/1429775/111990513-539ced00-8ae1-11eb-9bcd-c3999933adc1.png)\n\n## Important Links\n\n- [CDC COVID-19 Vaccine Resource Center](https://www.cdc.gov/vaccines/covid-19/index.html)\n- [H-E-B Vaccine Scheduler](https://vaccine.heb.com/scheduler)\n- [DSHS Texas Guidelines](https://www.dshs.texas.gov/coronavirus/)\n\n## License\n\n[MIT @ clok](LICENSE)\n\n\u003e THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n\u003e IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n\u003e FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n\u003e AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n\u003e LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n\u003e OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n\u003e SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclok%2Fhev-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclok%2Fhev-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclok%2Fhev-cli/lists"}