{"id":38340883,"url":"https://github.com/josephburgess/gust","last_synced_at":"2026-01-17T03:00:03.738Z","repository":{"id":279544609,"uuid":"938979810","full_name":"josephburgess/gust","owner":"josephburgess","description":"Command line weather app written in Go","archived":false,"fork":false,"pushed_at":"2025-03-12T18:04:30.000Z","size":131,"stargazers_count":27,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-25T11:49:23.924Z","etag":null,"topics":["command-line","command-line-tool","golang","learning"],"latest_commit_sha":null,"homepage":"","language":"Go","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/josephburgess.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":"2025-02-25T19:55:17.000Z","updated_at":"2025-09-19T14:48:50.000Z","dependencies_parsed_at":"2025-03-05T15:30:01.773Z","dependency_job_id":null,"html_url":"https://github.com/josephburgess/gust","commit_stats":null,"previous_names":["josephburgess/gust"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/josephburgess/gust","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephburgess%2Fgust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephburgess%2Fgust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephburgess%2Fgust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephburgess%2Fgust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/josephburgess","download_url":"https://codeload.github.com/josephburgess/gust/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephburgess%2Fgust/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28492593,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T02:39:23.645Z","status":"ssl_error","status_checked_at":"2026-01-17T02:34:19.649Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["command-line","command-line-tool","golang","learning"],"created_at":"2026-01-17T03:00:03.642Z","updated_at":"2026-01-17T03:00:03.716Z","avatar_url":"https://github.com/josephburgess.png","language":"Go","funding_links":[],"categories":["\u003ca name=\"utility\"\u003e\u003c/a\u003eUtilities"],"sub_categories":[],"readme":"# gust\n\nA simple cli weather tool built with Go that provides weather forecasts in the terminal.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/d5c8e7cc-c43c-4263-a516-89f01bb26a24\" width=\"600\"\u003e\n\u003c/p\u003e\n\n## Installation\n\n### Option 1: Homebrew (macOS)\n\nThe easiest way to install gust at the moment is with Homebrew:\n\n```sh\nbrew tap josephburgess/formulae\nbrew install gust\n```\n\n### Option 2: Manual Installation\n\n#### 1. Clone the repository\n\n```sh\ngit clone https://github.com/josephburgess/gust.git\ncd gust\n```\n\n#### 2. Install dependencies\n\n```sh\ngo mod tidy\n```\n\n#### 3. Build the binary\n\n```sh\ngo build -o gust ./cmd/gust\n```\n\n#### 4. Install\n\nMove the binary to a directory in your `$PATH`:\n\n```sh\nmv gust /usr/local/bin/\n```\n\n## Usage\n\nThe first time you run gust a first-time configuration wizard will get you set up in no time.\n\n### Basic Commands\n\n```bash\n# Get weather for your default city\ngust\n\n# Get weather for a specific city\ngust london\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/76695b8d-5e37-45a3-89cd-2d5b3401c323\" width=\"600\"\u003e\n\u003c/p\u003e\n\n## Configuration Flags\n\n_These flags modify user config / settings and don't display weather by themselves_\n\n| Short | Long               | Description                                                |\n| ----- | ------------------ | ---------------------------------------------------------- |\n| `-h`  | `--help`           | Show help                                                  |\n| `-S`  | `--setup`          | Run the setup wizard                                       |\n| `-A`  | `--api=STRING`     | Set custom API server URL (mostly for development)         |\n| `-C`  | `--city=STRING`    | Specify city name                                          |\n| `-D`  | `--default=STRING` | Set a new default city                                     |\n| `-U`  | `--units=STRING`   | Set default temperature units (metric, imperial, standard) |\n| `-L`  | `--login`          | Authenticate with GitHub                                   |\n| `-K`  | `--api-key`        | Set your api key (either gust, or openweathermap)          |\n\n## Display Flags\n\n_These flags control how weather information is displayed_\n\n| Short | Long         | Description                                   |\n| ----- | ------------ | --------------------------------------------- |\n| `-a`  | `--alerts`   | Show weather alerts                           |\n| `-c`  | `--compact`  | Show today's compact weather view             |\n| `-d`  | `--detailed` | Show today's detailed weather view            |\n| `-f`  | `--full`     | Show today, 5-day and weather alert forecasts |\n| `-r`  | `--hourly`   | Show 24-hour (hourly) forecast                |\n| `-y`  | `--daily`    | Show 5-day forecast                           |\n\n## Authentication\n\ngust uses a proxy api I set up and host privately, [breeze](http://github.com/josephburgess/breeze), to fetch weather data. This keeps the setup flow pretty frictionless for new users.\n\nWhen you first run gust:\n\n1. A setup wizard will guide you through the initial configuration\n2. You'll be prompted to choose an authentication method:\n   - GitHub OAuth (one click sign up/in)\n   - Your own OpenWeather Map API key if you prefer not to use Oauth or need much higher rate limits\n     - User submitted keys will need to be eligible for the [One Call API 3.0](https://openweathermap.org/api/one-call-3#how)\n     - The first 1000 calls every day are free but they ask for CC info to get a key\n3. If you choose GitHub OAuth:\n   - Your default browser will open to complete authentication\n   - No need to manually obtain or manage API keys\n4. Your credentials will be securely stored locally for future use in `~/.config/gust/auth.json`\n\nAfter this one-time setup, authentication happens automatically whenever you use the app.\n\n## Troubleshooting\n\nIf you encounter any auth issues, you can re-run the setup wizard or use the `-L / --login` (Oauth) `-K / --api-key` (api key) flags to re-set your key or check the local config files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosephburgess%2Fgust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosephburgess%2Fgust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosephburgess%2Fgust/lists"}