Welcome

flagctl

GitHub-grounded feature flags. Define them in YAML, version them in your repo, rollout through your dashboard.

Flags live as YAML files next to your code, get applied through a signed, hash-chained control plane, and evaluate locally in your SDK with sub-millisecond latency. The dashboard, CLI, and SDK all hit the same REST API — every operation is reproducible from a terminal.

# install the CLI
brew install flagctl

# authenticate
flagctl auth login

# link a directory to a project
flagctl link acme/web

# apply your flags
flagctl apply

Quick start

From zero to your first flag in 60 seconds.

Installation

One-line install for macOS and Linux.

Projects

One repo, one project. Each has its own flags and audit.

Flags

Boolean and multi-variant flags defined in YAML.

CLI overview

The flagctl CLI — same operations as the dashboard.

Next.js SDK

@flagctl/next — FlagBoundary, streaming client, sticky bucketing.

Surface

The dashboard, CLI (flagctl), and SDK packages (@flagctl/next, @flagctl/react, @flagctl/sdk) all talk to the same REST API at https://api.flagctl.dev/v1/ over HTTPS with a Bearer key plus an X-Flagctl-Project header. Everything you can do in one surface, you can do in the others.