mushi-setuplisted
Install: claude install-skill kensaurus/mushi-mushi
# Mushi Mushi Setup
## Overview
Mushi Mushi is a TDD/PDCA engine for web apps: it captures bugs, maps user stories from your live app, auto-generates Playwright tests, and continuously improves them via PDCA loops.
## Quick Start (5 steps)
### 1. Get your project credentials
Go to your [Mushi Console](https://mushi-mushi.app) → Settings → API Keys.
You need:
- `MUSHI_PROJECT_ID` — your project UUID
- `MUSHI_API_KEY` — a `mushi_...` prefixed key
### 2. Install the SDK
```bash
# npm
npm install @mushi-mushi/web
# or pnpm / yarn
pnpm add @mushi-mushi/web
```
### 3. Initialize in your app
```ts
import { Mushi } from '@mushi-mushi/web'
Mushi.init({
projectId: process.env.MUSHI_PROJECT_ID!,
apiKey: process.env.MUSHI_API_KEY!,
capture: {
discoverInventory: {
enabled: true,
// Optional: normalize dynamic routes so /items/abc-123 → /items/[id]
routeTemplates: ['/items/[id]', '/users/[userId]/profile'],
},
},
})
```
### 4. Map user stories from live app (no SDK required)
```bash
# Install the CLI
npm install -g @mushi-mushi/cli
# Login
mushi login --api-key mushi_... --endpoint https://<ref>.supabase.co/functions/v1/api --project-id <uuid>
# Crawl and map user stories
mushi stories map --url https://your-app.vercel.app --wait
```
Review the generated proposal in the console: **Inventory → Discovery → Past proposals**.
### 5. Generate TDD tests from stories
```bash
# List accepted user stories (accept a proposal in the console first)