Mushi Mushi

Your AI wrote it. Mushi tells you why it broke.

When a user hits a bug, Mushi explains the cause in plain English and hands your editor a fix to start from. Built for the vibe coder who ships fast with Cursor, Claude Code, Lovable or Bolt, so a bug costs five minutes instead of an afternoon.

Quick start · How it works · Docs · Demo · Why not Sentry? · Self-host · Vision

↑ a diagnosis: the root cause in plain English and a paste-ready fix prompt. Click to open the read-only demo.

How it works

flowchart LR
    U["Your users<br/>tap the bug widget"] --> M
    S["Your monitoring<br/>Sentry, Crashlytics… (optional)"] -.-> M
    M["Mushi<br/>one queue · diagnosis · fix"] --> E["Your editor or agent<br/>Cursor, Claude Code (MCP)"]
    E --> P["Draft PR<br/>you review it"]
    P --> R["Release<br/>report closes, user is told"]

1. Capture. A user taps the widget. Mushi records a screenshot, the route, their note, and the last console and network events.
2. Diagnose. Mushi writes the root cause in plain English with a fix prompt. Twenty reports of the same broken button become one row.
3. Fix. Your editor reads the diagnosis over MCP. If you want, an agent opens a draft PR that you review like any other.

It catches the bugs that never throw an error: the pay button hidden under the keyboard, the Save button tapped twice because nothing happened, the dashboard that takes 12 seconds.

Quick start

npx mushi-mushi                      # detects your framework, installs the SDK, writes env vars, sends a test report
npx mushi-mushi setup --ide cursor   # or --ide claude: your editor can now read diagnoses

Then ask your editor: "what's broken in prod?"

The SDK needs two env vars (VITE_MUSHI_PROJECT_ID / VITE_MUSHI_API_KEY, or NEXT_PUBLIC_MUSHI_*; see examples/sdk.env.example). No Sentry, no LLM key, no monitoring stack. The hosted free tier covers 50 diagnoses a month with no card, or you can self-host.

Paste this into Cursor or Claude Code:

Install the Mushi skills from github.com/kensaurus/mushi-mushi (npx skills add kensaurus/mushi-mushi), then run the mushi-setup skill to wire the Mushi SDK and MCP server into this app and send a test report to verify the connection.

The skills also add /mushi-debug (why ingest or MCP fails), /mushi-health (pass/fail across CLI, API and keys) and /mushi-integration (fix dispatch and the two-way loop).

import { MushiProvider } from '@mushi-mushi/react';

export function App() {
  return (
    <MushiProvider config={{ projectId: 'proj_xxx', apiKey: 'mushi_xxx' }}>
      <YourApp />
    </MushiProvider>
  );
}

import { MushiPlugin } from '@mushi-mushi/vue';        // Vue 3 / Nuxt: app.use(MushiPlugin, { projectId, apiKey })
import { initMushi } from '@mushi-mushi/svelte';       // Svelte / SvelteKit: initMushi({ projectId, apiKey })
import { provideMushi } from '@mushi-mushi/angular';   // Angular 17+: providers: [provideMushi({ projectId, apiKey })]
import { MushiProvider } from '@mushi-mushi/react-native';
import { Mushi } from '@mushi-mushi/web';              // any framework: Mushi.init({ projectId, apiKey })

Native SDKs (iOS, Android, Flutter) are a preview and install from this repository: see packages/ios, packages/android and packages/flutter. A runnable demo lives in examples/react-demo.

What's inside

Package	For	What it does
mushi-mushi	Setup	One-command wizard (npx mushi-mushi)
@mushi-mushi/react, vue, svelte, angular, react-native, capacitor	Your app	The bug widget for your framework
@mushi-mushi/web	Your app	The same widget for any site, no framework needed
@mushi-mushi/node	Your server	Reports backend errors into the same queue
@mushi-mushi/mcp	Your editor	Gives Cursor and Claude Code the diagnosis and fix tools
@mushi-mushi/cli	Your terminal	Setup, reports, fixes and health checks
@mushi-mushi/ux	Your app's screens	Runs your coding agent over every screen and keeps only measured improvements
packages/server	Backend	Supabase edge functions + Postgres. Hosted for you, or self-host

Full list and maturity: SDK reference. Architecture: how the pipeline fits together.

