CLI Overview

The Flagify CLI lets you manage feature flags directly from your terminal. It integrates into your development workflow and CI/CD pipelines.

Installation

npm

npm install -g @flagify/cli

Homebrew (macOS / Linux)

brew tap flagifyhq/tap
brew install flagify

Binary download

Download the latest release from GitHub Releases for your platform (macOS, Linux, Windows — amd64 and arm64).

Verify the installation:

flagify version

Authentication

Sign in with your Flagify account:

flagify auth login

The CLI opens the Flagify console in your browser, you log in (if needed) and click Authorize. Tokens are stored locally under a profile named default in ~/.flagify/config.json.

To juggle multiple accounts on the same machine — a common case when the work account is separate from a personal one — pass --profile on subsequent logins:

flagify auth login --profile work
flagify auth login --profile personal
flagify auth list
flagify auth switch personal

See Configuration for the full profile model and how scope is resolved per invocation.

To sign out of the active profile:

flagify auth logout

Quick usage

List all flags

flagify flags list --project <project-id>

Create a new flag

flagify flags create my-flag --project <project-id> --type boolean

Toggle a flag

flagify flags toggle my-flag --project <project-id> --environment development

The toggle command flips the current state — if the flag is ON it turns OFF, and vice versa.

Pin a repo to a project

Commit .flagify/project.json so teammates share the same workspace/project/environment without configuring each machine:

flagify init --workspace-id ws_01J... --project-id pr_01J... --environment development

Global options

These options work with any command:

OptionAliasDescription
--profileProfile to use for this invocation
--workspace-idWorkspace ULID (wins over --workspace when both are set)
--workspace-wWorkspace slug
--project-idProject ULID (wins over --project when both are set)
--project-pProject slug
--environment-eTarget environment key
--yes-ySkip confirmation prompts
--help-hShow help for any command

What’s next