Setup StoreBrief with Cursor

Cursor is an AI-powered code editor built on VS Code. It can read project files and connect to external services, making it a solid option for running StoreBrief - especially if you're already using Cursor for development.

Time to complete: ~10 minutes

Step 1: Install Cursor

If you don't have Cursor yet:

Download from cursor.com
Install and launch the app
Sign in or create an account
If prompted, choose a plan (Cursor Pro is recommended for agent features)

Step 2: Create your StoreBrief project

Create a new folder for StoreBrief:

mkdir storebrief && cd storebrief

Open this folder in Cursor: File → Open Folder → select your storebrief folder

Step 3: Add your StoreBrief files

After purchasing StoreBrief, place your 4 files in the project folder:

storebrief/
├── SOUL.md
├── SKILL.md
├── INTEGRATIONS.md
└── GETTING_STARTED.md

Step 4: Configure Cursor to load StoreBrief

Create a .cursorrules file in your project root. This tells Cursor's AI to load StoreBrief on every conversation:

Read SOUL.md and SKILL.md before responding to any request. These files define your operator persona and complete capabilities.

You are StoreBrief, an AI store operator. Follow the persona in SOUL.md and use the toolkit defined in SKILL.md for all store operations, diagnostics, and daily briefs.

Save this file as .cursorrules in your storebrief folder.

Step 5: Connect your data source

Option A: Kleio via MCP (Recommended)

Cursor supports MCP connections. To add Kleio:

Install Kleio from the Shopify App Store
Enable the MCP server in Kleio and copy your API key
In Cursor, open settings and find the MCP configuration section
Add Kleio as an MCP server with your API key

Option B: Shopify Direct

Create a Shopify Private App (see Connect Your Shopify Store)
Create a .env file in your storebrief folder:

SHOPIFY_STORE_URL=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxx

Tell StoreBrief your credentials are configured when you start a conversation

Option C: Triple Whale

Add your API key to .env:

TRIPLE_WHALE_API_KEY=your_api_key_here

Step 6: Run your first daily brief

Open Cursor's AI chat (Cmd+L on Mac, Ctrl+L on Windows) and type:

Run my daily brief

First time only: StoreBrief will ask for store context (revenue range, team size, ad spend). This is a one-time setup.

What to try next

"Why is AOV down?" - AOV diagnostic tree
"What's my MER?" - marketing efficiency check
"Run a Klaviyo health check" - if Klaviyo is connected
"Create a product draft for [name]" - draft-first product creation
"Check my inventory risk" - velocity-based risk scoring

Troubleshooting

"Cursor doesn't load StoreBrief persona" Make sure .cursorrules exists at the root of your project folder and references both SOUL.md and SKILL.md. Restart the AI chat after creating the file.

"MCP not connecting" Check Cursor's MCP settings. Some Cursor versions require you to enable MCP support in settings first.

"Context too long" If Cursor struggles with the full SKILL.md file, try using Cursor's Agent mode (Cmd+I) which handles longer context better than the chat panel.