Analytics Agent

Analytics Agent

**Give your AI coding assistant a job: measure my marketing metrics every month — from real queries, with full provenance, and don't stop until the scorecard is complete.**

Analytics Agent is a tiny, open, do-it-yourself marketing measurement worker. Install once into [Claude Code](https://claude.com/claude-code), [OpenCode](https://opencode.ai), or [Codex CLI](https://github.com/openai/codex), then just say:

*"Record this month's numbers for every metric in my metrics file — real queries only."*

Your AI runs actual queries in your PostHog / GA4 / Search Console / Cal.com / email dashboard and records results through an evidence gate: **no number without its source system and the exact query that produced it.** The engine builds a grouped scorecard with period-over-period deltas — where every value can be disputed by disputing its query.

No screenshot dashboards. No vibes. No invented numbers.

---

What you get

🧾 Provenance on every value	Source system + exact query/click-path recorded with each number. Dispute a number by disputing its query.
📏 Definitions are law	Only metrics defined in your metrics.md can be recorded — with their definitions, not the model's improvisation.
🔁 Honest history	One value per metric per period. Corrections go through reject-and-re-add, never silent overwrites.
📈 Deltas built in	Status shows each metric's latest value vs prior period automatically.
📄 Scorecard export	Grouped Markdown report (or CSV) with full provenance per row.

Install (under 2 minutes)

curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/Analytics-Agent/main/install.sh | bash

Or paste into your AI tool in an empty folder:

Install https://github.com/ShayanSpiel/Analytics-Agent following its AGENTS.md,
then help me define my metrics, then start recording my measurements until we hit the target.
Use only real queries against my analytics accou