@quonfig/cli 0.2.3 → 0.3.0

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.2.3 linux-x64 node-v24.4.1
+@quonfig/cli/0.3.0 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -125,6 +125,7 @@ script doesn't need to know which env it's running in.
 * [`qfg activity feed`](#qfg-activity-feed)
 * [`qfg activity history [NAME]`](#qfg-activity-history-name)
 * [`qfg activity restore [NAME]`](#qfg-activity-restore-name)
+* [`qfg agent install-skill`](#qfg-agent-install-skill)
 * [`qfg audit-log [NAME]`](#qfg-audit-log-name)
 * [`qfg cleanup`](#qfg-cleanup)
 * [`qfg cleanup list`](#qfg-cleanup-list)
@@ -132,6 +133,8 @@ script doesn't need to know which env it's running in.
 * [`qfg cleanup status [NAME]`](#qfg-cleanup-status-name)
 * [`qfg cleanup verify [NAME]`](#qfg-cleanup-verify-name)
 * [`qfg config-schema`](#qfg-config-schema)
+* [`qfg contexts`](#qfg-contexts)
+* [`qfg contexts search CONTEXTTYPE QUERY`](#qfg-contexts-search-contexttype-query)
 * [`qfg create NAME`](#qfg-create-name)
 * [`qfg delete NAME`](#qfg-delete-name)
 * [`qfg flag info [NAME]`](#qfg-flag-info-name)
@@ -201,7 +204,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -230,7 +233,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -265,7 +268,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -299,7 +302,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -338,7 +341,52 @@ EXAMPLES
   $ qfg activity restore request.timeout --type config --yes
 ```
 
-_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/activity/restore.ts)_
+
+## `qfg agent install-skill`
+
+Install the Quonfig agent skill into this repo so coding agents use Quonfig correctly.
+
+```
+USAGE
+  $ qfg agent install-skill [--json] [--interactive] [--no-color] [--verbose] [--add-pointer] [--dir <value>] [--force]
+
+FLAGS
+  --add-pointer  Also append a one-line pointer to the skill in ./AGENTS.md (created if missing)
+  --dir=<value>  [default: .claude/skills] Skills directory to install into, relative to the current directory
+  --force        Overwrite skill files you have edited locally
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Install the Quonfig agent skill into this repo so coding agents use Quonfig correctly.
+
+  Writes .claude/skills/quonfig/ (SKILL.md + references/) — the same files as
+  `claude plugin install quonfig@quonfig` from github.com/quonfig/skills, embedded
+  in this qfg build (no network). Claude Code picks the skill up automatically;
+  for Codex, Cursor and other agents that read AGENTS.md, add --add-pointer.
+
+  Safe to re-run: files still as qfg wrote them are upgraded in place, files you
+  edited are left alone (the command fails and lists them) unless you pass --force.
+
+  This skill is for APPLICATION repos (SDK + qfg + MCP usage). A workspace repo
+  created by `qfg init` has its own AGENTS.md/CLAUDE.md for editing config JSON.
+
+EXAMPLES
+  $ qfg agent install-skill
+
+  $ qfg agent install-skill --add-pointer
+
+  $ qfg agent install-skill --dir .agents/skills
+
+  $ qfg agent install-skill --force
+```
+
+_See code: [src/commands/agent/install-skill.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/agent/install-skill.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -366,7 +414,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/audit-log.ts)_
 
 ## `qfg cleanup`
 
@@ -387,14 +435,15 @@ DESCRIPTION
 
   The cleanup workflow turns a flag's "Ready for cleanup" marker into an end-to-end
   removal flow: surface the flags that are safe to retire, hand the actual code
-  removal to the qfg-flag-cleanup Claude skill, then delete the flag definition
-  once the call sites are gone.
+  removal to your coding agent with the Quonfig agent skill (install it with
+  `qfg agent install-skill`), then delete the flag definition once the call
+  sites are gone.
 
   Lifecycle (high-level):
   1. Owner flips readyForCleanup=true in the UI            (already exists)
   2. qfg cleanup list                                       see candidates + telemetry
   3. qfg cleanup status <key>                               drill into one flag
-  4. qfg cleanup remove <key>                               handoff to the cleanup skill
+  4. qfg cleanup remove <key>                               handoff to the agent skill
   5. PR merges, SDK redeploys, telemetry confirms 0 evals
   6. qfg cleanup verify <key>                               (optional) confirm safe
   7. qfg delete <key>                                       remove the flag definition
@@ -407,7 +456,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key
 ```
 
-_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup.ts)_
+_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/cleanup.ts)_
 
 ## `qfg cleanup list`
 
@@ -445,7 +494,8 @@ DESCRIPTION
   above plus the raw eval counts your agent can reason about itself.
 
   Once you've picked a candidate, run `qfg cleanup status <key>` for the
-  drill-in or hand off the removal to the qfg-flag-cleanup Claude skill.
+  drill-in, or `qfg cleanup remove <key>` to hand the removal to your coding agent
+  with the Quonfig agent skill.
 
 EXAMPLES
   $ qfg cleanup list
@@ -453,11 +503,11 @@ EXAMPLES
   $ qfg cleanup list --json
 ```
 
-_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/list.ts)_
+_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/cleanup/list.ts)_
 
 ## `qfg cleanup remove [NAME]`
 
-Write a cleanup payload for a ready-for-cleanup flag and hand off to the qfg-flag-cleanup Claude skill.
+Write a cleanup payload for a ready-for-cleanup flag and hand off to the Quonfig agent skill.
 
 ```
 USAGE
@@ -477,14 +527,16 @@ GLOBAL FLAGS
       --verbose            Verbose output
 
 DESCRIPTION
-  Write a cleanup payload for a ready-for-cleanup flag and hand off to the qfg-flag-cleanup Claude skill.
+  Write a cleanup payload for a ready-for-cleanup flag and hand off to the Quonfig agent skill.
 
   Modeled on `qfg migrate my-code` — this command never edits source files
   itself. It validates that the flag is marked readyForCleanup=true, refuses to
   proceed if there are still evals_2d > 0 (use --force to override), writes
   `.qf/cleanup/<key>.json` describing the flag's current rule shape +
-  telemetry, and prints instructions to invoke the qfg-flag-cleanup skill which
-  asks the engineer which value should "win" and applies the inlining.
+  telemetry, and prints how to have your coding agent remove the call sites with
+  the quonfig agent skill (its references/retire-a-flag.md), which asks the
+  engineer which value should "win" and applies the inlining. Install the skill
+  with `qfg agent install-skill` or `claude plugin install quonfig@quonfig`.
 
   The payload deliberately does NOT suggest a winning value; that's the
   engineer's call. Run `qfg cleanup status <key>` first if you want to inspect
@@ -498,7 +550,7 @@ EXAMPLES
   $ qfg cleanup remove my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/remove.ts)_
+_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/cleanup/remove.ts)_
 
 ## `qfg cleanup status [NAME]`
 
@@ -524,13 +576,13 @@ DESCRIPTION
   Drill into one ready-for-cleanup flag — show telemetry across all environments and the current rule shape.
 
   Use this after `qfg cleanup list` to inspect a specific flag before handing
-  removal off to the qfg-flag-cleanup Claude skill. The eval counts come from
+  removal off to the Quonfig agent skill. The eval counts come from
   analytics.configSparklines (the same backing data the per-flag sparklines on
   the flag detail page use), summed into 24h/2d/7d/30d windows so you can decide
   whether it's safe to retire.
 
   Pass --json for the structured object including the full rule shape per
-  environment — the cleanup skill consumes this directly.
+  environment — the agent skill consumes this directly.
 
 EXAMPLES
   $ qfg cleanup status my.flag.key
@@ -538,7 +590,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/status.ts)_
+_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/cleanup/status.ts)_
 
 ## `qfg cleanup verify [NAME]`
 
@@ -584,7 +636,7 @@ EXAMPLES
   $ qfg cleanup verify my.flag.key && qfg delete my.flag.key
 ```
 
-_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/verify.ts)_
+_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/cleanup/verify.ts)_
 
 ## `qfg config-schema`
 
@@ -613,7 +665,82 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/config-schema.ts)_
+
+## `qfg contexts`
+
+Look up contexts (organizations, users, ...) your SDKs have reported, to target them by key.
+
+```
+USAGE
+  $ qfg contexts [--json] [--interactive] [--no-color] [--verbose]
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Look up contexts (organizations, users, ...) your SDKs have reported, to target them by key.
+
+EXAMPLES
+  $ qfg contexts search organization formhealth
+```
+
+_See code: [src/commands/contexts.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/contexts.ts)_
+
+## `qfg contexts search CONTEXTTYPE QUERY`
+
+Find a context's key from a name, to target it in a rule.
+
+```
+USAGE
+  $ qfg contexts search CONTEXTTYPE QUERY [--json] [--interactive] [--no-color] [--verbose] [-w <value>]
+    [--environment <value>] [--limit <value>]
+
+ARGUMENTS
+  CONTEXTTYPE  Context type to search, e.g. organization or user (the part before ".key" in a rule)
+  QUERY        Case-insensitive text matched against each context key and its reported properties (e.g. a name)
+
+FLAGS
+  --environment=<value>  Only contexts reported from this environment (default: every environment)
+  --limit=<value>        [default: 20] Maximum number of matches (1-100)
+
+GLOBAL FLAGS
+  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
+      --[no-]interactive   Force interactive mode
+      --json               Format output as json.
+      --no-color           Do not colorize output
+      --verbose            Verbose output
+
+DESCRIPTION
+  Find a context's key from a name, to target it in a rule.
+
+  Targeting rules should match a context by its KEY (<contextType>.key, e.g.
+  organization.key or user.key), not by a slug, email or name. This searches the
+  contexts your SDKs have reported through telemetry, matching the query against
+  each context's key and properties, and prints each match's key, its name and
+  its email (blank when the context reported none), most recently seen first.
+
+  Only contexts your SDKs have reported are searchable. If nothing matches, the key
+  is unknown: get it from whoever owns that customer rather than targeting a slug
+  or email instead.
+
+  Pass a key as the query to see its name and email.
+
+  --json prints {contexts: [{key, name, email?}]}: name is null when the context
+  reported no name, and email is present only when it reported one.
+
+EXAMPLES
+  $ qfg contexts search organization formhealth
+
+  $ qfg contexts search user barry@example.com --environment production
+
+  $ qfg contexts search organization formhealth --json
+```
+
+_See code: [src/commands/contexts/search.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/contexts/search.ts)_
 
 ## `qfg create NAME`
 
@@ -700,7 +827,7 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -746,7 +873,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -950,7 +1077,7 @@ EXAMPLES
   $ qfg generate --targets node-ts -o ./dist # combine with targets
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -973,7 +1100,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -1005,7 +1132,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -1031,7 +1158,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -1079,7 +1206,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -1119,7 +1246,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -1149,7 +1276,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -1189,7 +1316,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -1214,7 +1341,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1279,7 +1406,7 @@ EXAMPLES
   $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
 ```
 
-_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1304,7 +1431,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1327,7 +1454,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1392,7 +1519,7 @@ EXAMPLES
   $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1430,7 +1557,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1462,7 +1589,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1493,7 +1620,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1548,7 +1675,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1595,7 +1722,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1644,7 +1771,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1695,7 +1822,7 @@ EXAMPLES
   $ qfg run --env DATABASE_URL=db.url --preserve-env --environment=staging -- npm test
 ```
 
-_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1733,7 +1860,7 @@ EXAMPLES
   $ qfg schema my-schema --set-json-schema=@schemas/my-schema.json --protected
 ```
 
-_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1760,7 +1887,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1792,7 +1919,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1821,7 +1948,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1848,7 +1975,7 @@ EXAMPLES
   $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg serve`
 
@@ -1906,7 +2033,7 @@ EXAMPLES
   $ qfg serve --port 6581 --frontend-sdk-key PUBLIC_KEY
 ```
 
-_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/serve.ts)_
+_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1959,6 +2086,10 @@ DESCRIPTION
   To see all current values and rules for a flag:
   qfg info my.flag
 
+  To target specific organizations or users, write rules on their KEY
+  (organization.key, user.key), not a slug or email; find a key from a name with:
+  qfg contexts search organization formhealth
+
 ALIASES
   $ qfg toggle
 
@@ -1982,7 +2113,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -2073,7 +2204,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -2105,7 +2236,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -2158,6 +2289,10 @@ DESCRIPTION
   To see all current values and rules for a flag:
   qfg info my.flag
 
+  To target specific organizations or users, write rules on their KEY
+  (organization.key, user.key), not a slug or email; find a key from a name with:
+  qfg contexts search organization formhealth
+
 ALIASES
   $ qfg toggle
 
@@ -2212,7 +2347,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -2235,7 +2370,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -2258,7 +2393,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -2291,7 +2426,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2325,7 +2460,7 @@ EXAMPLES
   $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
 ```
 
-_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2353,7 +2488,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.3.0/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development