FAQ

Home > FAQs > The weather blank

What is the weather blank in OpenCues?

Type weather london _ and the _ becomes London: 13°C Overcast. The weather blank is a keyword-bound blank backed by Open-Meteo's free API: no key, no signup, live conditions in your text field.

What you type

Four trigger keywords: weather, forecast, temp, and temperature, leading the sentence your _ ends. The city is extracted from the surrounding words with two strategies: preposition-anchored (weather in New York _, forecast for cape town _) and a trailing run of non-filler words (Paris weather _). Multi-word city names survive intact. If no city can be found, it falls back to a default (London).

Where the data comes from

Open-Meteo, in two steps: the location name goes to Open-Meteo's geocoding endpoint to resolve latitude and longitude, then a second fetch pulls the current temperature and weather code at those coordinates. The WMO weather code is mapped to a plain description (Clear, Partly cloudy, Thunderstorm, and so on). Both endpoints are free with no API key. Results are cached for 5 minutes per city.

Read-only, and context-aware

Cycling doesn't step anything (the weather is the weather); to refresh, type a new _. The output embeds the city name so it reads as a self-contained fact after the command span clears. When the optional blank-context-mode is on and your work city is stored in IDENTITY.md, the blank also exposes current weather for that city as an ambient token, so casual phrasings like do i need a jacket _ can route to it without the keyword.

One honest caveat: city extraction is a heuristic. It's built to catch the common phrasings, but an unusual sentence shape can hand the geocoder a wrong or unknown location, in which case you get a visible Unknown location answer rather than a silent failure.

Related: What is a blank? · Context-aware lookups · GitHub repo