\n\n# mushi-mushi 🐛\n\n> **Your AI wrote it. Mushi tells you why it broke.**\n\nPlain-English diagnosis + a paste-ready fix, right inside Cursor and Claude Code.\n\n**`mushi-mushi` is the one-command setup wizard.** It adds the Mushi SDK to the app you already have, so the next time a user hits a bug their report arrives explained, not as a stack trace to decode.\n\nOne `npx` command. Works with React, Next.js, Vue, Nuxt, Svelte, SvelteKit, Angular, React Native, Expo, Capacitor, and vanilla JS.\n\n[](https://www.npmjs.com/package/mushi-mushi)\n[](https://www.npmjs.com/package/mushi-mushi)\n[](https://github.com/kensaurus/mushi-mushi/blob/master/LICENSE)\n[](https://docs.npmjs.com/generating-provenance-statements)\n[](https://socket.dev/npm/package/mushi-mushi)\n[](https://nodejs.org)\n\n
\n ![\"A](\"https://raw.githubusercontent.com/kensaurus/mushi-mushi/master/docs/screenshots/report-detail-dark.png\")
\n\n\n
↑ a real user report, fully classified and ready to dispatch as a GitHub PR · try the read-only demo, no signup\n\n
\n \n GitHub
Auto-draft PRs
+ Checks API | \n Sentry
Breadcrumb bridge
+ session link | \n Slack
Block Kit
+ /mushi cmd | \n Jira
OAuth 3LO
bidir sync | \n Linear
Issue create
+ status sync | \n PagerDuty
Severity-scoped
escalation | \n
\n \n Discord
Embed messages
per channel | \n MS Teams
Adaptive cards
+ on-call | \n GitHub Issues
Labels
+ assignees | \n Bugsnag
Mirror + close
on fix merge | \n Rollbar
Mirror + resolve
on fix merge | \n Crashlytics
Push reports
+ close | \n
\n \n Zapier
Generic
webhook fan-out | \n Cursor Cloud
Agentic draft
PR dispatch | \n Cursor
via MCP
server | \n Claude Code
via MCP
server | \n OpenAI Agents
via A2A
tasks | \n LangGraph
via A2A
+ MCP | \n
\n
\n\n**11 inbound adapters** — Mushi receives alerts from your existing monitoring and turns them into the same triaged report rows as user-felt bugs:\n\n> Sentry · Datadog · Bugsnag · Rollbar · Firebase Crashlytics · New Relic · Honeycomb · Grafana Loki · AWS CloudWatch · Opsgenie · Firebase Analytics\n\nAll of them ship in [`@mushi-mushi/adapters`](https://www.npmjs.com/package/@mushi-mushi/adapters) — drop them into any Node webhook server (Express / Fastify / Hono / serverless function).\n\n---\n\n## Framework support\n\n| Framework | Install after wizard (automatic) |\n| ------------------------------- | ------------------------------------------------- |\n| React | `@mushi-mushi/react` |\n| Next.js | `@mushi-mushi/react` |\n| Vue 3 / Nuxt | `@mushi-mushi/vue` + `@mushi-mushi/web` |\n| Svelte / SvelteKit | `@mushi-mushi/svelte` + `@mushi-mushi/web` |\n| Angular 17+ | `@mushi-mushi/angular` + `@mushi-mushi/web` |\n| React Native / Expo | `@mushi-mushi/react-native` |\n| Capacitor / Ionic | `@mushi-mushi/capacitor` |\n| Flutter / Dart | Git dependency — preview, not on pub.dev yet ([how](https://github.com/kensaurus/mushi-mushi/tree/master/packages/flutter#install)) |\n| iOS native (Swift) | SwiftPM from the repo — preview, not tagged yet ([how](https://github.com/kensaurus/mushi-mushi/tree/master/packages/ios#install)) |\n| Android native (Kotlin/Java) | Build from source — preview, not on Maven Central yet ([how](https://github.com/kensaurus/mushi-mushi/tree/master/packages/android#install)) |\n| Node (Express / Fastify / Hono) | `@mushi-mushi/node` (server-side error capture) |\n| Vanilla JS | `@mushi-mushi/web` |\n\nPrefer to skip the wizard? `npm i @mushi-mushi/react` (or your framework's package) and wire it up by hand.\n\n---\n\n## How the pipeline works\n\n```\nUser hits widget ──▶ screenshot + console + network + intent\n │\n ▼\n Fast-filter (Haiku) ──▶ drops spam, keeps signal\n │\n ▼\n Deep classify (Sonnet + vision + RAG) ──▶ category, severity, component\n │\n ▼\n Dedup (pgvector) ──▶ groups repeat reports by meaning\n │\n ▼\n Judge (weekly) ──▶ scores classifier, retrains prompts\n │\n ▼\n \"Dispatch fix\" ──▶ agent opens a GitHub PR with Playwright replay + visual diff\n```\n\nSee the full loop in the [root README](https://github.com/kensaurus/mushi-mushi#the-diagnosis-loop).\n\n---\n\n## 30-second quick start\n\n```bash\n# 1. Drop the wizard in (or one of the equivalents below)\nnpx mushi-mushi\n\n# equivalents:\nnpm create mushi-mushi\nnpx @mushi-mushi/cli init\n```\n\n![\"\"](\"https://kensaur.us/glot-it/icon-512.png\"){kind=icon}
| [Glot It](https://kensaur.us/glot-it/?utm_source=github&utm_medium=readme) | Learn Thai — bite-size lessons, smart flashcards, and an AI tutor |\n| ![\"\"](\"https://kensaur.us/yen-yen/icon.svg\"){kind=icon}
| [yen-yen](https://kensaur.us/yen-yen/?utm_source=github&utm_medium=readme) | Where did the money go? Now you'll know. A kakeibo for households |\n| ![\"\"](\"https://kensaur.us/the-wanting-mind/pwa-512x512.png\")
| [The Wanting Mind](https://kensaur.us/the-wanting-mind/?utm_source=github&utm_medium=readme) | How the Battle Between Extraction and Generation Is Reshaping Our World — a 147,000-word interactive webbook with 268 concepts, 242 citations, and original illustrations |\n| ![\"\"](\"https://kensaur.us/help-her-take-photo/assets/apple-touch-icon.png\"){kind=icon}
| [Help Her Take Photo](https://kensaur.us/help-her-take-photo/?utm_source=github&utm_medium=readme) | Pair phones, direct the pose, nail the photo |\n| ![\"\"](\"https://talk.kensaur.us/pwa-192.png\")
| [Cooler Heads](https://talk.kensaur.us/?utm_source=github&utm_medium=readme) | Practice hard conversations before you have them |\n| ![\"\"](\"https://solo-boss.kensaur.us/apple-touch-icon.png\"){kind=icon}
| [一人社長 Solo Boss](https://solo-boss.kensaur.us/?utm_source=github&utm_medium=readme) | Bookkeeping and tax-filing co-pilot for one-person companies in Japan |\n| ![\"\"](\"https://tsumagoi.kensaur.us/apple-touch-icon.png\"){kind=icon}
| [Tsumagoi Work&Camp 嬬恋牧場](https://tsumagoi.kensaur.us/?utm_source=github&utm_medium=readme) | Coworking camp at 1,444 m — [Instagram](https://www.instagram.com/tsumagoicamp/) · [Facebook](https://www.facebook.com/profile.php?id=61592113053042) · [Maps](https://maps.app.goo.gl/JCNnTfsdQVHCS1FA7) |\n| ![\"\"](\"https://github.com/kensaurus.png\")
| [kenji skills](https://github.com/kensaurus/skills) | Agent skills and slash commands for Claude Code, Cursor, Codex, and Gemini |\n| ![\"\"](\"https://kensaur.us/favicon.svg\")
| [KENSAURUS](https://kensaur.us/?view=portfolio&utm_source=github&utm_medium=readme) | Everything else built under the same roof |\n\nAll apps live under [kensaur.us](https://kensaur.us).\n\n\n\n---\n\nMonorepo scale (July 2026): 64 edge functions · 410 SQL migrations · 13 outbound plugins · 11 inbound adapters · 19 pipeline agents. Canonical counts: docs/stats.md ·