{"id":28219727,"url":"https://github.com/no2chem/soss-cli","last_synced_at":"2025-06-11T06:31:41.728Z","repository":{"id":66336867,"uuid":"123174944","full_name":"no2chem/soss-cli","owner":"no2chem","description":"CLI interface to the California Hydrogen Fuel Cell Station Operational Status System (SOSS)","archived":false,"fork":false,"pushed_at":"2018-04-18T18:21:23.000Z","size":160,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-18T03:12:06.896Z","etag":null,"topics":["cli","command-line","fuel-cell","hydrogen","soss"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/no2chem.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}},"created_at":"2018-02-27T19:06:30.000Z","updated_at":"2025-05-08T08:25:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"d252eddf-4cb7-4499-8e22-1a910487e9c7","html_url":"https://github.com/no2chem/soss-cli","commit_stats":{"total_commits":21,"total_committers":1,"mean_commits":21.0,"dds":0.0,"last_synced_commit":"23355af593964a13c2456a091f1f5e217403130e"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/no2chem%2Fsoss-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/no2chem%2Fsoss-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/no2chem%2Fsoss-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/no2chem%2Fsoss-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/no2chem","download_url":"https://codeload.github.com/no2chem/soss-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/no2chem%2Fsoss-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259214486,"owners_count":22822895,"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","command-line","fuel-cell","hydrogen","soss"],"created_at":"2025-05-18T03:11:23.136Z","updated_at":"2025-06-11T06:31:41.719Z","avatar_url":"https://github.com/no2chem.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e Query California hydrogen station status from the CLI!\n\n![Screenshot](screenshot.svg)\n\n\u003e (The tables will render correctly in your terminal if emojis are correctly configured).\n\n# soss-cli\n[![Build Status](https://travis-ci.org/no2chem/soss-cli.svg?branch=master)](https://travis-ci.org/no2chem/soss-cli)\n* 🤔 Query the [CAFCP](https://cafcp.org)'s\n     Station Operational Status System (SOSS) from the command line\n     \n* 🛰️ Use geolocation to locate nearest stations\n\n* ⛳ Query stations near point of interest\n\n## Installation \n\nYou need npm or yarn installed. On macos, install [homebrew](https://brew.sh/) and run ```brew install npm```, on \nDebian-flavored Linux, run ```sudo apt-get install npm```.\n\nThen, install globally using npm or yarn:\n```sh\n# With npm\nnpm install -g soss-cli\n\n# With yarn\nyarn global add soss-cli\n```\n\nThe ```soss``` command will now be available.\n\n## Querying\n\nRunning without parameters will automatically print help.\n\n```sh\nsoss nearest\n```\nWill output a list of stations nearby. If you are running macos, CoreLocation will be used to locate you, otherwise we \nfallback to IP-based geolocation.\n\n```\n~ ❯❯❯ soss nearest                                                                                                                                ✘ 1\n✔ Getting current location\n✔ Getting station data\n✔ Getting Station Status\n╔═════════════╤═══════════════╤═════╤═════╤═════════════╤════════════════════════════════╗\n║ 🚗  Distance│ 🏢  Name      │ H35 │ H70 │ 🕒  Updated │ 💬  Message                    ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 1.67 mi     │ West LA       │ ❌  │ ❌  │ 11:28:45 AM │ The station is offline for mai ║\n║             │               │     │     │             │ ntenance, and we expect to reo ║\n║             │               │     │     │             │ pen around Thursday, 3/1. In t ║\n║             │               │     │     │             │ he interim, customers can use  ║\n║             │               │     │     │             │ Santa Monica or other nearby s ║\n║             │               │     │     │             │ tations. Please check back for ║\n║             │               │     │     │             │ updates. We apologize for any  ║\n║             │               │     │     │             │ inconvenience.                 ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 3.54 mi     │ Santa Monica  │ ✅  │ ✅  │ 11:33:44 AM │                                ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 4.64 mi     │ Fairfax-LA    │ ✅  │ ✅  │ 11:33:44 AM │ The Fairfax station will be of ║\n║             │               │     │     │             │ fline for maintenance activiti ║\n║             │               │     │     │             │ es all day on 3/6 through 3/7, ║\n║             │               │     │     │             │ We will advise as soon as the  ║\n║             │               │     │     │             │ station returns to operation.  ║\n║             │               │     │     │             │ We apologize for any inconveni ║\n║             │               │     │     │             │ ence this may cause.           ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 7.42 mi     │ Playa Del Rey │ ✅  │ ✅  │ 11:31:57 AM │                                ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 7.50 mi     │ Hollywood     │ ✅  │ ✅  │ 11:21:55 AM │                                ║\n╚═════════════╧═══════════════╧═════╧═════╧═════════════╧════════════════════════════════╝\n```\n\nYou can also ask for stations near a particular POI. We use [openstreetmap](https://www.openstreetmap.org/) to\nresolve addresses:\n\n```\n~ ❯❯❯ soss nearest disneyland\n✔ Getting station data\n✔ Getting Station Status\n╔═════════════╤═══════════════╤═════╤═════╤═════════════╤════════════════════════════════╗\n║ 🚗  Distance │ 🏢  Name     │ H35 │ H70 │ 🕒  Updated  │ 💬  Message                    ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 5.62 mi     │ Anaheim       │ ❌  │ ✅  │ 10:57:15 AM │ This station will reduce its e ║\n║             │               │     │     │             │ nergy consumption (to reduce H ║\n║             │               │     │     │             │ 2 costs!) between 12 midnight  ║\n║             │               │     │     │             │ to 5 AM daily.   Safe, complet ║\n║             │               │     │     │             │ e fills will still be achieved ║\n║             │               │     │     │             │ during this period, they will  ║\n║             │               │     │     │             │ just require a few minutes lon ║\n║             │               │     │     │             │ ger than routine.              ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 10.72 mi    │ UC Irvine     │ ✅  │ ✅  │ 11:03:48 AM │                                ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 11.16 mi    │ Costa Mesa    │ ✅  │ ✅  │ 11:02:09 AM │                                ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 12.98 mi    │ Newport Beach │ ✅  │ ✅  │ 11:09:00 AM │                                ║\n╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 14.16 mi    │ Diamond Bar   │ ✅  │ ⚠️  │ 11:03:47 AM │                                ║\n╚═════════════╧═══════════════╧═════╧═════╧═════════════╧════════════════════════════════╝\n```\n\nTo query an individual station, you can use the status command:\n```\n~ ❯❯❯ soss status hayward\n✔ Getting Station Status\n✔ Getting station data\n╔═══════╤═════════╤═════╤═════╤═════════════╤════════════════════════════════╗\n║ 🆔  ID│ 🏢  Name│ H35 │ H70 │ 🕒  Updated  │ 💬  Message                    ║\n╟───────┼─────────┼─────┼─────┼─────────────┼────────────────────────────────╢\n║ 15023 │ Hayward │ ✅  │ ✅  │ 11:02:13 AM │                               ║\n╚═══════╧═════════╧═════╧═════╧═════════════╧════════════════════════════════╝\n```\n\nProviding no argument will print all stations in the system.\n\n#\n\nThis project is not affiliated in any way with the California Hydrogen Fuel Cell Partnership.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fno2chem%2Fsoss-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fno2chem%2Fsoss-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fno2chem%2Fsoss-cli/lists"}