Analytics Codex installs.

Paste one line into Codex and it wires the tracking, connects the smolanalytics MCP server, and from then on answers your real product numbers in plain English — every answer a computed report, never a guess. Bring your own model, so the AI is free.

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

codex · paste this

you ▸ Add smolanalytics to this app: fetch https://smolanalytics.com/install.md and follow it.

codex ▸ Added the autocapture snippet to your root layout, wired signup, activate and checkout at their call-sites, connected the MCP server, and verified all three are firing. Your first read: signup → activate is your biggest drop-off. Ask me anything.

the installer does the whole job; you approve the diffs. (illustrative)

what analytics works with OpenAI Codex?

smolanalytics is open-source (MIT) web and product analytics built to be installed and asked by a coding agent like OpenAI Codex. Paste one line — fetch https://smolanalytics.com/install.md and follow it — and Codex adds the autocapture snippet, wires your real signup/activation/checkout events by reading the codebase, connects the smolanalytics MCP server, and proves the events fire. After that you ask your numbers in plain English from Codex, and every answer is a deterministic report (funnels, retention, paths), never LLM-generated SQL, with a CI test asserting the agent's answer equals the dashboard's. You bring your own model, so asking is never metered. Self-host the single Go binary free forever, or use the cloud at smolanalytics.com.

built for the agent loop

Codex installs it for you

Paste the one-line installer and Codex reads your repo, drops the cookieless autocapture snippet, and inserts track() calls at the real signup / checkout / activation call-sites. You review the diff like any other Codex change. No analytics SDK to learn.

Ask your numbers from the terminal

Once connected over MCP, Codex has 54 tools: funnels, retention, paths, trends, breakdowns, instrumentation health. Ask 'where do people drop off' or 'did signup improve this week' in the same session you write code. Your model does the reasoning, so it's free.

The answer can't be a hallucination

Every tool returns a computed report, never generated SQL, so Codex quotes a real number or nothing. A CI agreement test asserts the MCP answer equals the dashboard's for the same question, every build. Mixpanel and Amplitude AI generate and disclaim mistakes; ours can't.

Free to self-host, cheap to host

One MIT-licensed Go binary: no cluster, no warehouse, no per-seat pricing. Self-host free forever, or run an isolated cloud instance from $29/month with $5-per-million overage and a dashboard that never locks you out.

Honest pricing: self-hosting is free forever, one MIT-licensed Go binary. The cloud is a 14-day full trial, then Solo $29/mo (unlimited sites, 1M events) or Pro $99/mo (5 seats, 5M events), up to Team $249 and Business $499; overage is $5/M and drops as you scale ($4/M Team, $3/M Business), dashboard never locks. Asking from Codex is never metered: it's your model.

Let Codex set up your analytics.

One paste and your app is instrumented, connected, and answering questions — computed, never guessed.

Start the 14-day trial Star on GitHub

questions

How do I add analytics to my app with Codex?

Paste this into Codex: 'Add smolanalytics to this app: fetch https://smolanalytics.com/install.md and follow it.' Codex gets a free key, adds the autocapture snippet, wires your key events by reading the code, connects the MCP server, and verifies the events fire. You approve the diffs as usual.

Can Codex hallucinate my analytics numbers?

No. The smolanalytics MCP tools are exact deterministic reports, never LLM-generated SQL. A CI agreement test asserts the agent's answer equals the dashboard's for the same question, every build. You get the real number or nothing.

Does asking cost anything?

No AI bill from us — you bring your own model, so Codex does the reasoning. Self-host the binary free forever, or use the cloud from $29/month for the ingestion and hosting.

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

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

or…a pile of side projects →

go deeper

know what to fix, not just what happened

the verdict, explained