@mushi-mushi/cli 0.2.0 → 0.4.0

package/README.md

@@ -1,23 +1,53 @@
 # @mushi-mushi/cli
 
-CLI tool for Mushi Mushi project management and report triage.
+CLI for Mushi Mushi — set up the SDK in one command, then triage reports and monitor the pipeline from your terminal.
 
-## Install
+## One-command setup
+
+```bash
+npx @mushi-mushi/cli init
+# or, equivalently:
+npx mushi-mushi init
+```
+
+The wizard:
+
+1. Detects your framework (Next.js, Nuxt, SvelteKit, Angular, Expo, Capacitor, plain React/Vue/Svelte, or vanilla JS) from `package.json` and config files.
+2. Picks the right SDK package (`@mushi-mushi/react`, `@mushi-mushi/vue`, etc.) plus `@mushi-mushi/web` when the framework SDK is API-only.
+3. Detects your package manager (npm / pnpm / yarn / bun) from your lockfile and installs with that.
+4. Writes `MUSHI_PROJECT_ID` and `MUSHI_API_KEY` (with the right framework prefix — `NEXT_PUBLIC_`, `NUXT_PUBLIC_`, `VITE_`) to `.env.local` (or `.env`).
+5. Warns you if `.env.local` isn't in `.gitignore`.
+6. Prints the framework-specific provider snippet to copy-paste.
+
+It never silently overwrites existing env vars or modifies application code.
+
+### Flags
+
+```bash
+mushi init --framework next         # skip framework detection
+mushi init --project-id proj_xxx --api-key mushi_xxx  # skip credential prompts
+mushi init --skip-install           # print the install command instead of running it
+mushi init -y                       # accept the detected framework without confirmation
+```
+
+## Install globally
 
 ```bash
 npm install -g @mushi-mushi/cli
+mushi --help
 ```
 
-## Usage
+## Other commands
 
 ```bash
-mushi login              # Authenticate with your API key
-mushi status             # Project overview
-mushi reports list       # List recent reports
-mushi reports show <id>  # View report details
-mushi reports triage <id> --priority high --assign @dev
-mushi deploy check       # Check edge function health
-mushi test               # Submit a test report to verify pipeline
+mushi login --api-key mushi_xxx     # store credentials in ~/.mushirc
+mushi status                         # project overview
+mushi reports list                   # recent reports
+mushi reports show <id>              # one report
+mushi reports triage <id> --status acknowledged --severity high
+mushi deploy check                   # edge-function health probe
+mushi index <path>                   # walk a local repo and feed RAG
+mushi test                           # submit a test report end-to-end
 ```
 
 ## License

package/dist/chunk-YZOGONU4.js

