{ "commands": { "activity": { "aliases": [], "args": {}, "description": "Inspect what changed in the workspace (recent commits, per-config history, deletions).", "examples": [ "<%= config.bin %> activity feed", "<%= config.bin %> activity history my.flag", "<%= config.bin %> activity deleted", "<%= config.bin %> activity restore my.flag --yes" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "activity", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "activity.js" ] }, "audit-log": { "aliases": [], "args": { "name": { "description": "Optional config key. If present, dispatches to `activity history NAME`; otherwise `activity feed`.", "name": "name" } }, "description": "Alias: `qfg audit-log` → `qfg activity feed`; `qfg audit-log NAME` → `qfg activity history NAME`.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> my.flag" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "audit-log", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": false, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "audit-log.js" ] }, "cleanup": { "aliases": [], "args": {}, "description": "Retire feature flags that have done their job.\n\nThe cleanup workflow turns a flag's \"Ready for cleanup\" marker into an end-to-end\nremoval flow: surface the flags that are safe to retire, hand the actual code\nremoval to the qfg-flag-cleanup Claude skill, then delete the flag definition\nonce the call sites are gone.\n\nLifecycle (high-level):\n 1. Owner flips readyForCleanup=true in the UI (already exists)\n 2. qfg cleanup list see candidates + telemetry\n 3. qfg cleanup status drill into one flag\n 4. qfg cleanup remove handoff to the cleanup skill\n 5. PR merges, SDK redeploys, telemetry confirms 0 evals\n 6. qfg cleanup verify (optional) confirm safe\n 7. qfg delete remove the flag definition", "examples": [ "<%= config.bin %> cleanup list", "<%= config.bin %> cleanup list --json", "<%= config.bin %> cleanup status my.flag.key" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cleanup", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "cleanup.js" ] }, "config-schema": { "aliases": [], "args": {}, "description": "Print the config file format reference: rules engine, operators, targeting criteria, segments, and weighted rollouts. Use --json-schema for the machine-readable JSON Schema document.", "examples": [ "<%= config.bin %> <%= command.id %> # human-readable operator reference + examples", "<%= config.bin %> <%= command.id %> --json-schema # full JSON Schema document (copy into your editor)" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "json-schema": { "description": "Output the full JSON Schema document for config files instead of the human-readable reference", "name": "json-schema", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "config-schema", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "config-schema.js" ] }, "create": { "aliases": [], "args": { "name": { "description": "name for your new item (e.g. my.new.flag)", "name": "name", "required": true } }, "description": "Create a new feature flag, config value, or other item.\n\nUse --type to specify the kind of item:\n boolean-flag On/off feature flag (sendToClientSdk defaults to true; best for gradual rollouts)\n string A string configuration value\n int An integer configuration value\n double A floating-point configuration value\n string-list A comma-separated list of strings\n json An arbitrary JSON blob\n boolean A plain boolean (not a feature flag)\n duration An ISO 8601 duration string, e.g. PT30S, PT5M, PT1H30M (SDK returns milliseconds)\n log_level A dynamic log level (value must be one of TRACE/DEBUG/INFO/WARN/ERROR/FATAL)\n\nThis sets the global default value. Override per-environment with:\n qfg set-default my.flag --environment production --value true\n\nFor a percentage rollout (gradual rollout / A/B test / canary deploy), use:\n qfg set-rollout my.flag --environment production --true-percent 20\n\nOr edit the JSON config file directly for complex targeting rules:\n qfg config-schema # full operator reference + examples\n qfg pull --dir ./config # clone workspace, then edit JSON and git push\n\nLog levels:\n qfg create log-level.my-app --type log_level --value WARN\n # Log-level keys must start with \"log-level.\".\n # For per-logger targeting, create ONE log-level config per service and add\n # rules on the \"quonfig-sdk-logging.key\" context property (e.g.\n # PROP_STARTS_WITH_ONE_OF MyPackage.) rather than one config per logger.\n\nWhen this flag has done its job, mark readyForCleanup: true in the UI and run `qfg cleanup list` to retire it.", "examples": [ "<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag", "<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag --value=true", "<%= config.bin %> <%= command.id %> my.new.string --type string --value=\"hello world\"", "<%= config.bin %> <%= command.id %> my.new.string --type string --value=\"hello world\" --secret", "<%= config.bin %> <%= command.id %> my.new.string --type string --env-var=MY_ENV_VAR_NAME", "<%= config.bin %> <%= command.id %> my.new.string --type json --value=\"{\\\"key\\\": \\\"value\\\"}\"", "<%= config.bin %> <%= command.id %> my.timeout --type duration --value PT90S", "<%= config.bin %> <%= command.id %> log-level.my-app --type log_level --value WARN", "# After creating a flag, set a 20% rollout in production:", "<%= config.bin %> set-rollout my.new.flag --environment production --true-percent 20" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "confidential": { "description": "mark the value as confidential", "name": "confidential", "allowNo": false, "type": "boolean" }, "env-var": { "description": "environment variable to get value from", "name": "env-var", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "type": { "name": "type", "required": true, "hasDynamicHelp": false, "multiple": false, "options": [ "boolean-flag", "boolean", "string", "double", "int", "string-list", "json", "duration", "log_level" ], "type": "option" }, "value": { "description": "default value for your new item", "name": "value", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "secret": { "description": "encrypt the value of this item", "name": "secret", "allowNo": false, "type": "boolean" }, "secret-key-name": { "description": "name of the secret key to use for encryption/decryption", "name": "secret-key-name", "default": "quonfig.secrets.encryption.key", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "create", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "create.js" ] }, "delete": { "aliases": [], "args": { "name": { "description": "flag/config/log-level key to delete", "name": "name", "required": true } }, "description": "Delete a flag, config, or log-level from the workspace.\n\nDESTRUCTIVE — removes the underlying JSON file from the workspace git repo\nand commits with the actor's identity. The commit history preserves the\nprior content; this is a hard-delete on the file but a soft-delete on\nhistory.\n\nConfirmation is required:\n --yes skip the prompt (for scripts and CI)\n interactive (default) you'll be asked to type the key name back\n\nExamples\n qfg delete my.flag --yes\n qfg delete my.flag # interactive: type the key back to confirm\n qfg delete my.config --yes", "examples": [ "<%= config.bin %> <%= command.id %> my.flag --yes", "<%= config.bin %> <%= command.id %> my.config --yes" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "yes": { "description": "skip confirmation prompt", "name": "yes", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "delete", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "delete.js" ] }, "generate-new-hex-key": { "aliases": [], "args": {}, "description": "Generate a new hex key suitable for secrets", "examples": [ "<%= config.bin %> <%= command.id %>" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "generate-new-hex-key", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "generate-new-hex-key.js" ] }, "generate": { "aliases": [], "args": {}, "description": "You can use the default type-generation configuration, or by provide your own via a quonfig.config.json file:\n\nFormat:\n{\n​ outputDirectory?: string;\n​ targets?: {\n​ ?: {\n​ outputDirectory?: string;\n​ outputFileName?: string;\n​ }\n​ }\n};\n\nExample quonfig.config.json:\n```json\n{\n​ \"outputDirectory\": \"path/to/your/directory\",\n​ \"targets\": {\n​ \"react-ts\": {\n​ \"outputDirectory\": \"diff/path/to/your/directory\",\n​ \"declarationFileName\": \"quonfig-client-types.d.ts\",\n​ \"clientFileName\": \"quonfig-client.ts\",\n​ },\n​ \"node-ts\": {\n​ \"declarationFileName\": \"quonfig-server-types.d.ts\",\n​ \"clientFileName\": \"quonfig-server.ts\",\n​ }\n​ }\n}\n```\n ", "examples": [ "<%= config.bin %> <%= command.id %> # react-ts only by default", "<%= config.bin %> <%= command.id %> --targets node-ts # node-ts only", "<%= config.bin %> <%= command.id %> --targets react-ts,node-ts # both node + react-ts", "<%= config.bin %> <%= command.id %> -o ./src/generated # specify output directory", "<%= config.bin %> <%= command.id %> --targets node-ts -o ./dist # combine with targets" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dir": { "description": "Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var). When omitted, auto-detects a quonfig.json in the current directory; if none, fetches the workspace from the server.", "env": "QUONFIG_DIR", "name": "dir", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "output-directory": { "char": "o", "description": "Override the output directory for generated files", "name": "output-directory", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "targets": { "description": "Determines for language/framework to generate code for (node-ts, react-ts)", "name": "targets", "default": "react-ts", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "workspace": { "char": "w", "description": "Workspace slug or UUID for the remote-fetch path (defaults to QUONFIG_WORKSPACE env var or active profile). Only used when --dir is omitted.", "name": "workspace", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "generate", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "summary": "Generate type definitions for your Quonfig configuration", "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "generate.js" ] }, "get": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Get the value of a config/feature-flag/etc.", "examples": [ "<%= config.bin %> <%= command.id %> my.config.name", "<%= config.bin %> <%= command.id %> my.config.name --environment=production" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "environment to evaluate in", "name": "environment", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "get", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "get.js" ] }, "history": { "aliases": [], "args": { "name": { "description": "Config key to inspect", "name": "name", "required": true } }, "description": "Alias: `qfg history NAME` → `qfg activity history NAME`.", "examples": [ "<%= config.bin %> <%= command.id %> my.flag" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "history", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": false, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "history.js" ] }, "info": { "aliases": [ "flag:show", "flag:info" ], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Show current values, rules, and evaluation stats for a flag or config.\n\nOutput shows the value for each environment:\n - A simple value (true / false / \"hello\") means a single unconditional rule.\n - \"[see rules]\" means the environment has targeting rules or a percentage rollout.\n - \"[inherit]\" means the environment falls back to the Default value.\n\nPercentage rollouts are displayed as \"20.0% true, 80.0% false\".\nEvaluation counts for the past 24 hours are included by default.\n\nRelated commands:\n qfg set-default my.flag --environment production --value true # set a scalar fallback\n qfg set-rollout my.flag --environment production --true-percent 20 # set a % rollout", "examples": [ "<%= config.bin %> <%= command.id %> my.config.name", "<%= config.bin %> <%= command.id %> my.config.name --exclude-evaluations # skip 24h stats" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "exclude-evaluations": { "description": "Exclude evaluation data", "name": "exclude-evaluations", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "info", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "info.js" ] }, "init": { "aliases": [], "args": { "directory": { "default": ".", "description": "Target directory (default: current directory)", "name": "directory" } }, "description": "Initialize or update a Quonfig workspace", "examples": [ "<%= config.bin %> init", "<%= config.bin %> init ./my-workspace", "<%= config.bin %> init --no-samples", "<%= config.bin %> init --samples", "<%= config.bin %> init --dry-run" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dry-run": { "description": "Show what would be done without writing anything", "name": "dry-run", "allowNo": false, "type": "boolean" }, "samples": { "description": "Include sample configs (default: yes on first init, no on update)", "name": "samples", "allowNo": true, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace pin in / form (Guard 1). If omitted, no pin is written.", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "init", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "init.js" ] }, "interactive": { "aliases": [], "args": {}, "description": "Launch an interactive menu to browse and manage your workspace.\n\nCommon shortcuts:\n qfg set-default my.flag --environment production --value false # catch-all fallback\n qfg set-rollout my.flag --environment production --true-percent 20 # % rollout\n\nFor arbitrary targeting rules (e.g. user.email, plan, segment, custom property),\nrun 'qfg config-schema' then 'qfg pull' and edit the JSON config directly.", "examples": [ "<%= config.bin %>" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "interactive", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "interactive.js" ] }, "list": { "aliases": [ "flag:list" ], "args": {}, "description": "Show keys for your config/feature flags/etc.\n\n All types are returned by default. If you pass one or more type flags (e.g. --configs), only those types will be returned", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --feature-flags" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "configs": { "description": "include configs", "name": "configs", "allowNo": false, "type": "boolean" }, "feature-flags": { "description": "include flags", "name": "feature-flags", "allowNo": false, "type": "boolean" }, "log-levels": { "description": "include log levels", "name": "log-levels", "allowNo": false, "type": "boolean" }, "schemas": { "description": "include schemas", "name": "schemas", "allowNo": false, "type": "boolean" }, "segments": { "description": "include segments", "name": "segments", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "list", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "list.js" ] }, "log-level": { "aliases": [], "args": { "name": { "description": "log-level key (must start with \"log-level.\", e.g. log-level.my-app)", "name": "name", "required": true } }, "description": "Create or add targeting rules to a log-level config.\n\nLog-level keys must start with \"log-level.\" (e.g. log-level.my-app). The\ndefault value applies to every logger in that service unless a targeting\nrule matches first.\n\nTwo modes:\n\n 1. Create a new log-level config with a default value:\n qfg log-level log-level.my-app --value=WARN\n\n 2. Add a per-logger targeting rule to an existing config. SDKs populate\n the \"quonfig-sdk-logging.key\" context automatically from the logger path,\n so this rule fires for any logger whose name starts with --target:\n qfg log-level log-level.my-app --target=MyPackage.Noisy --value=ERROR\n\n Pass --target multiple times to match any of several prefixes (OR).\n Pass --environment= to scope the rule to a single environment.\n\nTo update the catch-all default for an existing log level, use set-default:\n qfg set-default log-level.my-app --value=DEBUG --environment=production\n\nFor more complex rules (regex, multi-criterion, exact match) edit the JSON:\n qfg pull && $EDITOR log-levels/log-level.my-app.json\n qfg config-schema # full operator reference", "examples": [ "<%= config.bin %> <%= command.id %> log-level.my-app --value=WARN", "<%= config.bin %> <%= command.id %> log-level.my-app --target=MyPackage.Noisy --value=ERROR", "<%= config.bin %> <%= command.id %> log-level.my-app --target=A --target=B --value=DEBUG", "<%= config.bin %> <%= command.id %> log-level.my-app --target=Chatty --value=INFO --environment=production" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "when used with --target, scope the rule to this environment instead of the default", "name": "environment", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "target": { "description": "logger path prefix (matched via PROP_STARTS_WITH_ONE_OF on \"quonfig-sdk-logging.key\"); repeatable", "name": "target", "hasDynamicHelp": false, "multiple": true, "type": "option" }, "value": { "description": "log level — either the new default (create mode) or the level for the targeted loggers", "name": "value", "required": false, "hasDynamicHelp": false, "multiple": false, "options": [ "TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "log-level", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "log-level.js" ] }, "log": { "aliases": [], "args": {}, "description": "Alias: `qfg log` → `qfg activity feed`.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --limit 5" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "log", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": false, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "log.js" ] }, "login": { "aliases": [], "args": {}, "description": "Log in to Quonfig via WorkOS device authorization (mints one token per org)", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --profile myprofile" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "profile": { "char": "p", "description": "Profile name to save credentials under (advanced; defaults to \"default\")", "hidden": true, "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "login", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "login.js" ] }, "logout": { "aliases": [], "args": {}, "description": "Log out and clear stored authentication tokens", "examples": [ "<%= config.bin %> <%= command.id %>" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "logout", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "logout.js" ] }, "migrate": { "aliases": [], "args": {}, "description": "Migrate flags and configs from a legacy feature-flag system into a Quonfig workspace.\n\nCurrently supported sources:\n launch — Reforge Launch (ported from launch-migrator)\n\nSee https://docs.quonfig.com/docs/migrating/from-launch for the step-by-step guide,\nand https://docs.quonfig.com/docs/migrating/troubleshooting when something goes sideways.", "examples": [ "<%= config.bin %> <%= command.id %> --from launchdarkly --source-api-key $LAUNCHDARKLY_API_KEY --dir ./quonfig-repo", "<%= config.bin %> <%= command.id %> --from launch --source-api-key $LAUNCH_API_KEY --workspace acme-prod --push", "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --reset", "<%= config.bin %> <%= command.id %> --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --dry-run", "<%= config.bin %> <%= command.id %> --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "api-key": { "description": "Deprecated alias for --source-api-key, kept for the `launch` source (or set LAUNCH_API_KEY). Prefer --source-api-key.", "env": "LAUNCH_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "dir": { "description": "Target local workspace directory. Defaults to cwd if it looks like a Quonfig workspace, otherwise ./quonfig-repo.", "name": "dir", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "dry-run": { "description": "Fetch and summarize changes without writing anything", "name": "dry-run", "allowNo": false, "type": "boolean" }, "from": { "description": "Legacy source to migrate from", "name": "from", "required": true, "hasDynamicHelp": false, "multiple": false, "options": [ "launch", "launchdarkly", "flagsmith" ], "type": "option" }, "full-summary": { "description": "Reify the full source-side audit log into per-change git commits (author = original user, date = original timestamp, message = change summary). Only valid on first-run imports — pass --reset to re-import everything from scratch with this flag.", "name": "full-summary", "allowNo": false, "type": "boolean" }, "project": { "description": "Source-system project identifier. For --from launchdarkly this is the project KEY (default: \"default\"; env: LAUNCHDARKLY_PROJECT_KEY). For --from flagsmith this is the numeric project ID (env: FLAGSMITH_PROJECT_ID). Ignored by --from launch.", "name": "project", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "push": { "description": "After migrating to a local dir, also push to the given --workspace on Quonfig cloud", "name": "push", "allowNo": false, "type": "boolean" }, "recent": { "description": "Import only the last N changes (useful for tire-kicking)", "name": "recent", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "reset": { "description": "Ignore the delta cursor and re-import everything from scratch", "name": "reset", "allowNo": false, "type": "boolean" }, "since": { "description": "Override the delta cursor (epoch milliseconds or ISO-8601 timestamp)", "name": "since", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "source-api-key": { "description": "API key for the legacy source. Set this, QUONFIG_MIGRATE_API_KEY, or the per-provider env var (LAUNCHDARKLY_API_KEY, LAUNCH_API_KEY, FLAGSMITH_API_KEY).", "env": "QUONFIG_MIGRATE_API_KEY", "name": "source-api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "staging": { "description": "Hit the staging API for the source (dev-only)", "name": "staging", "allowNo": false, "type": "boolean" }, "strict-keys": { "description": "Refuse to migrate if any source key would need rewriting to satisfy Quonfig key rules (Policy A), instead of rewriting it. Use when you require byte-identical keys.", "name": "strict-keys", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Quonfig cloud workspace slug to push to. Requires `qfg login` and is typically combined with --push.", "name": "workspace", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "migrate", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "migrate.js" ] }, "override": { "aliases": [], "args": { "name": { "description": "flag/config key to override", "name": "name" }, "value": { "description": "new value (type inferred: bool/int/double/json/string)", "name": "value" } }, "description": "Override a flag value for your dev user.\n\nWrites a top-priority rule keyed on the dev-only quonfig-user.email property,\nso the override only fires for SDK clients that set quonfig-user.email in\ntheir context. Production SDKs typically don't set this property, which makes\noverrides effectively inert in production.\n\nExamples\n qfg override # list flags where you have an override\n qfg override my.flag true # set bool override\n qfg override my.flag 42 # set int override\n qfg override my.flag '{\"a\":1}' # set json override\n qfg override my.flag --remove # remove your override on my.flag\n qfg override --clear # remove ALL of your overrides in this env", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> my.flag true", "<%= config.bin %> <%= command.id %> my.flag --remove", "<%= config.bin %> <%= command.id %> --clear", "<%= config.bin %> <%= command.id %> my.flag true --env=staging" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "clear": { "description": "remove ALL of your overrides in this env", "name": "clear", "allowNo": false, "type": "boolean" }, "env": { "description": "environment to operate in (default: $QUONFIG_ENVIRONMENT)", "name": "env", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "remove": { "description": "remove your override on this key", "name": "remove", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "override", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "override.js" ] }, "profile": { "aliases": [], "args": {}, "description": "Deprecated. Use `qfg workspace switch` instead.", "examples": [ "<%= config.bin %> workspace switch" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hidden": true, "hiddenAliases": [], "id": "profile", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "profile.js" ] }, "pull": { "aliases": [], "args": {}, "description": "Clone or update a local copy of your workspace config files.\n\nUse this when you need to edit flag JSON directly — for complex targeting rules,\nmulti-rule configs, or anything beyond a single scalar value.\n\nFor the config file format, operator reference, and examples:\n qfg config-schema # human-readable reference\n qfg config-schema --json-schema # machine-readable JSON Schema\n\nAfter editing files:\n qfg verify # validate JSON before pushing\n git -C add -A && git -C commit -m \"feat: ...\" && git -C push\n\nCLI shortcuts (no JSON editing needed for simple cases):\n qfg set-rollout my.flag --environment production --true-percent 20\n qfg set-default my.flag --environment production --value true", "examples": [ "<%= config.bin %> pull --dir ./our-config", "<%= config.bin %> pull # uses QUONFIG_DIR env var" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dir": { "description": "Local directory to clone/update (defaults to cwd / nearest ancestor with quonfig.json / QUONFIG_DIR env var)", "name": "dir", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "rebase": { "description": "Replay local commits on top of origin/main when the two have diverged. Conflicts are surfaced via standard git markers; resolve with `git rebase --continue`.", "name": "rebase", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace ID (defaults to active profile)", "name": "workspace", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "pull", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "pull.js" ] }, "push": { "aliases": [], "args": {}, "description": "Push local config changes up to your workspace on Quonfig cloud.\n\nEnforces three guards before touching the remote:\n 1. The dir's quonfig.json \"workspace\" pin must match the backend (if set).\n 2. The dir's git origin must match the backend repo URL (if set).\n 3. A diff summary is shown; destructive changes (10+ deletes, >=25% of\n files, or an unpinned dir) require typing the workspace slug to confirm.\n\n qfg push # resolves dir from cwd, QUONFIG_DIR, or --dir\n qfg push --dir ./our-config\n qfg push --dir ./our-config --workspace acme-prod\n qfg push --dir ./our-config --yes # skip normal Y/N (never skips typed-slug)\n qfg push --dir ./our-config --skip-validate", "examples": [ "<%= config.bin %> push --dir ./our-config", "<%= config.bin %> push --workspace acme-prod --dir ./our-config", "<%= config.bin %> push --dir ./our-config --yes" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dir": { "description": "Local directory to push (defaults to cwd / nearest ancestor with quonfig.json / QUONFIG_DIR env var)", "name": "dir", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "workspace": { "char": "w", "description": "Workspace slug or UUID (defaults to active profile)", "name": "workspace", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "yes": { "description": "Skip the standard Y/N confirm. Never skips typed-slug prompts.", "name": "yes", "allowNo": false, "type": "boolean" }, "skip-validate": { "description": "Skip `qfg validate` preflight", "name": "skip-validate", "allowNo": false, "type": "boolean" }, "no-pin-write": { "description": "Do not offer to write workspace slug into quonfig.json on success", "name": "no-pin-write", "allowNo": false, "type": "boolean" }, "message": { "char": "m", "description": "Commit message for bare-path pushes (ignored on clone-path; push what is already committed)", "name": "message", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "push", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "push.js" ] }, "run": { "aliases": [], "args": { "command": { "description": "child command (after '--')", "name": "command", "required": false } }, "description": "Run a child process with Quonfig configs injected as env vars.\n\nResolves --env VAR=key.path mappings (and --env-file lines) against your\nworkspace, merges them into the parent env, and exec's the child command.\nExits with the child's exit code. Missing keys → fail before spawning.\n\nAuth / environment is BINARY:\n Mode A — QUONFIG_BACKEND_SDK_KEY set: env is encoded in the key.\n Setting --environment OR QUONFIG_ENVIRONMENT alongside is an error.\n Mode B — no SDK key: pass exactly one of --environment or QUONFIG_ENVIRONMENT.\n\nThe flag separator '--' is REQUIRED between qfg flags and the child command.", "examples": [ "<%= config.bin %> <%= command.id %> --env DATABASE_URL=db.url --environment=staging -- env", "<%= config.bin %> <%= command.id %> --env-file=.qfg.env --environment=staging -- npm run migrate", "<%= config.bin %> <%= command.id %> --env DATABASE_URL=db.url -- ./bin/migrate.js # Mode A: relies on QUONFIG_BACKEND_SDK_KEY", "<%= config.bin %> <%= command.id %> --env DATABASE_URL=db.url --preserve-env --environment=staging -- npm test" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "env": { "description": "Inline env mapping in VAR=key.path form. Repeatable.", "name": "env", "default": [], "hasDynamicHelp": false, "multiple": true, "type": "option" }, "env-file": { "description": "Path to a file with one VAR=key.path per line (# comments and blank lines OK).", "name": "env-file", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "Quonfig environment to evaluate in (Mode B). Mutually exclusive with QUONFIG_ENVIRONMENT.", "name": "environment", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "preserve-env": { "description": "Skip vars that are already set in the parent env. Default: override.", "name": "preserve-env", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "run", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": false, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "run.js" ] }, "schema": { "aliases": [], "args": { "name": { "description": "schema key", "name": "name", "required": true } }, "description": "Get or update first-class schema documents", "examples": [ "<%= config.bin %> <%= command.id %> my-schema --get", "<%= config.bin %> <%= command.id %> my-schema --set-json-schema='{\"type\":\"object\",\"properties\":{}}'", "<%= config.bin %> <%= command.id %> my-schema --set-json-schema=@schemas/my-schema.json --protected" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "get": { "description": "get the schema document", "name": "get", "allowNo": false, "type": "boolean" }, "protected": { "description": "store the schema in protected storage", "name": "protected", "allowNo": false, "type": "boolean" }, "set-json-schema": { "description": "set a plain JSON Schema document (inline JSON or @file path)", "name": "set-json-schema", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "set-zod": { "description": "compatibility alias for --set-json-schema; now expects plain JSON Schema", "name": "set-zod", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "schema", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "schema.js" ] }, "sdk-key": { "aliases": [], "args": {}, "description": "Manage SDK keys for your workspace", "examples": [ "<%= config.bin %> sdk-key list", "<%= config.bin %> sdk-key create --environment production --type server", "<%= config.bin %> sdk-key revoke " ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "sdk-key", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "sdk-key.js" ] }, "serve": { "aliases": [], "args": {}, "description": "Serve a local datadir over HTTP to browser/RN SDKs.\n\nReads configs from a local datadir and exposes them at\n`GET /api/v2/configs/eval-with-context/{base64url(ctx)}`. Point your\nbrowser SDK at the resulting URL (`http://localhost:6580` by default)\nand the same client code that talks to api-delivery in production will\nwork unmodified.\n\nTelemetry is intentionally not served — qfg serve has no Quonfig backend\nbehind it. Disable client-side telemetry with\n`collectEvaluationSummaries: false` (and `contextUploadMode: \"none\"`),\nor point the SDK's `telemetryUrl` at a real endpoint.\n\nThe server is bound to 127.0.0.1 by default; pass --allow-non-loopback\nto confirm a LAN-reachable bind.", "examples": [ "<%= config.bin %> serve", "<%= config.bin %> serve --datadir ./our-config --environment production", "<%= config.bin %> serve --port 6581 --frontend-sdk-key PUBLIC_KEY" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "datadir": { "description": "Datadir to serve (defaults to ./our-config, then ./.quonfig, then errors). Honors QUONFIG_DIR.", "name": "datadir", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "Which environment slug to evaluate. Honors QUONFIG_ENVIRONMENT.", "name": "environment", "default": "development", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "port": { "description": "TCP port to listen on. Errors on collision; pass --port to retry.", "name": "port", "default": 6580, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "host": { "description": "Bind address. Loopback by default; non-loopback requires --allow-non-loopback.", "name": "host", "default": "127.0.0.1", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "frontend-sdk-key": { "description": "If set, every request must present Authorization: Basic 1:. If unset, the server is open (matches the \"datadir is the source of truth\" mental model).", "name": "frontend-sdk-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "cors-origin": { "description": "Allowed CORS origin (repeatable). Default is *; required when binding to a non-loopback host.", "name": "cors-origin", "default": [ "*" ], "hasDynamicHelp": false, "multiple": true, "type": "option" }, "watch": { "description": "Reload the envelope when the datadir changes. --no-watch disables.", "name": "watch", "allowNo": true, "type": "boolean" }, "allow-non-loopback": { "description": "Confirm a LAN-reachable bind. Required when --host is not loopback.", "name": "allow-non-loopback", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "serve", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "serve.js" ] }, "set-default": { "aliases": [ "toggle" ], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Set the unconditional fallback value for a flag or config in a specific environment.\n\nThis updates the catch-all rule — the value users receive when NO targeting rule matches.\nAny targeting rules or percentage rollouts you have configured are NOT affected; they\ncontinue to fire before this fallback is evaluated.\n\n\"Other rules still apply\" means: if you have rules targeting specific users, segments,\nor properties, those rules still take priority. This command only changes what everyone\nelse sees.\n\nTo set a percentage rollout (gradual rollout / A/B test / canary deploy) instead:\n qfg set-rollout my.flag --environment production --true-percent 20\n\nTo see all current values and rules for a flag:\n qfg info my.flag", "examples": [ "<%= config.bin %> <%= command.id %> my.flag.name # prompts for value and env", "<%= config.bin %> <%= command.id %> my.flag.name --value=true --environment=staging", "<%= config.bin %> <%= command.id %> my.flag.name --value=false --environment=production # kill-switch: turn off for everyone", "<%= config.bin %> <%= command.id %> my.flag.name --value=true --secret", "<%= config.bin %> <%= command.id %> my.config.name --env-var=MY_ENV_VAR_NAME --environment=production", "# For a percentage rollout, use set-rollout instead:", "<%= config.bin %> set-rollout my.flag.name --environment production --true-percent 20", "# For per-user / per-property targeting (e.g. user.email == X), edit JSON directly:", "<%= config.bin %> pull && <%= config.bin %> config-schema" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "confidential": { "description": "mark the value as confidential", "name": "confidential", "allowNo": false, "type": "boolean" }, "env-var": { "description": "environment variable to use as default value", "name": "env-var", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "environment to change", "name": "environment", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "value": { "description": "new default value", "name": "value", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "confirm": { "description": "confirm without prompt", "name": "confirm", "allowNo": false, "type": "boolean" }, "secret": { "description": "encrypt the value of this item", "name": "secret", "allowNo": false, "type": "boolean" }, "secret-key-name": { "description": "name of the secret key to use for encryption/decryption", "name": "secret-key-name", "default": "quonfig.secrets.encryption.key", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "set-default", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "set-default.js" ] }, "set-rollout": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Configure a percentage rollout (gradual rollout / A/B test / canary deploy) for a flag.\n\nThe flag must already exist. Create it first if needed:\n qfg create my.flag --type boolean-flag\n\nWeights are specified as whole-number percentages (0–100). They must sum to 100.\n\nFor a boolean flag, use --true-percent to set the percentage of users that receive\ntrue (the remainder automatically receive false):\n qfg set-rollout my.flag --environment production --true-percent 20\n → 20% of users get true, 80% get false\n\nFor multi-value flags or custom splits, use --weights with a comma-separated list:\n qfg set-rollout my.flag --environment production --weights \"red:33,green:33,blue:34\"\n\nHashing: users are bucketed by the value of hashByPropertyName (default: \"user.key\").\nUse --hash-by to change which property drives the bucket assignment:\n qfg set-rollout my.flag --environment production --true-percent 10 --hash-by user.id\n\nFor scripted / agent use, add --confirm to skip the interactive confirmation prompt.\n\nTo combine a rollout with segment targeting (e.g. beta ON, holdout OFF, everyone else 50/50),\nyou need to edit the JSON config file directly:\n qfg config-schema # operator reference + worked multi-rule example\n qfg pull --dir ./config # clone workspace to edit\n\nTo revert to a single value for everyone, use:\n qfg set-default my.flag --environment production --value false\n\nTo inspect the current rollout:\n qfg info my.flag", "examples": [ "<%= config.bin %> <%= command.id %> my.feature.flag --environment production --true-percent 20", "<%= config.bin %> <%= command.id %> my.feature.flag --environment staging --true-percent 50", "<%= config.bin %> <%= command.id %> my.feature.flag --environment production --true-percent 100 # full rollout", "<%= config.bin %> <%= command.id %> my.feature.flag --environment production --true-percent 0 # kill switch (all false)", "<%= config.bin %> <%= command.id %> my.variant.flag --environment production --weights \"control:50,treatment:50\"", "<%= config.bin %> <%= command.id %> my.variant.flag --environment production --weights \"a:33,b:33,c:34\" --hash-by user.id" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "environment to update (e.g. production, staging)", "name": "environment", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "hash-by": { "description": "user property used to assign buckets (default: user.key)", "name": "hash-by", "default": "user.key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "true-percent": { "description": "percentage of users that receive true (0–100). Remaining users receive false. Boolean flags only.", "name": "true-percent", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "weights": { "description": "comma-separated \"value:percent\" pairs that must sum to 100 (e.g. \"true:20,false:80\" or \"red:33,green:33,blue:34\")", "name": "weights", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "confirm": { "description": "skip the interactive confirmation prompt (useful for scripts and agents)", "name": "confirm", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "set-rollout", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "set-rollout.js" ] }, "sync": { "aliases": [], "args": {}, "description": "Continuously poll for workspace config updates and apply them locally", "examples": [ "<%= config.bin %> sync --watch", "<%= config.bin %> sync --watch --interval 10", "<%= config.bin %> sync --watch --dir ./our-config --interval 30" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dir": { "description": "Local directory to sync (defaults to QUONFIG_DIR env var)", "name": "dir", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "interval": { "description": "Poll interval in seconds", "name": "interval", "default": 60, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "watch": { "description": "Run as a continuous polling daemon (required)", "name": "watch", "required": true, "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "sync", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "sync.js" ] }, "verify": { "aliases": [], "args": { "path": { "default": ".", "description": "Path to workspace directory", "name": "path" } }, "description": "Validate a Quonfig workspace directory", "examples": [ "<%= config.bin %> verify", "<%= config.bin %> verify ./my-workspace", "<%= config.bin %> verify --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "strict": { "description": "Treat warnings as errors", "name": "strict", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "verify", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "verify.js" ] }, "whoami": { "aliases": [], "args": {}, "description": "Display information about the currently logged in user and all org memberships", "examples": [ "<%= config.bin %> <%= command.id %>" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "whoami", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "whoami.js" ] }, "workspace": { "aliases": [], "args": {}, "description": "Show the active workspace, all org tokens, and every (org, workspace) the user can reach", "examples": [ "<%= config.bin %> <%= command.id %>" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "workspace", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "workspace.js" ] }, "activity:deleted": { "aliases": [], "args": {}, "description": "List configs that were deleted from the workspace and have not been restored.\n\nUseful for \"did somebody delete X?\" — pair with `qfg activity restore NAME`\nto undelete a tombstoned config.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "activity:deleted", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "activity", "deleted.js" ] }, "activity:feed": { "aliases": [], "args": {}, "description": "Recent activity across the workspace, newest first.\n\nEach entry shows who changed which config, the action (created/updated/deleted/restored),\nand the human-readable audit message produced by the server. The server already\ntranslates JSON diffs into messages — this command does not re-translate.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --limit 5", "<%= config.bin %> <%= command.id %> --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "limit": { "description": "Maximum number of feed entries (1-100)", "name": "limit", "default": 30, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "activity:feed", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "activity", "feed.js" ] }, "activity:history": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Per-config audit trail for a flag, config, log-level, segment, or schema.\n\nResolves NAME against the workspace metadata (no need to specify type) and\nreturns the full commit history for that file with audit messages translated\nby the server. Restored entries are rendered distinctly so a recovery doesn't\nlook like a fresh create.", "examples": [ "<%= config.bin %> <%= command.id %> my.flag", "<%= config.bin %> <%= command.id %> request.timeout --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "activity:history", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "activity", "history.js" ] }, "activity:restore": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Undelete a config that was previously removed.\n\nLooks up the most recent deletion for the key (so you see who deleted it and when),\nthen asks for confirmation before re-creating the file from the prior content.\nSchemas cannot be restored — use git history instead.", "examples": [ "<%= config.bin %> <%= command.id %> my.flag --yes", "<%= config.bin %> <%= command.id %> request.timeout --type config --yes" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "type": { "description": "Config type. Optional — inferred from history when omitted.", "name": "type", "required": false, "hasDynamicHelp": false, "multiple": false, "options": [ "feature_flag", "config", "log_level", "segment", "flag", "log-level" ], "type": "option" }, "yes": { "description": "Skip the confirmation prompt", "name": "yes", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "activity:restore", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "activity", "restore.js" ] }, "cleanup:list": { "aliases": [], "args": {}, "description": "List feature flags marked readyForCleanup=true, with eval volume per window.\n\nColumns:\n KEY the flag key\n TYPE the flag's valueType (bool, string, int, etc.)\n EVALS_24H evals counted in today's bucket (latest day)\n EVALS_2D evals in the last 2 calendar days\n EVALS_7D evals in the last 7 calendar days\n EVALS_30D evals in the last 30 calendar days\n LAST_EVAL most recent calendar day with any evals (UTC), blank if none\n CLASS quiet (zero evals in last 2 days) or active\n\nDefault sort: quiet first, oldest LAST_EVAL at top.\n\nPass --json for the structured object (rows[]). Each row carries the columns\nabove plus the raw eval counts your agent can reason about itself.\n\nOnce you've picked a candidate, run `qfg cleanup status ` for the\ndrill-in or hand off the removal to the qfg-flag-cleanup Claude skill.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --json" ], "flags": { "json": { "description": "Return structured rows for agent consumption", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cleanup:list", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "cleanup", "list.js" ] }, "cleanup:remove": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Write a cleanup payload for a ready-for-cleanup flag and hand off to the qfg-flag-cleanup Claude skill.\n\nModeled on `qfg migrate my-code` — this command never edits source files\nitself. It validates that the flag is marked readyForCleanup=true, refuses to\nproceed if there are still evals_2d > 0 (use --force to override), writes\n`.qf/cleanup/.json` describing the flag's current rule shape +\ntelemetry, and prints instructions to invoke the qfg-flag-cleanup skill which\nasks the engineer which value should \"win\" and applies the inlining.\n\nThe payload deliberately does NOT suggest a winning value; that's the\nengineer's call. Run `qfg cleanup status ` first if you want to inspect\ntelemetry before retiring.", "examples": [ "<%= config.bin %> <%= command.id %> my.flag.key", "<%= config.bin %> <%= command.id %> my.flag.key --force", "<%= config.bin %> <%= command.id %> my.flag.key --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "force": { "description": "Skip the evals_2d > 0 safety gate (useful when telemetry is delayed but you know the flag is dead)", "name": "force", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cleanup:remove", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "cleanup", "remove.js" ] }, "cleanup:status": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Drill into one ready-for-cleanup flag — show telemetry across all environments and the current rule shape.\n\nUse this after `qfg cleanup list` to inspect a specific flag before handing\nremoval off to the qfg-flag-cleanup Claude skill. The eval counts come from\nanalytics.configSparklines (the same backing data the per-flag sparklines on\nthe flag detail page use), summed into 24h/2d/7d/30d windows so you can decide\nwhether it's safe to retire.\n\nPass --json for the structured object including the full rule shape per\nenvironment — the cleanup skill consumes this directly.", "examples": [ "<%= config.bin %> <%= command.id %> my.flag.key", "<%= config.bin %> <%= command.id %> my.flag.key --json" ], "flags": { "json": { "description": "Return structured object for agent consumption", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cleanup:status", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "cleanup", "status.js" ] }, "cleanup:verify": { "aliases": [], "args": { "name": { "description": "config/feature-flag/etc. name", "name": "name" } }, "description": "Confirm zero evals for a flag in the trailing N days (default 7). Exits 0 if safe to delete, non-zero otherwise.\n\nRead-only gate intended for chaining with `qfg delete` after a cleanup PR\nhas merged and the SDK has redeployed:\n\n qfg cleanup verify my.flag.key && qfg delete my.flag.key\n\nThe trailing window is stricter than the `qfg cleanup remove` 2-day gate on\npurpose — `remove` only writes a payload describing the flag, but `delete`\npermanently removes the flag definition, so we want a longer quiet period\nbefore chaining. Bump --days N if you want a more conservative window.", "examples": [ "<%= config.bin %> <%= command.id %> my.flag.key", "<%= config.bin %> <%= command.id %> my.flag.key --days 14", "<%= config.bin %> <%= command.id %> my.flag.key --json", "<%= config.bin %> <%= command.id %> my.flag.key && <%= config.bin %> delete my.flag.key" ], "flags": { "json": { "description": "Return structured object for agent consumption", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "days": { "description": "Number of trailing calendar days that must have zero evals", "name": "days", "default": 7, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cleanup:verify", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "cleanup", "verify.js" ] }, "migrate:doctor": { "aliases": [], "args": {}, "description": "Preflight health checks for `qfg migrate`. Verifies auth, workspace provisioning, working tree, and identifier collisions.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY", "<%= config.bin %> <%= command.id %> --dir ./my-workspace --language node", "<%= config.bin %> <%= command.id %> --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "api-key": { "description": "Legacy SDK API key to validate against the source", "name": "api-key", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "dir": { "description": "Workspace directory to check (git clean / identifier map)", "name": "dir", "default": ".", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "from": { "description": "Legacy SDK to migrate from", "name": "from", "default": "launch", "hasDynamicHelp": false, "multiple": false, "options": [ "launch" ], "type": "option" }, "language": { "description": "Customer SDK language — used to warn when datadir mode is unavailable (e.g. javascript-browser)", "name": "language", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "migrate:doctor", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "migrate", "doctor.js" ] }, "migrate:my-code": { "aliases": [], "args": {}, "description": "Migrate Launch SDK call sites in your codebase to Quonfig SDK call sites (invokes the qfg-migrate-code Claude skill)", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --from launch", "<%= config.bin %> <%= command.id %> --dry-run" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dry-run": { "description": "Show what would be migrated without editing any files", "name": "dry-run", "allowNo": false, "type": "boolean" }, "from": { "description": "Legacy SDK to migrate from", "name": "from", "default": "launch", "hasDynamicHelp": false, "multiple": false, "options": [ "launch" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "migrate:my-code", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "migrate", "my-code.js" ] }, "migrate:status": { "aliases": [], "args": {}, "description": "Show the status of a workspace migrated with `qfg migrate`. Reads .qf/import-state.json and summarizes source, counts, and next steps.", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --dir ./my-workspace", "<%= config.bin %> <%= command.id %> --json" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dir": { "description": "Workspace directory to inspect", "name": "dir", "default": ".", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "migrate:status", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "migrate", "status.js" ] }, "sdk-key:create": { "aliases": [], "args": {}, "description": "Create a new SDK key", "examples": [ "<%= config.bin %> <%= command.id %> --environment production --type server", "<%= config.bin %> <%= command.id %> --environment staging --type browser" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "char": "e", "description": "Environment name (e.g. production, staging)", "name": "environment", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "type": { "char": "t", "description": "Key type: server (backend) or browser (frontend)", "name": "type", "required": false, "hasDynamicHelp": false, "multiple": false, "options": [ "server", "browser" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "sdk-key:create", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "sdk-key", "create.js" ] }, "sdk-key:list": { "aliases": [], "args": {}, "description": "List SDK keys for your workspace", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> --environment production" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "char": "e", "description": "Filter by environment name", "name": "environment", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "sdk-key:list", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "sdk-key", "list.js" ] }, "sdk-key:revoke": { "aliases": [], "args": { "keyId": { "description": "ID of the SDK key to revoke", "name": "keyId", "required": true } }, "description": "Revoke an SDK key by its ID", "examples": [ "<%= config.bin %> <%= command.id %> a1b2c3d4-e5f6-7890-abcd-ef1234567890" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "workspace": { "char": "w", "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)", "helpGroup": "GLOBAL", "name": "workspace", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "char": "p", "description": "Deprecated: use --workspace instead", "helpGroup": "GLOBAL", "hidden": true, "name": "profile", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "sdk-key:revoke", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "sdk-key", "revoke.js" ] }, "workspace:bootstrap": { "aliases": [], "args": {}, "description": "Push a local git repo to Gitea as this workspace's config repository", "examples": [ "<%= config.bin %> workspace bootstrap --dir ./our-config", "<%= config.bin %> workspace bootstrap --dir ./launch-migrator/output", "<%= config.bin %> workspace bootstrap --dir ./our-config --skip-validate" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "dir": { "description": "Local directory to push (defaults to current directory)", "name": "dir", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "force": { "description": "Force push even if remote already has commits", "name": "force", "allowNo": false, "type": "boolean" }, "skip-validate": { "description": "Skip config validation before pushing", "name": "skip-validate", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "workspace:bootstrap", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "workspace", "bootstrap.js" ] }, "workspace:create": { "aliases": [], "args": { "slug": { "description": "Workspace slug (lowercase letters, numbers, hyphens)", "name": "slug", "required": true } }, "description": "Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.", "examples": [ "<%= config.bin %> <%= command.id %> my-team", "<%= config.bin %> <%= command.id %> lt-21-smoke --name \"Load Test 21\"", "<%= config.bin %> <%= command.id %> my-team --org 11111111-1111-1111-1111-111111111111" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" }, "name": { "description": "Human-readable display name (defaults to the slug)", "name": "name", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "org": { "description": "Organization UUID or slug. Required when you belong to more than one organization; inferred otherwise.", "name": "org", "required": false, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "workspace:create", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "workspace", "create.js" ] }, "workspace:switch": { "aliases": [], "args": { "slug": { "description": "Workspace pin in `/` form. Omit for an interactive picker.", "name": "slug", "required": false } }, "description": "Switch the saved default profile to a different (org, workspace) pair", "examples": [ "<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> acme/production" ], "flags": { "json": { "description": "Format output as json.", "helpGroup": "GLOBAL", "name": "json", "allowNo": false, "type": "boolean" }, "interactive": { "description": "Force interactive mode", "helpGroup": "GLOBAL", "name": "interactive", "allowNo": true, "type": "boolean" }, "no-color": { "description": "Do not colorize output", "env": "NO_COLOR", "helpGroup": "GLOBAL", "name": "no-color", "allowNo": false, "type": "boolean" }, "verbose": { "description": "Verbose output", "helpGroup": "GLOBAL", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "workspace:switch", "pluginAlias": "@quonfig/cli", "pluginName": "@quonfig/cli", "pluginType": "core", "strict": true, "enableJsonFlag": true, "isESM": true, "relativePath": [ "dist", "commands", "workspace", "switch.js" ] } }, "version": "0.0.72" }