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:
| Option | Alias | Description |
|---|---|---|
--profile | Profile to use for this invocation | |
--workspace-id | Workspace ULID (wins over --workspace when both are set) | |
--workspace | -w | Workspace slug |
--project-id | Project ULID (wins over --project when both are set) | |
--project | -p | Project slug |
--environment | -e | Target environment key |
--yes | -y | Skip confirmation prompts |
--help | -h | Show help for any command |
What’s next
- Commands reference — full list of all CLI commands
- Configuration — config file and environment details