@@ -0,0 +1,238 @@
+// src/detect.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+var FRAMEWORKS = {
+  next: {
+    id: "next",
+    label: "Next.js",
+    packageName: "@mushi-mushi/react",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// app/providers.tsx (or pages/_app.tsx for /pages router)
+'use client'
+import { MushiProvider } from '@mushi-mushi/react'
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <MushiProvider config={{
+      projectId: '${projectId}',
+      apiKey: '${apiKey}',
+    }}>
+      {children}
+    </MushiProvider>
+  )
+}`
+  },
+  react: {
+    id: "react",
+    label: "React",
+    packageName: "@mushi-mushi/react",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// src/main.tsx
+import { MushiProvider } from '@mushi-mushi/react'
+
+createRoot(document.getElementById('root')!).render(
+  <MushiProvider config={{
+    projectId: '${projectId}',
+    apiKey: '${apiKey}',
+  }}>
+    <App />
+  </MushiProvider>
+)`
+  },
+  vue: {
+    id: "vue",
+    label: "Vue 3",
+    packageName: "@mushi-mushi/vue",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/main.ts
+import { MushiPlugin } from '@mushi-mushi/vue'
+import { Mushi } from '@mushi-mushi/web'
+
+app.use(MushiPlugin, { projectId: '${projectId}', apiKey: '${apiKey}' })
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  nuxt: {
+    id: "nuxt",
+    label: "Nuxt",
+    packageName: "@mushi-mushi/vue",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// plugins/mushi.client.ts
+import { MushiPlugin } from '@mushi-mushi/vue'
+import { Mushi } from '@mushi-mushi/web'
+
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.vueApp.use(MushiPlugin, {
+    projectId: '${projectId}',
+    apiKey: '${apiKey}',
+  })
+  Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })
+})`
+  },
+  svelte: {
+    id: "svelte",
+    label: "Svelte",
+    packageName: "@mushi-mushi/svelte",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/main.ts (or +layout.svelte for SvelteKit)
+import { initMushi } from '@mushi-mushi/svelte'
+import { Mushi } from '@mushi-mushi/web'
+
+initMushi({ projectId: '${projectId}', apiKey: '${apiKey}' })
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  sveltekit: {
+    id: "sveltekit",
+    label: "SvelteKit",
+    packageName: "@mushi-mushi/svelte",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/routes/+layout.svelte
+<script>
+  import { onMount } from 'svelte'
+  import { initMushi } from '@mushi-mushi/svelte'
+
+  onMount(async () => {
+    const { Mushi } = await import('@mushi-mushi/web')
+    initMushi({ projectId: '${projectId}', apiKey: '${apiKey}' })
+    Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })
+  })
+</script>`
+  },
+  angular: {
+    id: "angular",
+    label: "Angular",
+    packageName: "@mushi-mushi/angular",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/main.ts
+import { provideMushi } from '@mushi-mushi/angular'
+import { Mushi } from '@mushi-mushi/web'
+
+bootstrapApplication(AppComponent, {
+  providers: [
+    provideMushi({ projectId: '${projectId}', apiKey: '${apiKey}' }),
+  ],
+})
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  expo: {
+    id: "expo",
+    label: "Expo",
+    packageName: "@mushi-mushi/react-native",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// App.tsx
+import { MushiProvider } from '@mushi-mushi/react-native'
+
+export default function App() {
+  return (
+    <MushiProvider projectId="${projectId}" apiKey="${apiKey}">
+      <YourApp />
+    </MushiProvider>
+  )
+}`
+  },
+  "react-native": {
+    id: "react-native",
+    label: "React Native",
+    packageName: "@mushi-mushi/react-native",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// App.tsx
+import { MushiProvider } from '@mushi-mushi/react-native'
+
+export default function App() {
+  return (
+    <MushiProvider projectId="${projectId}" apiKey="${apiKey}">
+      <YourApp />
+    </MushiProvider>
+  )
+}`
+  },
+  capacitor: {
+    id: "capacitor",
+    label: "Capacitor (Ionic)",
+    packageName: "@mushi-mushi/capacitor",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// src/main.ts
+import { Mushi } from '@mushi-mushi/capacitor'
+
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  vanilla: {
+    id: "vanilla",
+    label: "Vanilla JS / unknown",
+    packageName: "@mushi-mushi/web",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// Anywhere in your client bundle
+import { Mushi } from '@mushi-mushi/web'
+
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  }
+};
+function readPackageJson(cwd) {
+  const path = join(cwd, "package.json");
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function detectFramework(cwd, pkg) {
+  const deps = collectDeps(pkg);
+  if (deps.has("next")) return FRAMEWORKS.next;
+  if (deps.has("nuxt")) return FRAMEWORKS.nuxt;
+  if (deps.has("@sveltejs/kit")) return FRAMEWORKS.sveltekit;
+  if (deps.has("@angular/core")) return FRAMEWORKS.angular;
+  if (deps.has("expo")) return FRAMEWORKS.expo;
+  if (deps.has("react-native")) return FRAMEWORKS["react-native"];
+  if (deps.has("@capacitor/core")) return FRAMEWORKS.capacitor;
+  if (deps.has("svelte")) return FRAMEWORKS.svelte;
+  if (deps.has("vue")) return FRAMEWORKS.vue;
+  if (deps.has("react")) return FRAMEWORKS.react;
+  if (existsSync(join(cwd, "next.config.js")) || existsSync(join(cwd, "next.config.ts"))) {
+    return FRAMEWORKS.next;
+  }
+  if (existsSync(join(cwd, "nuxt.config.ts")) || existsSync(join(cwd, "nuxt.config.js"))) {
+    return FRAMEWORKS.nuxt;
+  }
+  if (existsSync(join(cwd, "svelte.config.js"))) return FRAMEWORKS.svelte;
+  if (existsSync(join(cwd, "angular.json"))) return FRAMEWORKS.angular;
+  return FRAMEWORKS.vanilla;
+}
+function detectPackageManager(cwd) {
+  if (existsSync(join(cwd, "bun.lockb")) || existsSync(join(cwd, "bun.lock"))) return "bun";
+  if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync(join(cwd, "package-lock.json"))) return "npm";
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  if (userAgent.startsWith("bun")) return "bun";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  return "npm";
+}
+function installCommand(pm, packages) {
+  const verb = pm === "npm" ? "install" : "add";
+  return `${pm} ${verb} ${packages.join(" ")}`;
+}
+function envVarsToWrite(apiKey, projectId, framework) {
+  const prefix = framework.id === "next" ? "NEXT_PUBLIC_" : framework.id === "nuxt" ? "NUXT_PUBLIC_" : "VITE_";
+  return [
+    `${prefix}MUSHI_PROJECT_ID=${projectId}`,
+    `${prefix}MUSHI_API_KEY=${apiKey}`
+  ].join("\n");
+}
+function collectDeps(pkg) {
+  if (!pkg) return /* @__PURE__ */ new Set();
+  return /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.devDependencies ?? {}),
+    ...Object.keys(pkg.peerDependencies ?? {})
+  ]);
+}
+
+export {
+  FRAMEWORKS,
+  readPackageJson,
+  detectFramework,
+  detectPackageManager,
+  installCommand,
+  envVarsToWrite
+};

