sealmetrics
v0.1.3
Published
SealMetrics setup CLI — provision a free analytics account, place the tracker, and auto-configure the MCP server in one turn
Downloads
563
Readme
sealmetrics
Set up SealMetrics analytics in one command: provision a free account, get the tracker snippet placed, and auto-configure the SealMetrics MCP server in your editor so you can read your analytics in natural language.
npx sealmetrics initPrivacy-first, cookieless, GDPR-compliant by design — no card required for the free tier.
What it does
- Detects your framework (Next.js, Astro, Remix, Nuxt, SvelteKit, Vite, plain HTML) or CMS (WordPress, WooCommerce, PrestaShop, …).
- Provisions a free account headless (
POST /provision) and stores the read-only API key in.env(gitignored — never printed). - Hands off the snippet — the CLI never edits your source. It tells you
exactly where the snippet goes and writes
.sealmetrics/INSTALL.md; you (or your agent) paste it. - Auto-configures the MCP server for Claude Code, Cursor, Windsurf or VS Code (unknown clients get the standard block to paste).
- Verifies the install by polling pixel status.
Agent mode
npx sealmetrics init --agent --email [email protected] --accept-tos \
--site-name "My Shop" --domain myshop.com --install-source claude-codeIn --agent mode all stdout is versioned NDJSON with structured exit codes — see
PROTOCOL.md. Built for AI orchestrators (Claude Code, Cursor,
Codex) to drive in one turn.
Common flags
| Flag | Purpose |
|------|---------|
| --agent | Machine mode (NDJSON + auto-approve, no prompts) |
| -y, --yes | Non-interactive (use flags/defaults) |
| --dry-run | Detect only — no provisioning, no writes |
| --resume | Resume from the last checkpoint (no re-provision) |
| --no-inject | Provision only — don't emit placement guidance |
| --no-mcp | Skip MCP auto-config |
| --region <prod\|pre\|local> / --base-url <url> | Target a backend |
| --editor <id> | Force an MCP client |
| --verify-timeout <secs> | Pixel verify timeout (0 = skip) |
Run npx sealmetrics init --help for the full list.
What it writes
Only its own artefacts, always atomically and idempotently:
.env, seal.config.json, .sealmetrics/INSTALL.md,
.sealmetrics/INSTRUMENTATION.md, .sealmetrics/checkpoint.json, the MCP config
file, and .gitignore entries. It never touches your application source.
License
MIT
