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

# Configuration

> Pomeroy's five settings panes: the apps your assistant can reach, the assistants themselves, the two ways in, your licence, and updates.

Everything Pomeroy can be told is in one window. Click the tree icon in your
menu bar and choose **Settings**.

There is no configuration file of Pomeroy's own to edit, and no Terminal
command. The files Pomeroy does write belong to your assistants, and each
assistant's page here shows exactly what goes in them.

## The five panes

| Pane            | What it holds                                                        |
| --------------- | -------------------------------------------------------------------- |
| **Apps**        | The ten switches. Everything starts off                              |
| **Assistants**  | The assistants found on this Mac, and the **Set up** button for each |
| **Connections** | The two ways in, and who gets in through the second                  |
| **Licence**     | Your key, activation, and this Mac's free allowance                  |
| **General**     | Updates, and the version you are running                             |

## Apps

The same grid you saw at setup. Switching an app on for the first time asks
macOS for its permission; switching one off takes its tools away at once, from
every assistant, without a restart.

A toggle is your intent and a grant is macOS's answer, and they are not the same
thing. [Permissions](/docs/getting-started/permissions) is the whole of that.

## Assistants

Pomeroy lists the assistants it finds on this Mac. Press **Set up** on a row and
Pomeroy configures that assistant however its own vendor documents: an
extension, an install link, its own CLI, its configuration file, or your
clipboard.

Pressing **Set up** twice is safe. It is the same write every time, and it never
disturbs another server already in the file.

<Card title="Your assistant's own page" icon="list" href="/docs/assistants/overview">
  What Set up does, how to check it worked, and the configuration in full.
</Card>

## Connections

Two ways in, and one of them is a switch.

<Columns cols={2}>
  <div>
    **Direct**, always on

    Assistants talk to Pomeroy straight through the app, on this Mac. No port,
    no credential, nothing to revoke: the filesystem has already decided who
    may speak to it. [How it works](/docs/configuration/stdio).
  </div>

  <div>
    **Local address**, off until you switch it on

    One address on this Mac for an assistant that cannot start a program: one in
    a container, or one that takes only a URL. [How it
    works](/docs/configuration/http-endpoint).
  </div>
</Columns>

Direct cannot be switched off. If you close the local address, your assistants
still work.

### Who gets in

The local address is guarded by one setting for the whole endpoint, in one of
three modes. **Token** is the default.

| Mode         | What the door accepts                                                                           |
| ------------ | ----------------------------------------------------------------------------------------------- |
| **Token**    | One secret, written into the settings of every assistant Pomeroy can reach                      |
| **Approval** | Only a credential Pomeroy's own authorization server issued. The assistant asks, and you answer |
| **Open**     | A request with no credential, and nothing else                                                  |

The modes are exclusive rather than degrees of strictness. [What each one means,
and why Open exists](/docs/configuration/http-endpoint#what-guards-the-endpoint).

## Licence

Enter the key from your purchase email and press **Activate**. Until then this
Mac is on the free allowance, and the sidebar shows what is left of the week.

A licence covers one Mac at a time. **Deactivate this Mac** frees the key so you
can use it on another.

[Buy and activate](/docs/licence/buy-and-activate) · [Moving Macs and
refunds](/docs/licence/moving-and-refunds)

## General

<AccordionGroup>
  <Accordion title="Keep Pomeroy up to date" icon="arrows-rotate">
    On by default. Pomeroy checks daily while it is running and installs new
    versions quietly in the background. Every update is signed, and one whose
    signature does not match the bytes is thrown away rather than installed.

    Switch it off and Pomeroy never asks again. **Check for Updates…** is then
    the only thing that looks.
  </Accordion>

  <Accordion title="The version you are running" icon="tag">
    Shown at the foot of the sidebar. Quote it in an email if something is
    wrong.
  </Accordion>
</AccordionGroup>

## What Pomeroy writes on your Mac

Four places, and nothing else.

| Path                                                       | What it holds                                                |
| ---------------------------------------------------------- | ------------------------------------------------------------ |
| `~/Library/Preferences/com.joesaunderson.pomeroy.plist`    | Your toggles, your licence activation, the Messages bookmark |
| `~/Library/Application Support/Pomeroy/`                   | The socket assistants connect through                        |
| `~/Library/Application Support/com.joesaunderson.pomeroy/` | The usage counter's own queue and identifiers                |
| Your assistants' own configuration files                   | One `pomeroy` entry each, and nothing else touched           |

[Removing all of it](/docs/uninstall).

## Next

<CardGroup cols={2}>
  <Card title="Permissions" icon="toggle-on" href="/docs/getting-started/permissions">
    What each toggle grants, and what macOS asks you for.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/docs/getting-started/troubleshooting">
    Every way Pomeroy can appear not to work, and the fix.
  </Card>
</CardGroup>