CLI Reference

Complete reference for all Pulse command-line interface commands.

Installation

# Install globally with npm
npm install -g @anthropic/pulse

# Or with pnpm
pnpm add -g @anthropic/pulse

# Verify installation
pulse --version

Global Options

These options are available for all commands:

Flag	Description
--help, -h	Show help for command
--version, -v	Show CLI version
--config, -c	Path to config file (default: pulse.yaml)
--verbose	Enable verbose output
--json	Output in JSON format
--quiet, -q	Suppress non-error output

Commands

pulse init

Initialize a new Pulse project

Usage

pulse init [project-name] [options]

Options

--template	Use a starter template	default: default
--runtime	Default runtime for models	default: python3.11

pulse validate

Validate configuration files

Usage

pulse validate [options]

Options

--config	Path to config file	default: pulse.yaml
--strict	Fail on warnings	default: false

pulse snapshot

Create a data snapshot

Usage

pulse snapshot <datasource> [options]

Options

--force	Force snapshot even if recent	default: false
--dry-run	Preview without creating	default: false

pulse train

Train a model

Usage

pulse train <model> [options]

Options

--snapshot	Use specific snapshot	default: latest
--watch	Stream training logs	default: true
--gpu	Request GPU resources	default: false

pulse deploy

Deploy a model to inference runtime

Usage

pulse deploy <model> [options]

Options

--version	Deploy specific version	default: latest
--canary	Canary deployment percentage	default: 0
--rollback	Rollback to previous version	default: false

pulse infer

Run inference on a deployed model

Usage

pulse infer <model> [options]

Options

--input	Input JSON or file path	default: -
--output	Output format	default: json

pulse lineage

View lineage for a model or inference

Usage

pulse lineage <id> [options]

Options

--depth	Lineage depth to show	default: full
--format	Output format	default: tree

pulse drift

Check for model drift

Usage

pulse drift <model> [options]

Options

--baseline	Baseline snapshot for comparison	default: training
--threshold	Drift detection threshold	default: 0.1

Examples

Full Workflow

# Initialize project
pulse init fraud-detection

# Validate configuration
pulse validate

# Create a snapshot of training data
pulse snapshot transactions-db

# Train the model
pulse train fraud-detector --watch

# Deploy to production
pulse deploy fraud-detector

# Run inference
echo '{"amount": 1500, "merchant": "electronics"}' | pulse infer fraud-detector

# Check lineage
pulse lineage fraud-detector@latest

# Monitor for drift
pulse drift fraud-detector --threshold 0.05

CI/CD Integration

# In your CI pipeline
pulse validate --strict
pulse train fraud-detector --snapshot snap_abc123
pulse deploy fraud-detector --canary 10

# After validation
pulse deploy fraud-detector --canary 100

Environment Variables

Configure Pulse behavior with environment variables:

Variable	Description
PULSE_API_KEY	API key for Pulse cloud services
PULSE_CONFIG	Default config file path
PULSE_LOG_LEVEL	Log level (debug, info, warn, error)
PULSE_CACHE_DIR	Local cache directory