> For the complete documentation index, see [llms.txt](https://wishlist.nativeappco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/install-with-ai.md).

# Install with an AI tool

Step by step: have Claude Code, Codex, Cursor, Claude or ChatGPT add Fish Wishlist to your theme.

Your AI tool follows our [setup instructions for AI agents](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide.md). Before it changes anything, it looks through your theme and asks you a few questions: where the wishlist buttons should go, how they should look and how the wishlist should behave. It then shows you the plan and waits for your OK.

Pick the option that fits how you work:

* [**Coding agents**](#option-1-coding-agents-claude-code-codex-cursor) (Claude Code, Codex, Cursor): for developers and agencies with the theme code on their computer. The agent edits the theme files itself.
* [**AI chat**](#option-2-ai-chat-claude-chatgpt) (Claude, ChatGPT): for merchants working in the browser. The assistant tells you what to paste and where.

{% hint style="warning" %}
Always try theme changes on a **copy of your theme** first. In Shopify admin go to **Online Store → Themes**, click **⋯** next to your live theme and choose **Duplicate**. Publish the copy once you're happy with it.
{% endhint %}

## Option 1: Coding agents (Claude Code, Codex, Cursor)

Best for developers and agencies. The agent works on a local copy of your theme, pulled with Shopify CLI.

{% stepper %}
{% step %}

### Install Fish Wishlist and enable the app embed

Install Fish Wishlist from the Shopify App Store. Then open your **duplicated theme** in the theme editor, go to **App embeds**, turn on **Wishlist Drawer 2.0** and click **Save**.

The agent can't switch on app embeds itself, so do this one step by hand. See [Enable app embeds](https://wishlist.nativeappco.com/install-and-setup/theme-setup/enable-app-embeds.md).
{% endstep %}

{% step %}

### Pull your theme with Shopify CLI

If you don't have [Shopify CLI](https://shopify.dev/docs/api/shopify-cli) yet, install it, then download the duplicated theme into an empty folder:

```bash
npm install -g @shopify/cli
shopify theme list --store your-store.myshopify.com
shopify theme pull --store your-store.myshopify.com --theme <theme-id>
```

Use the ID of your duplicated theme from the `theme list` output.
{% endstep %}

{% step %}

### Start your agent in the theme folder

{% tabs %}
{% tab title="Claude Code" %}
In the theme folder, run:

```bash
claude
```

Claude Code also works inside VS Code and other editors through its extension.
{% endtab %}

{% tab title="Codex" %}
In the theme folder, run:

```bash
codex
```

Codex also works in its IDE extension and desktop app. Open the theme folder there.
{% endtab %}

{% tab title="Cursor" %}
Open the theme folder in Cursor, open the chat panel and switch it to **Agent** mode.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Give it the setup instructions

Paste this prompt:

```
Read https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide
and follow it to add Fish Wishlist to this theme. Don't push to my live theme.
```

If your agent can't open web pages, copy the text of the [setup instructions](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide.md) into a file called `FISH_WISHLIST_SETUP.md` in your theme folder, and ask it to follow that file instead.
{% endstep %}

{% step %}

### Answer its questions, then review

The agent looks through your theme and asks about placement, styling and functionality. Answer them (or reply "defaults are fine"), check the plan it writes back, and approve it. It then makes the edits and lists what you still need to do by hand. Preview with:

```bash
shopify theme dev --store your-store.myshopify.com
```

When you're happy, push the theme (`shopify theme push --theme <theme-id>`), check it in Shopify admin and publish it. In Fish Wishlist, **Setup** confirms that the embed and buttons are installed.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Want the agent to set up the app's settings too?** Also [connect it to Fish Wishlist (MCP)](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/connect-with-mcp.md). It can then apply your answers about guest wishlists, multiple lists, custom CSS and cart refresh code itself, instead of asking you to change them in the Fish admin.
{% endhint %}

{% hint style="info" %}
**Agencies:** the [setup instructions](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide.md) work the same way for every client store. Save them in your theme starter kit or repo template so every project begins with them.
{% endhint %}

## Option 2: AI chat (Claude, ChatGPT)

Best for merchants without a developer. Chat assistants can't edit your theme, but they can read it and write the exact code for you to paste into **Online Store → Themes → ⋯ → Edit code**.

### With the Fish Wishlist connector (recommended)

Connect the assistant to Fish Wishlist and it can see your theme files and app settings on its own.

{% tabs %}
{% tab title="Claude" %}

1. In Fish Wishlist, open **Developer → AI agents**, enable access and copy your server URL.
2. In Claude (claude.ai or the desktop app), go to **Settings → Connectors → Add custom connector** and paste the URL.
3. Approve the connection when Fish Wishlist asks you to. Full steps are in [Connect AI to Fish Wishlist (MCP)](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/connect-with-mcp.md).
   {% endtab %}

{% tab title="ChatGPT" %}

1. In Fish Wishlist, open **Developer → AI agents**, enable access and copy your server URL.
2. In ChatGPT, add it as a custom connector (MCP server) under **Settings → Apps & Connectors**. Custom connectors need developer mode turned on in **Advanced settings**, and aren't available on every ChatGPT plan.
3. Approve the connection when Fish Wishlist asks you to.
   {% endtab %}
   {% endtabs %}

Then ask:

```
Use the Fish Wishlist setup instructions at
https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide
to check what's missing on my theme, and tell me step by step what to paste and where.
```

### Without a connector

Any AI chat can still help. Copy the theme files it asks for (in **Edit code**, usually `sections/header.liquid` and your product card snippet, such as `snippets/card-product.liquid`) into the chat with this prompt:

```
I'm installing the Fish Wishlist app on my Shopify theme. Follow the instructions at
https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide.
You can't edit my files, so tell me which files to send you, then give me the exact code
to paste and where to put it.
```

If the assistant can't open links, paste the text of the [setup instructions](https://wishlist.nativeappco.com/install-and-setup/installing-using-ai-tools/agent-setup-guide.md) into the chat as well.

## Tips

* **Check every change in a preview** before publishing. AI tools make mistakes too.
* **Do one thing at a time** if your theme is heavily customised: header icon first, then product page, then product cards.
* **Ask for styling tweaks in plain words**, for example *"make the wishlist button match my Add to cart button but outlined"*.
* **Stuck?** Send us your store URL and theme name at <fish@nativeappco.com> and we'll take a look.
