Windy

Onboarding

First-run setup, or changing saved preferences — capture the user's home location, unit preferences (temperature, wind, precipitation), and default forecast model, then save them so every later forecast and link uses them without re-asking. Load when the user is new, says "set up Windy", or asks to change their units, home, or default model.

Outdoor activity

Decide whether the weather works for an outdoor session — a ride, run, sail, paddle, round of golf, or any plan where wind, gusts, or rain timing changes the call. Load when the user asks "will it rain for my <activity>", "how windy will it be", or wants a go/no-go on an outdoor plan.

Geocode

Resolve a place name (city, town, neighborhood) to latitude and longitude so you can call `point_forecast`. Returns up to a few candidate matches with country and region. When a name is ambiguous (more than one place shares it), pick the match whose country/region fits the user's context, or ask which they mean: do not guess past a clear tie.

Point forecast

Get a rich weather forecast for an exact latitude/longitude from a numerical weather model. Returns a per-step series (about every 3 hours) with temperature, wind speed and direction (compass + degrees), gusts, precipitation amount and type, humidity, and cloud cover by layer. Far more detailed than a web-search blurb: use it for wind, rain timing, and 'will it rain for my ride / should I sail' questions. Resolve a place name with `geocode` first. Default model is GFS (global); pass `model` to compare runs (e.g. 'iconEu', 'arome' for Europe). Lead with the near-term steps.

Forecast link

Build a windy.com map link for a location so the user can inspect the live, interactive forecast themselves: pan the map, scrub the timeline forward and back, switch overlays, and click the point for its full meteogram. Use this to hand off for manual checking alongside a `point_forecast` answer, or when the user asks for the Windy map / radar / a link. Resolve a place name with `geocode` first to get lat/lon. Pick the `overlay` that fits the question (wind for a sail, rain for 'will it rain', temp for cold) and the same `model` you forecasted with. The link opens at the current time; the user scrubs the slider for other hours.