@withgauge/cli 0.5.0 → 0.7.0

package/README.md

@@ -1,12 +1,13 @@
 # @withgauge/cli
 
-`gauge` — the [Gauge](https://agents.withgauge.com) command-line interface. Manage
-your prompts, repositories, and agent runs, and watch runs live from your
-terminal.
+`gauge` — the [Gauge](https://agents.withgauge.com) command-line interface.
+Manage your eval sets, Agent Preference prompts, run presets, and agent runs,
+and watch runs live from your terminal.
 
 ```sh
 npm install -g @withgauge/cli
-gauge auth login          # opens your browser to authorize this machine
+gauge onboard             # sign in, create a workspace, seed starter measurements
+gauge auth login          # (or just sign in)
 gauge orgs use <org>      # set your default organization
 ```
 
@@ -15,30 +16,39 @@ Requires Node.js ≥ 22.12.
 ## Usage
 
 ```sh
-gauge prompts list                # your prompts
-gauge runs list --status running  # recent & active runs
+gauge status                      # the org at a glance
+gauge evals list                  # judged agent-experience measurements
+gauge preference list             # Agent Preference prompts and measurements
+gauge presets list                # run configurations (repo × persona × agents × skills × MCP)
+gauge evals attach <id> --preset <presetId>   # schedule a preset on an eval (prints the bill first)
+gauge evals run <id>              # launch now (ORG-funded, credit-gated)
 gauge runs watch <run-id>         # follow a run as the agent works
-gauge runs fork <run-id> --prompt "Try a different approach"
-gauge repos list                  # your repository catalog
 gauge stats rankings -o json      # brand rankings (share of voice) as JSON
-gauge query fields --dataset installs                  # discover a dataset's dimensions/metrics
 gauge query -d ecosystem -m installs,install_rate -o json   # a flexible report
 ```
 
 Run `gauge --help` (or `gauge <command> --help`) for the full command set:
-prompts, schedules, repos, runs, stats, query, brands, tags, topics, provider
-keys, billing, and more.
+evals, preference, presets, personas, skills, mcp, cycles, repos, runs,
+experiments, batches, brands, tags, actions, impl, dashboards, members, org,
+provider keys, billing, usage, stats, query, and more.
+
+**Run presets** are the unit of configuration: an eval set or preference
+prompt runs whatever presets are attached to it, every cycle. `gauge presets
+create --name api-main --repo https://github.com/acme/api --agent
+claude-code:claude-opus-4-8 --skill acme-cli@1.2.0` authors one;
+`gauge evals attach` / `gauge preference attach` schedules it. Attaching
+spends money on a schedule, so `attach` and `run` print the per-cycle run
+arithmetic and ask before acting (`--yes` skips the prompt for scripts).
 
 `gauge query` builds flexible reports over your event warehouse (a GA4
-`run_report` analog): pick a `--dataset`, group by `--dimensions`, and aggregate
-`--metrics`, or pass a whole spec with `--json` (the agent-friendly surface).
-`gauge query datasets` / `gauge query fields --dataset <name>` list what you can
-ask for.
+`run_report` analog): pick a `--dataset`, group by `--dimensions` (including
+`run_preset`), and aggregate `--metrics`, or pass a whole spec with `--json`.
+`gauge query datasets` / `gauge query fields --dataset <name>` list what you
+can ask for.
 
 To launch runs declaratively, `gauge apply -f <spec>.json`. Discover the spec
 format without leaving the terminal: `gauge apply --example` prints a starter
-spec (`gauge apply --example > battery.json`), and `gauge apply --schema` prints
-its JSON Schema.
+spec and `gauge apply --schema` prints its JSON Schema.
 
 Every read supports `-o json` for scripting. `GAUGE_API_TOKEN` overrides
 stored credentials (useful in CI). Exit codes: `0` ok · `1` error ·