> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremewx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snowball Weather Commands: /weather Slash Reference

> Complete reference for all /weather slash commands in Snowball — radar, alerts, satellite, forecast, sounding, briefing, cameras, and more with all options.

All weather data comes from NWS and is limited to US locations. Every weather subcommand is slash-command only — prefix commands are not supported. Commands that accept a `location` option use autocomplete: start typing a city name and Snowball will suggest matching locations.

## Commands at a glance

| Subcommand           | Description                                                            |
| -------------------- | ---------------------------------------------------------------------- |
| `/weather current`   | Current conditions from the nearest NWS observation station            |
| `/weather forecast`  | 7-day extended forecast                                                |
| `/weather hourly`    | Hour-by-hour forecast for the next 12 hours                            |
| `/weather alerts`    | Active NWS weather alerts for a location                               |
| `/weather alertmap`  | Map of active NWS alerts across the US                                 |
| `/weather radar`     | Latest radar image for the nearest WSR-88D station                     |
| `/weather satellite` | GOES-19 satellite imagery by region and product                        |
| `/weather lightning` | Recent lightning strikes within 30 miles                               |
| `/weather briefing`  | AI-generated weather briefing                                          |
| `/weather story`     | Weather story graphic from an NWS office                               |
| `/weather graphic`   | Graphical Hazardous Weather Outlook (GHWO)                             |
| `/weather product`   | NWS text products (AFD, HWO)                                           |
| `/weather outages`   | Real-time power outage data for a county                               |
| `/weather sounding`  | Upper-air sounding from an NWS rawinsonde station                      |
| `/weather cameras`   | Live traffic and weather cameras near a location                       |
| `/weather misc`      | SPC watches, mesoscale discussions, storm reports, and activity charts |

***

## `/weather current`

Shows the current conditions reported by the nearest NWS observation station, including temperature, feels-like, wind, humidity, dew point, visibility, and pressure. Active alerts (if any) are also surfaced inline.

<ParamField path="location" type="string" required>
  Start typing a city name. Autocomplete will suggest matching locations.
</ParamField>

***

## `/weather forecast`

Shows the extended 7-day forecast broken into named periods (e.g., "Tonight", "Saturday", "Saturday Night").

<ParamField path="location" type="string" required>
  Start typing a city name. Autocomplete will suggest matching locations.
</ParamField>

***

## `/weather hourly`

Shows a hour-by-hour breakdown of temperature, feels-like, conditions, wind, humidity, and precipitation chance for the next 12 hours.

<ParamField path="location" type="string" required>
  Start typing a city name. Autocomplete will suggest matching locations.
</ParamField>

***

## `/weather alerts`

Retrieves active NWS weather alerts for the area. Alerts are ranked by severity (warnings first, then watches, then advisories). If multiple alerts exist, Snowball shows a dropdown to select which one to view.

<ParamField path="location" type="string" required>
  Start typing a city name. Autocomplete will suggest matching locations.
</ParamField>

<Note>
  Alert navigation buttons expire 15 minutes after the command is run. Only the user who ran the command can use the navigation buttons.
</Note>

***

## `/weather alertmap`

Shows a map of all active NWS weather alerts across the continental US, or filtered to a specific Weather Forecast Office (WFO).

<ParamField path="wfo" type="string" optional>
  WFO office code or city name (e.g., `PBZ`, `Pittsburgh`). Supports autocomplete. Leave blank for a CONUS-wide view.
</ParamField>

***

## `/weather radar`

Fetches a screenshot of the latest radar image from the nearest WSR-88D station within 150 miles. Includes a link to the interactive radar at radar.xtremewx.com. If the screenshot service is temporarily unavailable, Snowball provides a direct link to the live radar instead.

<ParamField path="location" type="string" required>
  The location you want radar for. Supports autocomplete.
</ParamField>

<ParamField path="layer" type="string" optional>
  Radar product to display. Defaults to Reflectivity.

  | Choice                     | Value     |
  | -------------------------- | --------- |
  | Reflectivity               | `sr_bref` |
  | Velocity                   | `sr_bvel` |
  | Hydrometeor Classification | `bdhc`    |
  | Rainfall (1 Hour)          | `boha`    |
  | Rainfall (Storm Total)     | `bdsa`    |
</ParamField>

***

## `/weather satellite`

Retrieves the latest GOES-19 satellite imagery. Defaults to a CONUS GeoColor animation loop. You can mix and match any supported region and product.

<ParamField path="region" type="string" optional>
  Which GOES-19 view to use. Defaults to CONUS. Available regions include: CONUS, Full Disk, Meso M1, Meso M2, and sector views for Northeast, Southeast, Southern Plains, Great Lakes, Upper Mississippi Valley, Northern Rockies, Southern Rockies, Southern Mississippi Valley, U.S. East Coast, Caribbean, Gulf of America, Puerto Rico, Tropical Atlantic Ocean, Eastern Pacific Ocean, Mexico, Central America, Northern South America, Southern South America, Canada, and Northern Atlantic Ocean.
</ParamField>