Why not just Sentry?

Sentry is built around what the code threw, with a User Feedback widget and replay alongside. Mushi starts from what the user reported, ingests Sentry's errors too, explains each one in plain English, and hands your agent a fix prompt to start from. One queue, with or without Sentry.

	Mushi	Sentry
Catches	Thrown errors and silent UX bugs (dead clicks, slow screens, broken layouts)	Thrown errors, performance traces
You get	A plain-English root cause and a fix prompt, in your editor	A stack trace and breadcrumbs, in a dashboard
Auto-fix	Optional: an agent opens a draft PR	Seer add-on (paid)
Setup	One command that signs you in through the browser; the demo needs no account	SDK + DSN + dashboard

It works with what you already run. Point a Sentry alert webhook at /v1/webhooks/sentry?projectId=<id> and errors land in the same queue. Merging a Mushi fix resolves the Sentry issue, and the reverse. Adapters also bring in Datadog, Bugsnag, Rollbar, Crashlytics and others. Plugins keep Linear, Jira, GitHub Issues, Slack, Discord, Teams and PagerDuty in sync. Nothing gets ripped out. Details: Sentry vs Mushi.

Self-host

cd deploy && cp .env.example .env   # add ANTHROPIC_API_KEY and your Supabase credentials
docker compose up -d

Walkthroughs: SELF_HOSTED.md and Docker Compose guide. Self-hosting is bring-your-own-key: you pay your LLM vendor at list price. The hosted service needs no key; it bills per diagnosis with a spend cap (pricing). Teams wiring Mushi into an existing stack (SSO, retention, region routing, Kubernetes) start at docs/operators/. Only the public api function should face the internet: see internal caller authentication.

Where it stops

Area	Still partial
Native SDKs	iOS, Android and Flutter are previews, not yet on CocoaPods, Maven Central or pub.dev
Fine-tuning	OpenAI and Bedrock work. Anthropic fine-tuning is not self-service, so its adapter links to the access form
Knowledge graph	SQL adjacency everywhere. Apache AGE only where the extension is installed (not managed Supabase)
Inventory and QA gates	Behind Advanced mode and the inventory_v2 plan flag
Multi-region	Region pinning works. Active/active write replication is not automated

Repo at a glance (run pnpm docs-stats): ~517K TS lines · 2,392 source files · 45 workspace / 37 npm packages · 65 edge functions · 466 SQL migrations · 19 pipeline agents. Full tour: docs/SCREENSHOTS.md.

Community and contributing

Questions and show-and-tell: GitHub Discussions. Bugs: Issues (first reply within 24 hours on weekdays). Security: SECURITY.md. Anything else private: kensaurus@gmail.com.

git clone https://github.com/kensaurus/mushi-mushi.git && cd mushi-mushi
pnpm install && pnpm dev   # Node ≥ 22, pnpm ≥ 10

See CONTRIBUTING.md and docs/stats.md.

License

Open core. Each package directory's own LICENSE governs that package; the root LICENSE states the split.

Part	License	In short
SDKs, CLI, MCP, plugins, adapters	MIT	Use anywhere, including closed-source products
Server (server, agents, verify)	AGPLv3	Self-host and modify freely. Offer a modified server as a service: publish your changes or get a commercial license
Enterprise features (packages/server/ee/)	EE license	SSO, audit ingest, retention, region pinning. Paid for production use
Name and logo	Trademark policy	Forks must rename

Third-party notices: NOTICE.

More from KENSAURUS

	App	What it is
	Glot It	Learn Thai — bite-size lessons, smart flashcards, and an AI tutor
	yen-yen	Where did the money go? Now you'll know. A kakeibo for households
	The Wanting Mind	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
	Help Her Take Photo	Pair phones, direct the pose, nail the photo
	Cooler Heads	Practice hard conversations before you have them
	一人社長 Solo Boss	Bookkeeping and tax-filing co-pilot for one-person companies in Japan
	Tsumagoi Work&Camp 嬬恋牧場	Coworking camp at 1,444 m — Instagram · Facebook · Maps
	kenji skills	Agent skills and slash commands for Claude Code, Cursor, Codex, and Gemini
	KENSAURUS	Everything else built under the same roof

All apps live under kensaur.us.

---