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

# Weather

> Your AI assistant can read current conditions and the daily forecast for a named place, from Apple's WeatherKit, the same source the Weather app uses.

Weather answers come from Apple's WeatherKit, the same source the Weather app
uses. Like Maps, both tools take place names rather than your location.

<Columns cols={2}>
  <div>
    **Can**

    * Read current conditions for a named place: temperature, feels-like,
      humidity and wind
    * Read a daily forecast for a named place: highs, lows and the chance of rain
  </div>

  <div>
    **Cannot**

    * Use your location. The weather actions take place names only
    * Call a third-party weather service. Answers come from Apple, or not at all
  </div>
</Columns>

## Tools

| Tool               | What it does                                                                                                                                                        | Kind |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| `weather_current`  | Current conditions for a named place: temperature and feels-like in Celsius, humidity, and wind in km/h, with the instant they were measured                        | Read |
| `weather_forecast` | Daily forecast for a named place: high and low in Celsius and the chance of rain, per local day. The reply says how many days were asked for and how many came back | Read |

## Try it

```text theme={null}
What's the weather in Lisbon this weekend?
Is it going to rain in Manchester tomorrow?
How cold is it in Edinburgh right now?
```

## The one request that leaves your Mac

Weather is the only app whose tools cause a request to the internet carrying
anything about your question.

When you ask, WeatherKit sends Apple the **coordinates of the place you named**
and enough about the app itself for Apple to agree to answer. The coordinates
are "Clapham, London", not where your Mac is.

Apple's own words: *"Location is used only to provide weather forecasts and is
not associated with any personally identifying information and is never shared
or sold."*

It is on [what leaves your Mac](/docs/privacy/what-leaves-your-mac) with everything
else, and the toggle is off until you switch it on. Off means no request.

## Worth knowing

<AccordionGroup>
  <Accordion title="Apple answers, or nothing does" icon="apple">
    WeatherKit checks the app's signature against a paid Apple developer team. A
    build Apple will not answer gets no weather at all, and says so. There is
    deliberately no third-party fallback, because a fallback would send your
    questions somewhere this page does not name.
  </Accordion>

  <Accordion title="Celsius and km/h" icon="temperature-half">
    Fixed units, so an assistant never has to guess. It can convert for you in
    its answer.
  </Accordion>

  <Accordion title="No permission prompt" icon="toggle-on">
    Like Maps, WeatherKit does not prompt. The toggle is the gate.
  </Accordion>
</AccordionGroup>