Reflag CLI

Command-line interface for interacting with Reflag services. The CLI allows you to manage apps, flags, authentication, and generate TypeScript types for your Reflag flags. With this tool, you can streamline your flagging workflow directly from your terminal.

Installation

Install the CLI as a development dependency in your project:

Run the new command from your project's root directory to initialize the CLI, create a flag, and generate TypeScript types in one step:

Related MCP server: ZeroPath MCP Server

Migrating from Bucket SDK

If you're migrating from the Bucket CLI, here are the key changes to be aware of:

• Command name: Changed from bucket to reflag

• Type definitions file: Renamed from features.d.ts to flags.d.ts (manually remove the old file if it was committed)

• Authentication file: Changed from .bucket-auth to .reflag-auth (rename or remove the old file)

• Configuration file: Changed from bucket.config.json to reflag.config.json (rename or remove the old file)

• Command: features command is now flags

• Environment variable: Use REFLAG_API_KEY instead of BUCKET_API_KEY

Important: Update your scripts, build steps, and .gitignore patterns to reflect these changes.

Individual Commands

For more control, you can run each command individually:

Configuration

The CLI creates a reflag.config.json file in your project directory when you run reflag init. This file contains all the necessary settings for your Reflag integration.

Configuration File Structure

Here are all the configuration options available in the reflag.config.json file:

You can override these settings using command-line options for individual commands.

Commands

reflag init

Initialize a new Reflag configuration in your project. This creates a reflag.config.json file with your settings and prompts for any required information not provided via options.

Options:

• --overwrite: Overwrite existing configuration file if one exists.

• --app-id <id>: Set the application ID.

• --key-format <format>: Set the key format for flags.

reflag new [flagName]

All-in-one command to get started quickly. This command combines init, flag creation, and type generation in a single step. Use this for the fastest way to get up and running with Reflag.

Options:

• --key: Specific key for the flag.

• --app-id: App ID to use.

• --key-format: Format for flag keys (custom, snake, camel, etc.).

• --out: Path to generate TypeScript types.

• --format: Format of the generated types (react or node).

If you prefer more control over each step, you can use the individual commands (init, flags create, flags types) instead.

reflag login

Authenticate with your Reflag account. This stores your credentials securely for subsequent operations.

reflag logout

Sign out from your Reflag account and remove stored credentials.

reflag flags

Manage your Reflag flags with these subcommands:

reflag flags create [flagName]

Create a new flag in your Reflag app. The command guides you through the flag creation process with interactive prompts if options are not provided.

Options:

• --key: Specific key for the flag.

• --app-id: App ID to use.

• --key-format: Format for flag keys.

reflag flags list

List all flags for the current app. This helps you visualize what flags are available and their current configurations.

Options:

• --app-id: App ID to use.

reflag flags types

Generate TypeScript types for your flags. This ensures type safety when using Reflag flags in your TypeScript/JavaScript applications.

Options:

• --app-id: App ID to use.

• --out: Path to generate TypeScript types.

• --format: Format of the generated types (react or node).

reflag apps

Commands for managing Reflag apps.

Global Options

These options can be used with any command:

• --debug: Enable debug mode for verbose output.

• --base-url <url>: Set the base URL for Reflag API.

• --api-url <url>: Set the API URL directly (overrides base URL).

• --api-key <key>: Reflag API key for non-interactive authentication.

• --help: Display help information for a command.

AI-Assisted Development

Reflag provides powerful AI-assisted development capabilities through rules and Model Context Protocol (MCP). These features help your AI development tools better understand your flags and provide more accurate assistance.

Reflag Rules (Recommended)

The rules command helps you set up AI-specific rules for your project. These rules enable AI tools to better understand how to work with Reflag flags and how they should be used in your codebase.

Options:

• --format: Format to add rules in:

  • cursor: Adds rules to .cursor/rules/reflag.mdc for Cursor IDE integration.

  • copilot: Adds rules to .github/copilot-instructions.md for GitHub Copilot integration.

• --yes: Skip confirmation prompts and overwrite existing files without asking.

This command adds rules to your project that provide AI tools with context about how to set up and use Reflag flags. For the copilot format, the rules are added to a dedicated section in the file, allowing you to maintain other copilot instructions alongside Reflag's rules.

Model Context Protocol

The Model Context Protocol (MCP) is an open protocol that provides a standardized way to connect AI models to different data sources and tools. In the context of Reflag, MCP enables your code editor to understand your flags, their states, and their relationships within your codebase. This creates a seamless bridge between your flag management workflow and AI-powered development tools. The MCP server is hosted by Reflag, making it easy to get started.

**Note: The Reflag server. However, in recent versions of the Reflag CLI, the mcp command has been repurposed to help you connect to the new remote MCP server.**_

Setting up MCP

The mcp command helps you configure your editor or AI client to connect with Reflag's remote MCP server. This allows your AI tools to understand your flags and provide more contextual assistance.

Options:

• --editor: The editor/client to configure:

  • cursor: Cursor IDE

  • vscode: Visual Studio Code

  • claude: Claude Desktop

  • windsurf: Windsurf

• --scope: Whether to configure settings globally or locally for the project.

The command will guide you through:

1. Selecting which editor/client to configure.

2. Choosing which Reflag app to connect to.

3. Deciding between global or project-local configuration.

4. Setting up the appropriate configuration file for your chosen editor .

Note: The setup uses

Using in CI/CD Pipelines (Beta)

The Reflag CLI is designed to work seamlessly in CI/CD pipelines. For automated environments where interactive login is not possible, use the --api-key option or specify the API key in the REFLAG_API_KEY environment variable.

Important restrictions:

• When using --api-key, the login and logout commands are disabled

• API keys bypass all interactive authentication flows

• API keys are bound to one app only. Commands such as apps list will only return the bound app

• Store API keys securely using your CI/CD platform's secret management

Example CI workflow:

Development

Requirements

• Node.js >=18.0.0

License

MIT License Copyright (c) 2025 Bucket ApS