Before You Begin
To run this migration kit, you need:- The Confidence plugin installed in your AI assistant
- A Statsig Console API key (starts with
console-) with read access to gates, dynamic configs, and experiments, stored in theSTATSIG_API_KEYenvironment variable. You can create one under Project Settings > API Keys in the Statsig console. - The Confidence Flags MCP server, authenticated with your account
- The Confidence Documentation MCP server, used during code transformation
- Optional: a Confidence REST API token stored in the
CONFIDENCE_TOKENenvironment variable, required for partial experiment allocation, reusable segments, layer mutual exclusion, and holdouts
Run the Migration
Invoke the kit with the/confidence:migrate-statsig command in your AI assistant.
Plan the flag migration
Run
/confidence:migrate-statsig plan flag. The kit scans your Statsig gates, dynamic configs, and experiments and writes a migration plan file.Review the plan
The plan lists every flag with its targeting rules and rollout percentages, and marks anything that can’t migrate automatically. Plan files are resumable, so you can pause and continue later.
Execute the flag migration
Run
/confidence:migrate-statsig execute <plan-file>. The kit recreates your gates, configs, and experiments in Confidence with matching rules and variant splits.What Gets Migrated
| Statsig | Confidence |
|---|---|
| Feature gate | Boolean flag with enabled/disabled variants |
| Dynamic config | Struct flag where each rule’s return value becomes a variant |
| Experiment | Struct flag where each group becomes a variant with its percentage split |
| Segment | Segment, or conditions copied into targeting rules |
| Layer | Mutual-exclusion group (requires the REST API token) |
| Rollout percentage | Rollout percentage on the targeting rule |
Known Limitations
The kit flags these Statsig features for manual review because Confidence doesn’t support them:- Substring conditions (
str_contains_any,str_contains_none) and general regular expression matching - Conditions that depend on another experiment’s assignment (
experiment_group) - Custom JavaScript conditions
- Custom event logging (
logEvent)—Confidence doesn’t expose a matching API - Large ID list segments and analysis-only segments without the REST backend
Analyze Historical Experiments
The migration kit moves your flags and code, not your historical experiment results. To re-analyze experiments that ran on Statsig, import their assignment data into your data warehouse and follow the Analyze a Past Experiment quickstart.Related Resources
Migrations Overview
How migration kits work and how to install the plugin
Use AI with Confidence
Set up the Confidence MCP servers for your AI assistant
Analyze a Past Experiment
Re-analyze experiments that ran on another platform
SDK Integration
Integrate Confidence SDKs into your application

