@withgauge/cli 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +11 -2
  2. package/dist/index.js +1373 -352
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -18,13 +18,22 @@ Requires Node.js ≥ 22.12.
18
18
  gauge prompts list # your prompts
19
19
  gauge runs list --status running # recent & active runs
20
20
  gauge runs watch <run-id> # follow a run as the agent works
21
+ gauge runs fork <run-id> --prompt "Try a different approach"
21
22
  gauge repos list # your repository catalog
22
23
  gauge stats rankings -o json # brand rankings (share of voice) as JSON
24
+ gauge query fields --dataset installs # discover a dataset's dimensions/metrics
25
+ gauge query -d ecosystem -m installs,install_rate -o json # a flexible report
23
26
  ```
24
27
 
25
28
  Run `gauge --help` (or `gauge <command> --help`) for the full command set:
26
- prompts, schedules, repos, runs, stats, brands, tags, topics, provider keys,
27
- billing, and more.
29
+ prompts, schedules, repos, runs, stats, query, brands, tags, topics, provider
30
+ keys, billing, and more.
31
+
32
+ `gauge query` builds flexible reports over your event warehouse (a GA4
33
+ `run_report` analog): pick a `--dataset`, group by `--dimensions`, and aggregate
34
+ `--metrics`, or pass a whole spec with `--json` (the agent-friendly surface).
35
+ `gauge query datasets` / `gauge query fields --dataset <name>` list what you can
36
+ ask for.
28
37
 
29
38
  To launch runs declaratively, `gauge apply -f <spec>.json`. Discover the spec
30
39
  format without leaving the terminal: `gauge apply --example` prints a starter