@malleon/replay-cli

CLI tool for uploading source maps to Malleon Replay.

Malleon: malleon.io — CLI documentation — npm: @malleon/replay-cli

Installation

npm install -g @malleon/replay-cli

Usage

replay-cli upload \
  --app-id <your-app-id> \
  --token <your-source-map-token> \
  --url <your-app-url> \
  [--release <release-version>] \
  [--dist <dist-identifier>] \
  [--source-map-dir <directory>] \
  [--include <glob-pattern>] \
  [--exclude <exclude-pattern>] \
  [--server <server-url>]

Required Options

• --app-id: Your app ID (found in the Malleon Replay dashboard)
• --token: Source map token (generate/regenerate in app settings)
• --url: Your application URL (e.g., https://myapp.com). This should match the URL where your app is deployed (the same URL that appears in window.location.href when replays are recorded). Used for matching source maps to replays from the correct deployment. If you have multiple deployments (e.g., staging vs production), use the specific URL for each.

Optional Options

• --url-pattern: POSIX regex pattern for URL matching (defaults to exact match of provided URL). Use this to match multiple URLs. Example: "https://myapp\\.com/app/.*" to match https://myapp.com/app/, https://myapp.com/app/v1/, etc.
• --release: Release version (e.g., 1.0.0)
• --dist: Distribution identifier
• --source-map-dir: Directory containing source maps (default: .)
• --include: Glob pattern(s) for source map files (default: **/*.map)
  • Can be specified multiple times: --include "**/*.map" --include "**/*.js.map"
  • Multiple patterns are combined (union)
• --exclude: Glob pattern(s) to exclude from upload
  • Can be specified multiple times: --exclude "**/node_modules/**" --exclude "**/*.test.map"
  • Exclusions are applied to all patterns
• --server: Internal. You will not need to change this. Replay server URL (default: https://malleon.io)

Examples

Basic upload:

replay-cli upload \
  --app-id 550e8400-e29b-41d4-a716-446655440000 \
  --token abc123def456... \
  --url https://myapp.com \
  --release 1.2.3 \
  --source-map-dir dist/browser

App deployed at subpath:

replay-cli upload \
  --app-id 550e8400-e29b-41d4-a716-446655440000 \
  --token abc123def456... \
  --url https://myapp.com/app/ \
  --release 1.2.3

Multiple patterns:

replay-cli upload \
  --app-id 550e8400-e29b-41d4-a716-446655440000 \
  --token abc123def456... \
  --url https://myapp.com \
  --include "**/*.map" \
  --include "**/*.js.map" \
  --source-map-dir dist

With exclusions:

replay-cli upload \
  --app-id 550e8400-e29b-41d4-a716-446655440000 \
  --token abc123def456... \
  --url https://myapp.com \
  --include "**/*.map" \
  --exclude "**/node_modules/**" \
  --exclude "**/*.test.map" \
  --exclude "**/vendor/**"

Getting Your Source Map Token

1. Log into the Malleon Replay dashboard
2. Navigate to Apps → Select your app → App Details
3. Click "Generate Source Map Token" or "Regenerate Source Map Token"
4. Copy the token and use it with the --token option

Important: Keep your source map token secret. Anyone with this token can upload source maps to your app.