@clickraft/cli 0.3.0 → 0.5.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.
package/CHANGELOG.md CHANGED
@@ -1,8 +1,8 @@
1
- ## [0.3.0](https://github.com/clickraft/cli/compare/v0.2.0...v0.3.0) (2026-05-24)
1
+ ## [0.5.0](https://github.com/clickraft/cli/compare/v0.4.0...v0.5.0) (2026-05-24)
2
2
 
3
3
  ### Features
4
4
 
5
- * **commands:** add template list, get, and find commands ([b2f5c5c](https://github.com/clickraft/cli/commit/b2f5c5c2e501f8ea5c6586476d121b97ce97f4ba))
5
+ * **models:** add models list command consuming agents/v1/models ([83761d1](https://github.com/clickraft/cli/commit/83761d11d136758e23c40cf80cd87c8f08dbaad6))
6
6
 
7
7
  # Changelog
8
8
 
package/README.md CHANGED
@@ -19,11 +19,32 @@ clickraft login
19
19
  clickraft generate create --prompt "a serene mountain landscape at dawn"
20
20
  clickraft balance
21
21
  clickraft brand-model list
22
+ clickraft models list
23
+ clickraft models list --category image --tier pro
22
24
  clickraft template list
23
25
  clickraft template get <template-id>
24
26
  clickraft template find "coffee brand"
25
27
  ```
26
28
 
29
+ ### Brand Model references
30
+
31
+ Use `--brand-model` to attach trained brand models to a generation. The flag is repeatable (max 3) and accepts an optional pose:
32
+
33
+ ```bash
34
+ # Single brand model, primary image
35
+ clickraft generate create --model-slug nano-banana-2 \
36
+ --prompt "product on marble" \
37
+ --brand-model a2438521-abcd-4000-8000-000000000001
38
+
39
+ # Two brand models with pose selection
40
+ clickraft generate create --model-slug nano-banana-2 \
41
+ --prompt "lifestyle shot" \
42
+ --brand-model a2438521-abcd-4000-8000-000000000001:front \
43
+ --brand-model b3549632-bcde-4000-8000-000000000002:3/4-right
44
+ ```
45
+
46
+ > **Note:** `--brand-model` only works with reference-supporting models (nano-banana-2 recommended).
47
+
27
48
  Full documentation: [docs.clickraft.ai/cli](https://docs.clickraft.ai/cli) _(coming soon)_
28
49
 
29
50
  ## Connecting to staging
@@ -37,6 +58,7 @@ export CLOUDFLARE_ACCESS_CLIENT_SECRET="<client-secret>"
37
58
  clickraft tokens list --profile staging
38
59
  clickraft balance --profile staging
39
60
  clickraft brand-model list --profile staging
61
+ clickraft models list --profile staging
40
62
  ```
41
63
 
42
64
  Both env vars must be set together — if only one is set the CLI exits with a configuration error. Production usage (the default) does not require these env vars.