> ## 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.

# Location

> One tool, which reports where this Mac is. It is the only Pomeroy tool that needs the Location grant, because Maps and Weather take place names instead.

Location is the narrowest app in Pomeroy and the easiest to leave switched off.

Most people do not need it. Maps and Weather take **place names**, so "what's
the weather in Lisbon" and "how long to drive to Bristol" both work with
Location off. Switch it on only if you want an assistant to be able to ask
where you are.

## Tools

| Tool               | What it does                                                                                                                      | Kind |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------- | ---- |
| `location_current` | Where this Mac is: latitude, longitude, how accurate the fix is in metres, a place name where one is known, and when it was taken | Read |

## Try it

```text theme={null}
Where am I?
What's the weather where I am right now?
How far am I from the office?
```

## Worth knowing

<AccordionGroup>
  <Accordion title="It is the only tool that needs the grant" icon="key">
    Every other tool that could plausibly want your location takes a place name
    instead. That is a deliberate split: it keeps the Location grant genuinely
    optional rather than something you have to allow to make Weather work.
  </Accordion>

  <Accordion title="While running, not always" icon="clock">
    Pomeroy asks for location **while in use**
    (`NSLocationWhenInUseUsageDescription`), never the always-on grant. There is
    no background tracking, and nothing is logged.
  </Accordion>

  <Accordion title="The accuracy is reported, not hidden" icon="crosshairs">
    A Mac without GPS locates itself by Wi-Fi, which can be off by a lot. The
    answer carries the accuracy in metres so an assistant can say "somewhere
    within 3km of here" rather than stating a false precision.
  </Accordion>
</AccordionGroup>

## Permissions

Switching Location on asks macOS for access to your location while Pomeroy is
running.