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

# AI assistants

> The 24 AI assistants Pomeroy sets itself up in, what setup does in each, and what to do when yours is not on the list.

Pomeroy works with any AI assistant that speaks MCP and runs on your Mac. It
knows twenty-four of them by name: it finds them, sets itself up in them, and
tells you what each one needs afterwards.

Every assistant reaches the same server and obeys the same switches. Connecting
a second one adds tools, not permissions.

## Set up in one click

Pomeroy uses whichever mechanism the vendor documents: an extension, an install
link, the assistant's own CLI, or its configuration file. You press **Set up**
and answer whatever prompt the assistant itself shows.

<CardGroup cols={3}>
  <Card title="Claude Desktop" icon="message" href="/docs/assistants/claude-desktop">
    An extension Claude Desktop installs
  </Card>

  <Card title="Claude Code" icon="terminal" href="/docs/assistants/claude-code">
    Its own `claude mcp add`, user scope
  </Card>

  <Card title="Cursor" icon="code" href="/docs/assistants/cursor">
    Cursor's install link
  </Card>

  <Card title="VS Code" icon="code" href="/docs/assistants/vscode">
    VS Code's install link
  </Card>

  <Card title="VS Code Insiders" icon="code" href="/docs/assistants/vscode-insiders">
    The nightly build, set up separately
  </Card>

  <Card title="Codex" icon="terminal" href="/docs/assistants/codex">
    One file the CLI, IDE and ChatGPT app share
  </Card>

  <Card title="LM Studio" icon="microchip" href="/docs/assistants/lm-studio">
    One entry in its `mcp.json`
  </Card>

  <Card title="Kiro" icon="code" href="/docs/assistants/kiro">
    Kiro's install link
  </Card>

  <Card title="Cherry Studio" icon="comments" href="/docs/assistants/cherry-studio">
    Cherry Studio's install link
  </Card>

  <Card title="Cline" icon="code" href="/docs/assistants/cline">
    The settings file every Cline surface shares
  </Card>

  <Card title="AnythingLLM" icon="comments" href="/docs/assistants/anythingllm">
    One entry in its server file
  </Card>

  <Card title="Gemini CLI" icon="terminal" href="/docs/assistants/gemini-cli">
    Its own `mcp add`, user scope
  </Card>

  <Card title="GitHub Copilot CLI" icon="terminal" href="/docs/assistants/copilot-cli">
    Its own `mcp add`
  </Card>

  <Card title="OpenCode" icon="terminal" href="/docs/assistants/opencode">
    Its own `mcp add`, terminal and desktop
  </Card>
</CardGroup>

## Set up by pasting

These have no configuration file Pomeroy can safely write, or no install link
their vendor documents. Pomeroy puts the exact configuration on your clipboard
and says where it goes.

<CardGroup cols={3}>
  <Card title="Raycast" icon="magnifying-glass" href="/docs/assistants/raycast">
    Three values for its Install MCP Server form
  </Card>

  <Card title="ChatWise" icon="comments" href="/docs/assistants/chatwise">
    Import JSON from Clipboard
  </Card>

  <Card title="goose" icon="feather" href="/docs/assistants/goose">
    A YAML block for `config.yaml`
  </Card>

  <Card title="Windsurf" icon="code" href="/docs/assistants/windsurf">
    JSON for `mcp_config.json`
  </Card>

  <Card title="Warp" icon="terminal" href="/docs/assistants/warp">
    JSON for `.mcp.json`
  </Card>

  <Card title="Zed" icon="code" href="/docs/assistants/zed">
    A `context_servers` block
  </Card>

  <Card title="Perplexity" icon="magnifying-glass" href="/docs/assistants/perplexity">
    Two values for its Add Connector form
  </Card>

  <Card title="JetBrains AI Assistant" icon="code" href="/docs/assistants/jetbrains">
    JSON for every JetBrains IDE at once
  </Card>

  <Card title="BoltAI" icon="bolt" href="/docs/assistants/boltai">
    JSON for its plugin settings
  </Card>

  <Card title="Msty Studio" icon="comments" href="/docs/assistants/msty-studio">
    Two values for its Toolbox
  </Card>
</CardGroup>

## Mine is not on the list

Any assistant that can start a local MCP server works, from the same
configuration. Point it at the pipe:

```json theme={null}
{
  "mcpServers": {
    "pomeroy": {
      "command": "/Applications/Pomeroy.app/Contents/MacOS/pomeroy-mcp"
    }
  }
}
```

If it takes a URL rather than a command, switch on the local address in
Pomeroy's **Connections** pane and give it [the
endpoint](/docs/configuration/http-endpoint) instead.

Pomeroy's **Copy configuration** button produces the same text.

## What Set up never does

<Columns cols={2}>
  <div>
    **It writes**

    * One `pomeroy` entry, in the file that assistant reads
    * Nothing outside that entry
    * The same bytes every time, so pressing **Set up** twice is safe
  </div>

  <div>
    **It does not**

    * Remove or rewrite another server in the file
    * Rewrite a file that allows comments. Those go to your clipboard instead
    * Change anything about the assistant beyond its server list
  </div>
</Columns>

## After setup

| Assistant                                                           | What it needs                                     |
| ------------------------------------------------------------------- | ------------------------------------------------- |
| Claude Desktop, Codex                                               | A full quit and reopen                            |
| Claude Code, Gemini CLI, goose                                      | A new session                                     |
| Cursor, Cherry Studio, OpenCode, Warp, Zed, Perplexity, Msty Studio | Usually nothing; restart if the tools are missing |
| The rest                                                            | Nothing. They pick it up on their own             |

## Cloud assistants

claude.ai in a browser, ChatGPT on the web and Grok cannot reach Pomeroy at all,
and that is a decision rather than a gap.

<Card title="Why cloud assistants cannot connect" icon="cloud-slash" href="/docs/assistants/cloud-assistants">
  What runs where, and the desktop equivalents that work today.
</Card>
