Skip to main content

Overview

The Mercur CLI collects anonymous usage data to help us understand how the CLI is used and improve the developer experience. This data is collected by default but can be easily disabled.

What We Collect

When you run CLI commands (create, init, add, registry:build), the following data is sent:
DataDescription
Event typeWhich command was run and its outcome
Node.js versionYour Node.js runtime version
Node environmentThe NODE_ENV value
Mercur versionVersion of @mercurjs/core in your project
Medusa versionVersion of @medusajs/framework in your project
Package managernpm, yarn, pnpm, or bun
Project structureWhether src/ directory is used, alias prefix
System infoOS, platform, architecture, CPU model/speed/count, RAM
EnvironmentWhether running in WSL, Docker, or a TTY
Deployment vendorDetected hosting platform (Railway, Fly.io, Heroku, etc.)
Project IDSHA-256 hash (base64) of your git remote URL — not the URL itself
Project configContents of your blocks.json configuration
EmailOnly if you voluntarily provided it during mercurjs create

What We Do NOT Collect

  • Source code or file contents
  • File names or directory structure
  • Git history or commit messages
  • Personal data (beyond the optional email above)

How to Opt Out

Using the CLI

mercurjs telemetry --disable

Using an environment variable

export MERCUR_DISABLE_TELEMETRY=true
This is useful for CI/CD environments or shared configurations.

Check current status

mercurjs telemetry

Where Data Goes

Telemetry events are sent to https://telemetry.mercurjs.com. The data is used exclusively by the Mercur team to prioritize features and fix issues.

Re-enabling Telemetry

mercurjs telemetry --enable