shopbuddy-plugin

# Shop Buddy

**Let your AI coding agent change your Shopify theme safely.** Every edit lands on an unpublished staging theme. Shop Buddy validates it with Theme Check, screenshots before/after on mobile and desktop with a plain-language summary of what changed, and you approve with one tap. Rollback is one tap. The live theme is never edited directly.

Site and one-click install: **https://getshopbuddy.vercel.app/install**

[![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-000)](cursor://anysphere.cursor-deeplink/mcp/install?name=shopbuddy&config=eyJ1cmwiOiAiaHR0cHM6Ly9nZXRzaG9wYnVkZHkudmVyY2VsLmFwcC9hcGkvbWNwIn0%3D)
[![Add to VS Code](https://img.shields.io/badge/Add_to-VS_Code-0078d4)](vscode:mcp/install?%7B%22name%22%3A%20%22shopbuddy%22%2C%20%22type%22%3A%20%22http%22%2C%20%22url%22%3A%20%22https%3A//getshopbuddy.vercel.app/api/mcp%22%7D)
[![npm](https://img.shields.io/npm/v/shopbuddy)](https://www.npmjs.com/package/shopbuddy)

```bash
# Claude Code (hosted MCP, signs in through your browser)
claude mcp add --transport http shopbuddy https://getshopbuddy.vercel.app/api/mcp

# Claude Code plugin (adds the skill too)
claude plugin marketplace add tmill313/shopbuddy-plugin
claude plugin install shopbuddy@shopbuddy-marketplace

# Codex
codex mcp add shopbuddy --url https://getshopbuddy.vercel.app/api/mcp

# Local CLI (no account needed for local mode)
npx shopbuddy
```

Claude (web/desktop) and ChatGPT: add a custom connector with `https://getshopbuddy.vercel.app/api/mcp`. The agent opens a browser tab; sign in or create an account there and click Allow. No keys.

## How it works

1. `shopbuddy_start_change` duplicates the live theme into a staging theme and pulls it into a server-side working copy.
2. The agent reads, searches and writes files, runs Theme Check with `shopbuddy_validate`, then `shopbuddy_push_preview` uploads to staging and captures before/after screenshots, each visual change attributed to its section.
3. `shopbuddy_submit` and `shopbuddy_request_publish` hand the store owner a one-tap approval link. Owners can opt a store into trusted publishing so low-risk changes publish on request, always logged and one tap from `shopbuddy_rollback`.

Agent-readable summary: https://getshopbuddy.vercel.app/llms.txt

## What is in this repo

This is the public companion to the hosted service: the Claude Code plugin and marketplace manifests, the `shopbuddy` skill, the MCP client config, and the MCP Registry manifest (`io.github.tmill313/shopbuddy`). The platform itself is a hosted service; the CLI ships compiled on npm as [`shopbuddy`](https://www.npmjs.com/package/shopbuddy).

## Privacy and terms

https://getshopbuddy.vercel.app/privacy · https://getshopbuddy.vercel.app/terms

Shop Buddy is an independent service, not affiliated with or endorsed by Shopify.