package/dist/detect.d.ts

@@ -0,0 +1,28 @@
+/**
+ * FILE: packages/cli/src/detect.ts
+ * PURPOSE: Pure detection helpers for framework, package manager, and project state.
+ *          Kept side-effect-free so the wizard remains unit-testable.
+ */
+type FrameworkId = 'next' | 'react' | 'vue' | 'nuxt' | 'svelte' | 'sveltekit' | 'angular' | 'expo' | 'react-native' | 'capacitor' | 'vanilla';
+interface Framework {
+    id: FrameworkId;
+    label: string;
+    packageName: string;
+    needsWebPackage: boolean;
+    snippet: (apiKey: string, projectId: string) => string;
+}
+interface PackageJson {
+    name?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+}
+type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+declare const FRAMEWORKS: Record<FrameworkId, Framework>;
+declare function readPackageJson(cwd: string): PackageJson | null;
+declare function detectFramework(cwd: string, pkg: PackageJson | null): Framework;
+declare function detectPackageManager(cwd: string): PackageManager;
+declare function installCommand(pm: PackageManager, packages: string[]): string;
+declare function envVarsToWrite(apiKey: string, projectId: string, framework: Framework): string;
+
+export { FRAMEWORKS, type Framework, type FrameworkId, type PackageJson, type PackageManager, detectFramework, detectPackageManager, envVarsToWrite, installCommand, readPackageJson };

package/dist/detect.js

@@ -0,0 +1,16 @@
+import {
+  FRAMEWORKS,
+  detectFramework,
+  detectPackageManager,
+  envVarsToWrite,
+  installCommand,
+  readPackageJson
+} from "./chunk-YZOGONU4.js";
+export {
+  FRAMEWORKS,
+  detectFramework,
+  detectPackageManager,
+  envVarsToWrite,
+  installCommand,
+  readPackageJson
+};

package/dist/index.js

@@ -20,6 +20,393 @@ function saveConfig(config, path = CONFIG_PATH) {
   writeFileSync(path, JSON.stringify(config, null, 2));
 }
 
