cli

Confidence CLI

Manage Confidence feature flags, events, session recordings, and MCP integrations from the command line.

Install

npm install -g @spotify-confidence/cli

Requires Node.js 24+.

Quick Start

confidence login           # Sign in via browser OAuth
confidence flags setup     # Set up feature flags in your project
confidence events list     # List all event definitions
confidence quickstart      # Launch the interactive setup wizard

Commands

Authentication

Command	Description
confidence login	Sign in to Confidence via browser OAuth
confidence logout	Clear stored credentials
confidence whoami	Show current user, org, region, and token expiry

Feature Flags

Command	Description
confidence flags setup	Set up feature flags in your project via guided wizard
confidence flags list	List all flags in project
confidence flags get <flag-key>	Get flag details (variants, targeting, status)
confidence flags create <flag-key>	Create a new flag
confidence flags update <flag-key>	Update flag description or variants
confidence flags toggle <flag-key>	Enable or disable a flag for a client
confidence flags resolve <flag-key>	Resolve flag value for given context
confidence flags target <flag-key>	View or update targeting rules
confidence flags archive <flag-key>	Archive a flag

Events

Command	Description
confidence events setup	Set up event tracking via guided wizard
confidence events list	List all event definitions
confidence events create --name <id>	Create a new event definition
confidence events update <name>	Update an event definition's schema
confidence events delete <name>	Delete an event definition
confidence events usage <name>	Show recent event usage statistics

Session Recordings

Command	Description
confidence recordings setup	Set up recordings via guided wizard
confidence recordings policy list	List recording policies
confidence recordings policy create	Create a new recording policy
confidence recordings policy get <policy>	Show policy details with rules
confidence recordings rule add	Add a sampling rule to a policy
confidence recordings rule enable <rule>	Enable a recording rule
confidence recordings rule disable <rule>	Disable a recording rule
confidence recordings targeting-key show <client>	Show available targeting keys
confidence recordings targeting-key add	Add a targeting key to a client

Data Warehouses

Command	Description
confidence warehouse validate	Validate warehouse configuration
confidence warehouse create	Create a data warehouse connection
confidence warehouse connector create-flag-applied	Create flag assignment data connector
confidence warehouse connector create-event	Create event data connector
confidence warehouse assignment-table create	Create an assignment table for experiment analysis
confidence warehouse crypto-key create	Create a crypto key (Snowflake)

SDK

Command	Description
confidence sdk install	Detect framework and install the Confidence SDK
confidence sdk setup	Set up the Confidence SDK in your project

Documentation

Command	Description
confidence docs search <query>	Search Confidence documentation
confidence docs grep <pattern>	Grep through documentation
confidence docs read <page>	Read a docs page in the terminal

AI Plugin

Command	Description
confidence plugin install	Install the Confidence AI plugin for your coding agent
confidence plugin update	Update the Confidence AI plugin to the latest version
confidence plugin uninstall	Remove the Confidence AI plugin from your coding agent

Migration

Command	Description
confidence migrate detect	Scan project for third-party feature flag providers
confidence migrate statsig	Migrate from Statsig to Confidence
confidence migrate eppo	Migrate from Eppo to Confidence
confidence migrate posthog	Migrate from PostHog to Confidence
confidence migrate optimizely	Migrate from Optimizely to Confidence

MCP Servers

Command	Description
confidence mcp install	Install MCP servers for your AI coding agent
confidence mcp uninstall	Remove MCP server configuration
confidence mcp status	Check MCP server connection status
confidence mcp list	List available MCP servers
confidence mcp auth	Refresh MCP server credentials

Configuration

Command	Description
confidence config set <key> <val>	Set a configuration value
confidence config get <key>	Get a configuration value
confidence config list	List all configuration values
confidence config reset	Reset configuration to defaults

Other

Command	Description
confidence quickstart	Launch the interactive Confidence setup wizard
confidence update	Update the CLI to the latest version
confidence --help	Show help with examples
confidence --version	Show CLI version

Global Options

Option	Description
--json	Force JSON output
--output	Output format: json, table, or plain
--profile	Use a named auth profile
--help	Show help
--version	Show version number

Shared Command Options

These options are available on migrate, mcp, plugin, sdk, and warehouse commands:

Option	Description
--dir	Target project directory
--ide	AI coding agent: claude, cursor, codex

Output Formats

The CLI auto-detects the best output format: tables in interactive terminals, JSON when piped. Override with --json or --output:

confidence events list --json              # Force JSON
confidence whoami --output plain           # Force plain text
confidence events list | jq '.data[].name' # Pipe-friendly JSON

License

Apache License 2.0