Your analytics, inside Windsurf.

Ship a feature in Windsurf, then ask Cascade “did it work?” without leaving the editor. One connect command wires the MCP server in; answers are computed from deterministic reports — never generated SQL — and a CI test guarantees the editor's answer equals the dashboard's.

Start the 14-day trial Self-host (free) →

windsurf cascade — /whats-broken-today

you ▸ /whats-broken-today

ai ▸ One thing changed: signup is down 18% vs a typical day (94 vs 115) — started around 14:00. Tracking is healthy: all 6 planned events flowing. Traffic is normal, referrer mix unchanged — this is a product problem, not a tracking problem. Most useful action today: check yesterday's deploy to the signup form.

computed from deterministic reports — not guessed SQL. (demo data)

what analytics works inside Windsurf?

smolanalytics is open-source (MIT) web and product analytics you ask from inside Windsurf. It ships an MCP server, and `smolanalytics connect windsurf` writes it into ~/.codeium/windsurf/mcp_config.json — the file Windsurf reads its MCP servers from — so Cascade can call the tools. Once connected, Windsurf gets 47 tools and 13 built-in prompts (instrument-my-app, whats-broken-today, weekly-review, and more). Answers are computed from exact, deterministic reports — funnels, retention, paths — never LLM-generated SQL, and a CI agreement test asserts the editor's answer always equals the dashboard's for the same question. A plan-as-code gate (`smolanalytics plan check`) fails CI when an event your tracking plan expects stops firing, and it can run against existing PostHog data via --source=posthog before you migrate. You bring your own model, so asking from Cascade is never metered. Self-host the single Go binary free forever, or use the cloud at smolanalytics.com: 14-day full trial, then from $9/month.

built for the agent loop

One command wires it into Cascade

smolanalytics connect windsurf writes the MCP server into ~/.codeium/windsurf/mcp_config.json — the path Windsurf reads MCP from — so Cascade can call it. 47 tools land: funnels, retention, paths, trends, instrumentation health, alerts. No API keys to us; your model does the reasoning, so asking is free.

13 built-in prompts

Type / and pick a routine: instrument-my-app wires tracking on a fresh repo, whats-broken-today is the morning triage, weekly-review is the recap a good cofounder would give you. Each prompt calls the right tools in the right order and gives you the read, not a data dump.

The agreement test

The tools are deterministic reports, never generated SQL — Cascade can't hallucinate a number it never computes. A CI agreement test asserts the MCP answer and the HTTP API answer are identical for the same question, every build. The editor's number is the dashboard's number.

Plan-as-code, gated in CI

Your tracking plan lives in smolanalytics.plan.json. smolanalytics plan check exits 1 when an event the plan expects stops flowing — so instrumentation drift fails the build, not the launch. Already on PostHog? Run it with --source=posthog: same gate, zero migration.

Honest pricing: self-hosting is free forever — one MIT-licensed Go binary. The cloud is a 14-day full trial, then Solo $9/mo (unlimited sites, 250k events) or Pro $29/mo (3 seats, 2M events); overage is $5/million and the dashboard never locks. Asking from Cascade is never metered — it's your model.

Stop alt-tabbing to a dashboard.

Wire it into Windsurf in one command, gate your instrumentation in CI, and get the real number where you already work.

Start the 14-day trial Star on GitHub

questions

How do I connect smolanalytics to Windsurf?

Run smolanalytics connect windsurf once — it writes the MCP server into ~/.codeium/windsurf/mcp_config.json, the file Windsurf reads its MCP servers from, so Cascade can call the tools. You get 47 tools and 13 prompts. No API keys to us: your own model does the reasoning, so asking is never metered.

Can Cascade hallucinate my numbers?

No. The MCP tools are exact, deterministic reports — funnels, retention, paths — never LLM-generated SQL. A CI agreement test asserts the editor's answer and the dashboard's answer are identical for the same question, every build. You get the real number or nothing.

Can I fail CI when my tracking breaks?

Yes. Declare your tracking plan in smolanalytics.plan.json and run smolanalytics plan check in CI — it exits 1 when an event the plan expects stops flowing or a property goes missing. It also works against existing PostHog data with --source=posthog, so you can adopt the gate before migrating anything.

built it in an app builder…Lovable →Bolt →v0 →Replit →Base44 →

you live in an editor…Cursor →Claude Code →GitHub Copilot →

or…a pile of side projects →

go deeper

know what to fix, not just what happened

the verdict, explained