+// src/init.ts
+import * as p from "@clack/prompts";
+import { spawn } from "child_process";
+import { appendFileSync, existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
+
+// src/detect.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+var FRAMEWORKS = {
+  next: {
+    id: "next",
+    label: "Next.js",
+    packageName: "@mushi-mushi/react",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// app/providers.tsx (or pages/_app.tsx for /pages router)
+'use client'
+import { MushiProvider } from '@mushi-mushi/react'
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <MushiProvider config={{
+      projectId: '${projectId}',
+      apiKey: '${apiKey}',
+    }}>
+      {children}
+    </MushiProvider>
+  )
+}`
+  },
+  react: {
+    id: "react",
+    label: "React",
+    packageName: "@mushi-mushi/react",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// src/main.tsx
+import { MushiProvider } from '@mushi-mushi/react'
+
+createRoot(document.getElementById('root')!).render(
+  <MushiProvider config={{
+    projectId: '${projectId}',
+    apiKey: '${apiKey}',
+  }}>
+    <App />
+  </MushiProvider>
+)`
+  },
+  vue: {
+    id: "vue",
+    label: "Vue 3",
+    packageName: "@mushi-mushi/vue",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/main.ts
+import { MushiPlugin } from '@mushi-mushi/vue'
+import { Mushi } from '@mushi-mushi/web'
+
+app.use(MushiPlugin, { projectId: '${projectId}', apiKey: '${apiKey}' })
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  nuxt: {
+    id: "nuxt",
+    label: "Nuxt",
+    packageName: "@mushi-mushi/vue",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// plugins/mushi.client.ts
+import { MushiPlugin } from '@mushi-mushi/vue'
+import { Mushi } from '@mushi-mushi/web'
+
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.vueApp.use(MushiPlugin, {
+    projectId: '${projectId}',
+    apiKey: '${apiKey}',
+  })
+  Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })
+})`
+  },
+  svelte: {
+    id: "svelte",
+    label: "Svelte",
+    packageName: "@mushi-mushi/svelte",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/main.ts (or +layout.svelte for SvelteKit)
+import { initMushi } from '@mushi-mushi/svelte'
+import { Mushi } from '@mushi-mushi/web'
+
+initMushi({ projectId: '${projectId}', apiKey: '${apiKey}' })
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  sveltekit: {
+    id: "sveltekit",
+    label: "SvelteKit",
+    packageName: "@mushi-mushi/svelte",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/routes/+layout.svelte
+<script>
+  import { onMount } from 'svelte'
+  import { initMushi } from '@mushi-mushi/svelte'
+
+  onMount(async () => {
+    const { Mushi } = await import('@mushi-mushi/web')
+    initMushi({ projectId: '${projectId}', apiKey: '${apiKey}' })
+    Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })
+  })
+</script>`
+  },
+  angular: {
+    id: "angular",
+    label: "Angular",
+    packageName: "@mushi-mushi/angular",
+    needsWebPackage: true,
+    snippet: (apiKey, projectId) => `// src/main.ts
+import { provideMushi } from '@mushi-mushi/angular'
+import { Mushi } from '@mushi-mushi/web'
+
+bootstrapApplication(AppComponent, {
+  providers: [
+    provideMushi({ projectId: '${projectId}', apiKey: '${apiKey}' }),
+  ],
+})
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  expo: {
+    id: "expo",
+    label: "Expo",
+    packageName: "@mushi-mushi/react-native",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// App.tsx
+import { MushiProvider } from '@mushi-mushi/react-native'
+
+export default function App() {
+  return (
+    <MushiProvider projectId="${projectId}" apiKey="${apiKey}">
+      <YourApp />
+    </MushiProvider>
+  )
+}`
+  },
+  "react-native": {
+    id: "react-native",
+    label: "React Native",
+    packageName: "@mushi-mushi/react-native",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// App.tsx
+import { MushiProvider } from '@mushi-mushi/react-native'
+
+export default function App() {
+  return (
+    <MushiProvider projectId="${projectId}" apiKey="${apiKey}">
+      <YourApp />
+    </MushiProvider>
+  )
+}`
+  },
+  capacitor: {
+    id: "capacitor",
+    label: "Capacitor (Ionic)",
+    packageName: "@mushi-mushi/capacitor",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// src/main.ts
+import { Mushi } from '@mushi-mushi/capacitor'
+
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  },
+  vanilla: {
+    id: "vanilla",
+    label: "Vanilla JS / unknown",
+    packageName: "@mushi-mushi/web",
+    needsWebPackage: false,
+    snippet: (apiKey, projectId) => `// Anywhere in your client bundle
+import { Mushi } from '@mushi-mushi/web'
+
+Mushi.init({ projectId: '${projectId}', apiKey: '${apiKey}' })`
+  }
+};
+function readPackageJson(cwd) {
+  const path = join2(cwd, "package.json");
+  if (!existsSync2(path)) return null;
+  try {
+    return JSON.parse(readFileSync2(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function detectFramework(cwd, pkg) {
+  const deps = collectDeps(pkg);
+  if (deps.has("next")) return FRAMEWORKS.next;
+  if (deps.has("nuxt")) return FRAMEWORKS.nuxt;
+  if (deps.has("@sveltejs/kit")) return FRAMEWORKS.sveltekit;
+  if (deps.has("@angular/core")) return FRAMEWORKS.angular;
+  if (deps.has("expo")) return FRAMEWORKS.expo;
+  if (deps.has("react-native")) return FRAMEWORKS["react-native"];
+  if (deps.has("@capacitor/core")) return FRAMEWORKS.capacitor;
+  if (deps.has("svelte")) return FRAMEWORKS.svelte;
+  if (deps.has("vue")) return FRAMEWORKS.vue;
+  if (deps.has("react")) return FRAMEWORKS.react;
+  if (existsSync2(join2(cwd, "next.config.js")) || existsSync2(join2(cwd, "next.config.ts"))) {
+    return FRAMEWORKS.next;
+  }
+  if (existsSync2(join2(cwd, "nuxt.config.ts")) || existsSync2(join2(cwd, "nuxt.config.js"))) {
+    return FRAMEWORKS.nuxt;
+  }
+  if (existsSync2(join2(cwd, "svelte.config.js"))) return FRAMEWORKS.svelte;
+  if (existsSync2(join2(cwd, "angular.json"))) return FRAMEWORKS.angular;
+  return FRAMEWORKS.vanilla;
+}
+function detectPackageManager(cwd) {
+  if (existsSync2(join2(cwd, "bun.lockb")) || existsSync2(join2(cwd, "bun.lock"))) return "bun";
+  if (existsSync2(join2(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync2(join2(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync2(join2(cwd, "package-lock.json"))) return "npm";
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  if (userAgent.startsWith("bun")) return "bun";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  return "npm";
+}
+function installCommand(pm, packages) {
+  const verb = pm === "npm" ? "install" : "add";
+  return `${pm} ${verb} ${packages.join(" ")}`;
+}
+function envVarsToWrite(apiKey, projectId, framework) {
+  const prefix = framework.id === "next" ? "NEXT_PUBLIC_" : framework.id === "nuxt" ? "NUXT_PUBLIC_" : "VITE_";
+  return [
+    `${prefix}MUSHI_PROJECT_ID=${projectId}`,
+    `${prefix}MUSHI_API_KEY=${apiKey}`
+  ].join("\n");
+}
+function collectDeps(pkg) {
+  if (!pkg) return /* @__PURE__ */ new Set();
+  return /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.devDependencies ?? {}),
+    ...Object.keys(pkg.peerDependencies ?? {})
+  ]);
+}
+
+// src/init.ts
+var ENV_FILES = [".env.local", ".env"];
+async function runInit(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  p.intro("\u{1F41B} Mushi Mushi setup wizard");
+  const pkg = readPackageJson(cwd);
+  if (!pkg) {
+    p.log.warn("No package.json found in this directory.");
+    const cont = await p.confirm({
+      message: "Continue anyway? (Mushi will install into the current folder)",
+      initialValue: false
+    });
+    if (p.isCancel(cont) || !cont) {
+      p.cancel("Aborted. Run from your project root and try again.");
+      process.exit(0);
+    }
+  }
+  const detected = detectFramework(cwd, pkg);
+  const framework = await chooseFramework(detected, options);
+  const credentials = await collectCredentials(options);
+  const pm = detectPackageManager(cwd);
+  const packagesToInstall = framework.needsWebPackage ? [framework.packageName, "@mushi-mushi/web"] : [framework.packageName];
+  if (!options.skipInstall) {
+    await installPackages(pm, packagesToInstall);
+  } else {
+    p.log.info(`Skipped install. Run \`${installCommand(pm, packagesToInstall)}\` yourself.`);
+  }
+  writeEnvFile(cwd, credentials.apiKey, credentials.projectId, framework);
+  persistCliConfig(credentials.apiKey, credentials.projectId);
+  printNextSteps(framework, credentials.apiKey, credentials.projectId);
+  p.outro("Setup complete. Happy bug squashing \u{1F41B}");
+}
+async function chooseFramework(detected, options) {
+  if (options.framework) {
+    const explicit = FRAMEWORKS[options.framework];
+    if (!explicit) throw new Error(`Unknown framework: ${options.framework}`);
+    p.log.step(`Using framework: ${explicit.label} (from --framework)`);
+    return explicit;
+  }
+  if (options.yes) {
+    p.log.step(`Detected ${detected.label} \u2192 installing ${detected.packageName}`);
+    return detected;
+  }
+  const confirmed = await p.select({
+    message: `Detected ${detected.label}. Use this?`,
+    initialValue: detected.id,
+    options: Object.values(FRAMEWORKS).map((fw) => ({
+      value: fw.id,
+      label: `${fw.id === detected.id ? "\u2713 " : "  "}${fw.label}`,
+      hint: fw.packageName
+    }))
+  });
+  if (p.isCancel(confirmed)) {
+    p.cancel("Aborted.");
+    process.exit(0);
+  }
+  return FRAMEWORKS[confirmed];
+}
+async function collectCredentials(options) {
+  const existing = loadConfig();
+  const projectId = options.projectId ?? existing.projectId ?? await promptText({
+    message: "Project ID",
+    placeholder: "proj_xxxxxxxxxxxx",
+    hint: "Find this at https://kensaur.us/mushi-mushi/projects"
+  });
+  const apiKey = options.apiKey ?? existing.apiKey ?? await promptText({
+    message: "API key",
+    placeholder: "mushi_xxxxxxxxxxxx",
+    hint: "Treat this like a password \u2014 it goes in your env file, not in source."
+  });
+  return { projectId, apiKey };
+}
+async function promptText(opts) {
+  const value = await p.text({
+    message: opts.message,
+    placeholder: opts.placeholder,
+    validate: (v) => v.length === 0 ? "Required" : void 0
+  });
+  if (p.isCancel(value)) {
+    p.cancel("Aborted.");
+    process.exit(0);
+  }
+  if (opts.hint) p.log.info(opts.hint);
+  return value;
+}
+async function installPackages(pm, packages) {
+  const command = installCommand(pm, packages);
+  const spinner2 = p.spinner();
+  spinner2.start(`Installing ${packages.join(", ")} via ${pm}\u2026`);
+  try {
+    await runCommand(pm, packages);
+    spinner2.stop(`Installed ${packages.join(", ")}`);
+  } catch (err) {
+    spinner2.stop(`Install failed \u2014 run \`${command}\` manually.`);
+    p.log.error(err instanceof Error ? err.message : String(err));
+  }
+}
+function runCommand(pm, packages) {
+  return new Promise((resolve, reject) => {
+    const verb = pm === "npm" ? "install" : "add";
+    const child = spawn(pm, [verb, ...packages], { stdio: "inherit", shell: true });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${pm} exited with code ${code}`));
+    });
+  });
+}
+function writeEnvFile(cwd, apiKey, projectId, framework) {
+  const target = ENV_FILES.find((f) => existsSync3(join3(cwd, f))) ?? ENV_FILES[0];
+  const targetPath = join3(cwd, target);
+  const newVars = envVarsToWrite(apiKey, projectId, framework);
+  const existing = existsSync3(targetPath) ? readFileSync3(targetPath, "utf-8") : "";
+  if (existing.includes("MUSHI_PROJECT_ID")) {
+    p.log.warn(`Existing MUSHI_* vars found in ${target} \u2014 leaving them untouched.`);
+    return;
+  }
+  const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  appendFileSync(targetPath, `${prefix}
+# Mushi Mushi
+${newVars}
+`);
+  if (!existing) {
+    writeFileSync2(targetPath, readFileSync3(targetPath, "utf-8"));
+  }
+  p.log.success(`Wrote env vars to ${target}`);
+  warnIfMissingFromGitignore(cwd, target);
+}
+function warnIfMissingFromGitignore(cwd, envFile) {
+  const gitignorePath = join3(cwd, ".gitignore");
+  if (!existsSync3(gitignorePath)) {
+    p.log.warn(`No .gitignore found \u2014 make sure ${envFile} is not committed.`);
+    return;
+  }
+  const content = readFileSync3(gitignorePath, "utf-8");
+  if (!content.split("\n").some((line) => line.trim() === envFile || line.trim() === ".env*")) {
+    p.log.warn(`${envFile} is not in .gitignore \u2014 add it before committing.`);
+  }
+}
+function persistCliConfig(apiKey, projectId) {
+  const existing = loadConfig();
+  saveConfig({ ...existing, apiKey, projectId });
+}
+function printNextSteps(framework, apiKey, projectId) {
+  p.note(framework.snippet(apiKey, projectId), "Add this to your app:");
+  p.log.message("Verify the install:");
+  p.log.message("  \u2022 Start your dev server");
+  p.log.message("  \u2022 Look for the \u{1F41B} button in the bottom-right corner (or shake on mobile)");
+  p.log.message("  \u2022 Submit a test report \u2014 it should appear at https://kensaur.us/mushi-mushi/reports");
+}
+
 // src/index.ts
 async function apiCall(path, config, options = {}) {
   const endpoint = config.endpoint ?? "https://api.mushimushi.dev";
@@ -35,7 +422,16 @@ async function apiCall(path, config, options = {}) {
   });
   return res.json();
 }
-var program = new Command().name("mushi").description("Mushi Mushi CLI \u2014 manage bug reports and pipeline").version("0.0.1");
+var program = new Command().name("mushi").description("Mushi Mushi CLI \u2014 set up the SDK, manage bug reports, monitor pipeline").version("0.3.0");
+program.command("init").description("Set up the Mushi Mushi SDK in this project (auto-detects framework)").option("--project-id <id>", "Skip the prompt by passing the project ID").option("--api-key <key>", "Skip the prompt by passing the API key").option("--framework <id>", "Force a framework (next, react, vue, nuxt, svelte, sveltekit, angular, expo, react-native, capacitor, vanilla)").option("--skip-install", "Don't auto-install the SDK package \u2014 print the command instead").option("-y, --yes", "Accept detected framework without prompting").action(async (opts) => {
+  await runInit({
+    projectId: opts.projectId,
+    apiKey: opts.apiKey,
+    framework: opts.framework,
+    skipInstall: opts.skipInstall,
+    yes: opts.yes
+  });
+});
 program.command("login").description("Store API key for authentication").requiredOption("--api-key <key>", "API key").option("--endpoint <url>", "API endpoint URL").option("--project-id <id>", "Default project ID").action((opts) => {
   const config = loadConfig();
   config.apiKey = opts.apiKey;

package/dist/init.d.ts

@@ -0,0 +1,22 @@
+import { FrameworkId } from './detect.js';
+
+/**
+ * FILE: packages/cli/src/init.ts
+ * PURPOSE: `mushi init` wizard — detects framework, asks for credentials,
+ *          installs the right SDK, writes env vars, prints next-step snippet.
+ *
+ * Modeled on the Sentry / PostHog wizard pattern: one shell command, minimal
+ * prompts, transparent about every file it touches.
+ */
+
+interface InitOptions {
+    cwd?: string;
+    projectId?: string;
+    apiKey?: string;
+    framework?: FrameworkId;
+    skipInstall?: boolean;
+    yes?: boolean;
+}
+declare function runInit(options?: InitOptions): Promise<void>;
+
+export { type InitOptions, runInit };

package/dist/init.js

@@ -0,0 +1,185 @@
+import {
+  FRAMEWORKS,
+  detectFramework,
+  detectPackageManager,
+  envVarsToWrite,
+  installCommand,
+  readPackageJson
+} from "./chunk-YZOGONU4.js";
+
+// src/init.ts
+import * as p from "@clack/prompts";
+import { spawn } from "child_process";
+import { appendFileSync, existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2 } from "path";
+
+// src/config.ts
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var CONFIG_PATH = join(homedir(), ".mushirc");
+function loadConfig(path = CONFIG_PATH) {
+  if (!existsSync(path)) return {};
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveConfig(config, path = CONFIG_PATH) {
+  writeFileSync(path, JSON.stringify(config, null, 2));
+}
+
+// src/init.ts
+var ENV_FILES = [".env.local", ".env"];
+async function runInit(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  p.intro("\u{1F41B} Mushi Mushi setup wizard");
+  const pkg = readPackageJson(cwd);
+  if (!pkg) {
+    p.log.warn("No package.json found in this directory.");
+    const cont = await p.confirm({
+      message: "Continue anyway? (Mushi will install into the current folder)",
+      initialValue: false
+    });
+    if (p.isCancel(cont) || !cont) {
+      p.cancel("Aborted. Run from your project root and try again.");
+      process.exit(0);
+    }
+  }
+  const detected = detectFramework(cwd, pkg);
+  const framework = await chooseFramework(detected, options);
+  const credentials = await collectCredentials(options);
+  const pm = detectPackageManager(cwd);
+  const packagesToInstall = framework.needsWebPackage ? [framework.packageName, "@mushi-mushi/web"] : [framework.packageName];
+  if (!options.skipInstall) {
+    await installPackages(pm, packagesToInstall);
+  } else {
+    p.log.info(`Skipped install. Run \`${installCommand(pm, packagesToInstall)}\` yourself.`);
+  }
+  writeEnvFile(cwd, credentials.apiKey, credentials.projectId, framework);
+  persistCliConfig(credentials.apiKey, credentials.projectId);
+  printNextSteps(framework, credentials.apiKey, credentials.projectId);
+  p.outro("Setup complete. Happy bug squashing \u{1F41B}");
+}
+async function chooseFramework(detected, options) {
+  if (options.framework) {
+    const explicit = FRAMEWORKS[options.framework];
+    if (!explicit) throw new Error(`Unknown framework: ${options.framework}`);
+    p.log.step(`Using framework: ${explicit.label} (from --framework)`);
+    return explicit;
+  }
+  if (options.yes) {
+    p.log.step(`Detected ${detected.label} \u2192 installing ${detected.packageName}`);
+    return detected;
+  }
+  const confirmed = await p.select({
+    message: `Detected ${detected.label}. Use this?`,
+    initialValue: detected.id,
+    options: Object.values(FRAMEWORKS).map((fw) => ({
+      value: fw.id,
+      label: `${fw.id === detected.id ? "\u2713 " : "  "}${fw.label}`,
+      hint: fw.packageName
+    }))
+  });
+  if (p.isCancel(confirmed)) {
+    p.cancel("Aborted.");
+    process.exit(0);
+  }
+  return FRAMEWORKS[confirmed];
+}
+async function collectCredentials(options) {
+  const existing = loadConfig();
+  const projectId = options.projectId ?? existing.projectId ?? await promptText({
+    message: "Project ID",
+    placeholder: "proj_xxxxxxxxxxxx",
+    hint: "Find this at https://kensaur.us/mushi-mushi/projects"
+  });
+  const apiKey = options.apiKey ?? existing.apiKey ?? await promptText({
+    message: "API key",
+    placeholder: "mushi_xxxxxxxxxxxx",
+    hint: "Treat this like a password \u2014 it goes in your env file, not in source."
+  });
+  return { projectId, apiKey };
+}
+async function promptText(opts) {
+  const value = await p.text({
+    message: opts.message,
+    placeholder: opts.placeholder,
+    validate: (v) => v.length === 0 ? "Required" : void 0
+  });
+  if (p.isCancel(value)) {
+    p.cancel("Aborted.");
+    process.exit(0);
+  }
+  if (opts.hint) p.log.info(opts.hint);
+  return value;
+}
+async function installPackages(pm, packages) {
+  const command = installCommand(pm, packages);
+  const spinner2 = p.spinner();
+  spinner2.start(`Installing ${packages.join(", ")} via ${pm}\u2026`);
+  try {
+    await runCommand(pm, packages);
+    spinner2.stop(`Installed ${packages.join(", ")}`);
+  } catch (err) {
+    spinner2.stop(`Install failed \u2014 run \`${command}\` manually.`);
+    p.log.error(err instanceof Error ? err.message : String(err));
+  }
+}
+function runCommand(pm, packages) {
+  return new Promise((resolve, reject) => {
+    const verb = pm === "npm" ? "install" : "add";
+    const child = spawn(pm, [verb, ...packages], { stdio: "inherit", shell: true });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${pm} exited with code ${code}`));
+    });
+  });
+}
+function writeEnvFile(cwd, apiKey, projectId, framework) {
+  const target = ENV_FILES.find((f) => existsSync2(join2(cwd, f))) ?? ENV_FILES[0];
+  const targetPath = join2(cwd, target);
+  const newVars = envVarsToWrite(apiKey, projectId, framework);
+  const existing = existsSync2(targetPath) ? readFileSync2(targetPath, "utf-8") : "";
+  if (existing.includes("MUSHI_PROJECT_ID")) {
+    p.log.warn(`Existing MUSHI_* vars found in ${target} \u2014 leaving them untouched.`);
+    return;
+  }
+  const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  appendFileSync(targetPath, `${prefix}
+# Mushi Mushi
+${newVars}
+`);
+  if (!existing) {
+    writeFileSync2(targetPath, readFileSync2(targetPath, "utf-8"));
+  }
+  p.log.success(`Wrote env vars to ${target}`);
+  warnIfMissingFromGitignore(cwd, target);
+}
+function warnIfMissingFromGitignore(cwd, envFile) {
+  const gitignorePath = join2(cwd, ".gitignore");
+  if (!existsSync2(gitignorePath)) {
+    p.log.warn(`No .gitignore found \u2014 make sure ${envFile} is not committed.`);
+    return;
+  }
+  const content = readFileSync2(gitignorePath, "utf-8");
+  if (!content.split("\n").some((line) => line.trim() === envFile || line.trim() === ".env*")) {
+    p.log.warn(`${envFile} is not in .gitignore \u2014 add it before committing.`);
+  }
+}
+function persistCliConfig(apiKey, projectId) {
+  const existing = loadConfig();
+  saveConfig({ ...existing, apiKey, projectId });
+}
+function printNextSteps(framework, apiKey, projectId) {
+  p.note(framework.snippet(apiKey, projectId), "Add this to your app:");
+  p.log.message("Verify the install:");
+  p.log.message("  \u2022 Start your dev server");
+  p.log.message("  \u2022 Look for the \u{1F41B} button in the bottom-right corner (or shake on mobile)");
+  p.log.message("  \u2022 Submit a test report \u2014 it should appear at https://kensaur.us/mushi-mushi/reports");
+}
+export {
+  runInit
+};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@mushi-mushi/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "license": "MIT",
-  "description": "CLI tool for Mushi Mushi — project management, report triage, pipeline health",
+  "description": "CLI for Mushi Mushi — `mushi init` wizard installs the right SDK for your framework, plus report triage and pipeline health commands",
   "bin": {
     "mushi": "./dist/index.js"
   },
   "dependencies": {
+    "@clack/prompts": "^0.11.0",
     "commander": "^14.0.3"
   },
   "devDependencies": {
@@ -39,17 +40,43 @@
   "keywords": [
     "mushi-mushi",
     "bug-reporting",
-    "sdk"
+    "user-feedback",
+    "session-replay",
+    "screenshot",
+    "shake-to-report",
+    "sdk",
+    "wizard",
+    "setup",
+    "cli",
+    "init",
+    "next.js",
+    "nextjs",
+    "react",
+    "vue",
+    "nuxt",
+    "svelte",
+    "sveltekit",
+    "angular",
+    "react-native",
+    "expo",
+    "capacitor",
+    "sentry-companion",
+    "error-tracking"
   ],
   "exports": {
     ".": {
+      "import": "./dist/index.js"
+    },
+    "./init": {
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
+        "types": "./dist/init.d.ts",
+        "default": "./dist/init.js"
+      }
+    },
+    "./detect": {
+      "import": {
+        "types": "./dist/detect.d.ts",
+        "default": "./dist/detect.js"
       }
     }
   },