@flagify/cli 1.7.0 → 2.1.0

package/README.md

@@ -26,13 +26,20 @@ echo 'alias flag="flagify"' >> ~/.zshrc && source ~/.zshrc
 ## Quick Start
 
 ```bash
-# Login to your account
-flagify login
+# Sign in (creates a profile called "default" on first run)
+flagify auth login
 
-# Discover your resources
-flagify workspaces list
-flagify projects list -w <workspace-id>
-flagify projects get <project-id>
+# Or add a named profile — handy when you juggle work and personal accounts
+flagify auth login --profile work
+flagify auth list
+flagify auth switch personal
+
+# Pin a repo to a workspace/project/environment in a committable file
+flagify init --workspace-id ws_01J... --project-id pr_01J... --environment development
+
+# See the resolved context for this invocation + the source of every field
+flagify status
+flagify status --format json
 
 # Manage feature flags
 flagify flags list -p <project-id>
@@ -46,9 +53,17 @@ flagify flags toggle my-flag -p <project-id>
 
 | Command | Description |
 |---------|-------------|
-| `flagify login` | Authenticate with email and password |
-| `flagify logout` | Clear stored credentials |
-| `flagify whoami` | Show the currently authenticated user |
+| `flagify auth login` | Sign in with the browser flow (`--profile <name>` to add a second identity without signing out of the first). If the current repo has a `.flagify/project.json` whose `preferredProfile` points elsewhere, the CLI prompts (TTY only) to rewrite the pin to the profile you just authenticated. If the browser comes back without tokens (expired session / interrupted flow), the CLI auto-reopens the flow on a TTY (up to 3 attempts); non-TTY runs get a single actionable error. |
+| `flagify auth logout` | Sign out of the active profile (`--profile <name>` or `--all`) |
+| `flagify auth list` | List signed-in profiles (`--format json`) |
+| `flagify auth switch <name>` | Set the active profile |
+| `flagify auth remove <name>` | Delete a profile and any repo bindings that point to it |
+| `flagify auth rename <old> <new>` | Rename a profile and update bindings |
+| `flagify whoami` | Show the current user and pinned profile (`--format json`) |
+| `flagify status` | Show the resolved context for this invocation with `sources` per field (`--format json`) |
+| `flagify init` | Write `.flagify/project.json` for the current repo (`--print` to dry-run, `--force` to overwrite in non-TTY) |
+| `flagify project bind --profile <name>` | Bind this repo to a local profile without touching the project file |
+| `flagify project set <field> <value>` | Update a field in `.flagify/project.json` (environment, project, workspace, preferred-profile, …) |
 | `flagify workspaces list` | List your workspaces (`--format json`) |
 | `flagify workspaces pick` | Interactively select a default workspace |
 | `flagify projects list` | List projects in a workspace (`--format json`) |
@@ -69,8 +84,13 @@ flagify flags toggle my-flag -p <project-id>
 | `flagify segments delete <id>` | Delete a segment by ID |
 | `flagify targeting list <flag-key>` | Show targeting rules for a flag in an environment (`--format json`; returns `{flag, environment, rules}`) |
 | `flagify targeting set <flag-key>` | Replace all targeting rules for a flag (`--rules '<json>'`, `--format json`) |
+| `flagify webhooks list` | List webhooks in a project; defaults to the aggregate view across environments (`--environment` to scope, `--format json`) |
+| `flagify webhooks create` | Create a webhook subscribed to one or more flag/targeting events. Environment-scoped — the signing secret is printed exactly once |
+| `flagify webhooks get <webhook-id>` | Show a webhook's URL, environment, events, and status (`--format json`) |
+| `flagify webhooks delete <webhook-id>` | Delete a webhook subscription |
+| `flagify webhooks deliveries <webhook-id>` | Show recent delivery attempts with status code and response excerpt (`--format json`, `--limit N`) |
 | `flagify whoami` | Show current authenticated user (`--format json`) |
-| `flagify ai-setup` | Generate AI tool configs (Claude, Cursor, Copilot, Windsurf). Includes the integrations catalogue; use `--include-flags` for a snapshot |
+| `flagify ai-setup` | Generate AI tool configs (Claude Code skill, Cursor, Copilot, Windsurf). Includes the integrations catalogue; use `--include-flags` for a snapshot |
 | `flagify types` | Generate typed flag key constants (`--typescript` or `--go`) for compile-time safety in application code |
 | `flagify config` | Show current configuration (`--format json`) |
 | `flagify config set <key> <value>` | Set a config value (api-url, console-url, workspace, project, environment) |
@@ -97,7 +117,20 @@ flagify completion fish > ~/.config/fish/completions/flagify.fish
 
 ## Configuration
 
-The CLI stores credentials in `~/.flagify/config.json`. Use `--project` and `--environment` flags to target specific resources.
+Credentials live under named profiles in `~/.flagify/config.json` (schema v2, migrated automatically from any older flat file with a `.bak` preserved alongside).
+
+Scope is resolved per-invocation. Precedence, highest first:
+
+1. CLI flags (`--profile`, `--workspace-id`, `--workspace`, `--project-id`, `--project`, `--environment`).
+2. Environment variables (`FLAGIFY_PROFILE`, `FLAGIFY_WORKSPACE_ID`, `FLAGIFY_WORKSPACE`, `FLAGIFY_PROJECT_ID`, `FLAGIFY_PROJECT`, `FLAGIFY_ENVIRONMENT`, `FLAGIFY_API_URL`).
+3. `.flagify/project.json` walked up from the current directory.
+4. Local binding recorded by `flagify project bind`.
+5. The active profile's defaults.
+6. Built-in defaults.
+
+Run `flagify status` to see exactly which signal won for each field. See the full CLI reference at [flagify.dev/docs/cli](https://flagify.dev/docs/cli) for multi-account workflows and project file details.
+
+> **Ephemeral tokens**: set `FLAGIFY_ACCESS_TOKEN` (and optionally `FLAGIFY_REFRESH_TOKEN`) to override the stored credentials for a single invocation. The CLI does not persist refreshed tokens when these are set.
 
 ## Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flagify/cli",
-  "version": "1.7.0",
+  "version": "2.1.0",
   "description": "Flagify CLI — manage feature flags from the terminal",
   "license": "MIT",
   "bin": {