@mimeticinc/mim-cli

mim , the Mimetic CLI

Mimetic in your terminal: pull your site audits, prioritized findings, code-fix PRs, and session-replay insights straight into your shell , and into AI coding agents like Claude Code and Codex.

# authenticate this machine (opens the browser, device-code flow)
npx -y --package @mimeticinc/mim-cli mim auth login

# then pull a growth-context pack for one of your projects
mim context --project yourstore.com

Credentials are stored in ~/.mim/config.json (chmod 600), scoped to the projects your account owns. Requires Node 20+.

Install

Run on demand with npx (no global install):

npx -y --package @mimeticinc/mim-cli mim <command>

…or install the mim binary globally:

npm install -g @mimeticinc/mim-cli
mim auth login

Commands

Command	What it does
mim auth login	Device-code login (opens the browser). --token <t> stores an existing token.
mim auth status / mim auth logout	Show / clear local credentials.
mim projects	List the projects/sites on your account.
mim context	Print a growth-context pack for a project , ready to paste into an AI agent.
mim recordings	Recent session-replay summaries: what users did and where they hit friction.
mim replay [session_id]	One replay's issues + a redacted narrative. Defaults to the latest.
mim findings	The audit's prioritized findings and backlog.
mim query-ga4 --metrics sessions	Read-only GA4 report over your connected property.
mim query-gsc	Read-only Search Console query (top queries/pages).
mim setup-analytics [--wait]	One-click hosted analytics setup: GA4 property + tag install (PR or Shopify pixel) + Search Console verification. --wait polls to completion.
mim setup-analytics --status	Hosted setup progress; also retries the Search Console verification/sitemap followups.
mim setup-analytics --channel agent	For coding agents already in the site's repo: server provisions GA4 + Search Console, you apply the returned snippet yourself. No GitHub App or PR pipeline.
mim ads setup	Create a Google Ads account for the site under Mimetic's manager account: linked to GA4, auto-tagging on, owner invited as ADMIN.
mim ads status	The project's linked Google Ads account and latest setup event.
mim ads query [--gaql <q>]	Read-only GAQL report over the linked account (default: campaign performance, 30 days).
mim posthog connect	Connect PostHog over OAuth (opens the approval URL; read-only scopes).
mim posthog query [--hogql <q>]	Read-only HogQL over the connected project (default: daily events + unique users, 14 days).
mim klaviyo connect	Connect Klaviyo over OAuth (opens the approval URL; read-only scopes).
mim klaviyo query [--resource <r>]	Read-only listing from the connected Klaviyo account (campaigns, flows, lists, segments, metrics).
mim audit start <url> [--wait]	Start an audit (reuses a running/completed one). --wait polls to completion.
mim audit rerun <url>	Force a fresh audit.
mim audit status <id> / mim audit wait <id>	Check / poll an audit.
mim fixes list	List fixable findings + PR/review state.
mim fixes start <rank>	Queue a code fix , Mimetic opens a PR with a preview link.
mim fixes open <rank>	Open the PR, preview, diff, or workflow for a fix.
mim billing status / checkout / portal	Stripe billing for a project.
mim mcp install claude / mim mcp install codex	Wire Mimetic into Claude Code / Codex.

Common options

Option
--project <key>	Project/site key. Defaults to MIM_PROJECT or your saved default.
--format <json|markdown>	Output format (--json is an alias for --format json).
--limit <n>	Items to request, up to 100 (default 20).
--mode <slim|full>	Audit depth. slim (default, fast) or full (deeper, adds SDK intel).
--wait	With audit start/rerun or setup-analytics, poll until completion.
--api-base-url <url>	API origin. Defaults to MIM_API_BASE_URL or https://trymimetic.com.

MCP (Claude Code / Codex)

Mimetic ships a read-only MCP server, so your coding agent can see what's broken and why , redacted session narratives and findings, never raw replay payloads.

mim mcp install claude   # or: mim mcp install codex

Environment

MIM_API_TOKEN, MIM_API_BASE_URL, MIM_PROJECT, MIM_CONFIG_DIR (default ~/.mim), MIM_TELEMETRY=0 to disable usage telemetry.

Links

• Docs: https://trymimetic.com/api
• Agentic / x402 API: https://trymimetic.com/x402

MIT © Mimetic Inc