<ParamField path="product" type="string" optional>
  Satellite product to display. Defaults to GeoColor. Available products include GeoColor, GLM FED3+GeoColor (Lightning), AirMass RGB, Sandwich RGB, Derived Motion Winds, Day Night Cloud Micro Combo, Fire Temperature RGB, Dust RGB, and all 16 individual ABI spectral bands (Band 1–16).

  <Note>Not all products are available for every region. Meso sectors do not support AirMass RGB or Derived Motion Winds.</Note>
</ParamField>

<ParamField path="type" type="string" optional>
  Whether to show an animation loop or a single still image. Defaults to animation. If no animation is available, Snowball falls back to the latest still automatically.

  | Choice             |
  | ------------------ |
  | Animation loop     |
  | Latest still image |
</ParamField>

***

## `/weather lightning`

Shows lightning strikes detected within 30 miles of a location in the last 30 minutes, sourced from Blitzortung via Saratoga-Weather.org.

<ParamField path="location" type="string" required>
  Start typing a city name. Supports autocomplete.
</ParamField>

<ParamField path="sort" type="string" optional>
  How to sort the displayed strikes. Defaults to closest first.

  | Choice                    | Value      |
  | ------------------------- | ---------- |
  | Sort by closest first     | `distance` |
  | Sort by most recent first | `recent`   |
</ParamField>

***

## `/weather briefing`

Generates an AI-powered weather briefing for a location using current conditions, forecast data, and active alerts. The briefing is conversational or structured depending on the `style` option.

<ParamField path="location" type="string" required>
  Start typing a city name. Supports autocomplete.
</ParamField>

<ParamField path="style" type="string" optional>
  Briefing format. Defaults to conversational.

  | Choice                              |
  | ----------------------------------- |
  | Conversational (flowing narrative)  |
  | Structured (organized with bullets) |
</ParamField>

***

## `/weather story`

Displays the latest weather story graphic published by a National Weather Service forecast office. Supports multiple story slides with Previous/Next navigation.

<ParamField path="office" type="string" required>
  NWS office code or city name (e.g., `PBZ`, `Pittsburgh`). Supports autocomplete. Covers all CONUS, Alaska, Hawaii/Pacific, and Puerto Rico offices.
</ParamField>

<Note>
  Story navigation buttons expire 15 minutes after the command is run.
</Note>

***

## `/weather graphic`

Shows the Graphical Hazardous Weather Outlook (GHWO) for a location for a specific forecast day. You can view all hazard categories together or focus on a single one.

<ParamField path="location" type="string" required>
  Start typing a city name. Supports autocomplete.
</ParamField>

<ParamField path="day" type="string" required>
  Which forecast day to view (Day 1 through Day 7).
</ParamField>

<ParamField path="category" type="string" optional>
  Filter to a single hazard type. Leave blank to see the full hazard matrix. Available categories: Severe Thunderstorm, Tornado, Thunderstorm Wind, Hail, Lightning, Excessive Rainfall, Wind, Fog, Fire Weather, Extreme Cold, Ice Accumulation, Snow/Sleet.
</ParamField>

***

## `/weather product`

Fetches official NWS text products for the local forecast office serving the provided location.

<ParamField path="product" type="string" required>
  | Choice                          |
  | ------------------------------- |
  | Area Forecast Discussion (AFD)  |
  | Hazardous Weather Outlook (HWO) |
</ParamField>

<ParamField path="location" type="string" required>
  Start typing a city name. Supports autocomplete.
</ParamField>

***

## `/weather outages`

Shows real-time power outage data for the county containing the provided location. Data is sourced from ORNL ODIN. Displays total customers without power, percentage of county affected, and a per-utility breakdown with estimated restoration times where available.

<ParamField path="location" type="string" required>
  City name or ZIP code. Supports autocomplete.
</ParamField>

***

## `/weather sounding`

Displays the latest upper-air sounding image from the SPC Sounding Archive for a rawinsonde station. An **Analyze** button is available to get an AI interpretation of the sounding data. Available for CONUS stations only.

<ParamField path="station" type="string" required>
  Station ICAO code (e.g., `KOUN`), 3-letter SPC code (e.g., `OUN`), city name (e.g., `Norman`), or state name/abbreviation (returns the representative station for that state). Supports autocomplete.
</ParamField>

<ParamField path="time" type="string" optional>
  Which observation time to display. Defaults to the most recent available sounding.

  | Choice |
  | ------ |
  | Latest |
  | 12Z    |
  | 00Z    |
</ParamField>

***

## `/weather cameras`

Browses live traffic and weather cameras near a location using an interactive paginated gallery.

<ParamField path="location" type="string" required>
  Start typing a city name. Supports autocomplete.
</ParamField>

***

## `/weather misc`

Shows Storm Prediction Center data including active watches, active mesoscale discussions, today's storm reports, and the severe weather activity chart.

<ParamField path="type" type="string" required>
  | Choice                        |
  | ----------------------------- |
  | Active Watches                |
  | Active Mesoscale Discussions  |
  | Today's Storm Reports         |
  | Severe Weather Activity Chart |
</ParamField>
