@clickraft/cli 0.12.0 → 0.14.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 +4 -9
- package/README.md +63 -0
- package/dist/cli.js +459 -61
- package/dist/cli.js.map +1 -1
- package/dist/index.js +459 -61
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,15 +1,10 @@
|
|
|
1
|
-
## [0.
|
|
2
|
-
|
|
3
|
-
### ⚠ BREAKING CHANGES
|
|
4
|
-
|
|
5
|
-
* **generate:** a lone --reference-image no longer sets the
|
|
6
|
-
image-to-video start frame. To set the start frame, use the new
|
|
7
|
-
--start-frame flag. --reference-image remains for reference images
|
|
8
|
-
(repeatable, max 8).
|
|
1
|
+
## [0.14.0](https://github.com/clickraft/cli/compare/v0.13.0...v0.14.0) (2026-09-25)
|
|
9
2
|
|
|
10
3
|
### Features
|
|
11
4
|
|
|
12
|
-
* **
|
|
5
|
+
* **cli:** add --quality to generate create ([1497837](https://github.com/clickraft/cli/commit/149783789b272eeeb879a0b83e18522c6d7ced37))
|
|
6
|
+
* **mcp:** add quality to generate_create ([72e8232](https://github.com/clickraft/cli/commit/72e82323005efc7f535d6c7708d43c107e721229))
|
|
7
|
+
* **sdk:** accept a quality tier in the generate create contract ([3ef37ec](https://github.com/clickraft/cli/commit/3ef37ec4bfba289ee46d08cdac88beeff769798d))
|
|
13
8
|
|
|
14
9
|
# Changelog
|
|
15
10
|
|
package/README.md
CHANGED
|
@@ -45,6 +45,60 @@ clickraft generate create --model-slug nano-banana-2 \
|
|
|
45
45
|
|
|
46
46
|
> **Note:** `--brand-model` only works with reference-supporting models (nano-banana-2 recommended).
|
|
47
47
|
|
|
48
|
+
### Quality
|
|
49
|
+
|
|
50
|
+
Use `--quality` to pick a model's quality tier. Lower tiers cost fewer credits. Valid values depend on the model (GPT Image 2.5 offers `low`, `medium`, `high`, `xhigh` and `max`). Omit it to use the model default. An unsupported value is rejected before any charge, and the error lists the values the model accepts:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
clickraft generate create --model-slug gpt-image-2.5-flare \
|
|
54
|
+
--prompt "product on marble" \
|
|
55
|
+
--quality low
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Products
|
|
59
|
+
|
|
60
|
+
Create a product from images you have already uploaded, then generate against it:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
# 1. Upload each image. Note the assetId that comes back.
|
|
64
|
+
clickraft upload ./mug-front.png
|
|
65
|
+
clickraft upload ./mug-side.png
|
|
66
|
+
|
|
67
|
+
# 2. Create the product. --image is repeatable (1-10) and takes
|
|
68
|
+
# <assetId>[:<altText>]; alt text may contain colons.
|
|
69
|
+
clickraft product create --name "Ceramic Mug" \
|
|
70
|
+
--description "Hand-glazed stoneware" \
|
|
71
|
+
--image "1f7c1e8e-2a4b-4c9d-8e5f-3b2a1c0d9e8f:Front view" \
|
|
72
|
+
--image "2a8d2f9f-3b5c-4d0e-9f6a-4c3b2d1e0f9a:Side view" \
|
|
73
|
+
--primary 1f7c1e8e-2a4b-4c9d-8e5f-3b2a1c0d9e8f
|
|
74
|
+
|
|
75
|
+
# 3. Use the returned product id in a generation.
|
|
76
|
+
clickraft generate create --model-slug nano-banana-2 \
|
|
77
|
+
--prompt "the mug on a marble worktop, morning light" \
|
|
78
|
+
--product <product-id>
|
|
79
|
+
|
|
80
|
+
clickraft product list
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Without `--primary`, the first `--image` becomes the primary image. That matters
|
|
84
|
+
downstream: `generate create --product <id>` resolves the primary image when no
|
|
85
|
+
image id is given.
|
|
86
|
+
|
|
87
|
+
Retries are safe. Each invocation sends an idempotency key, and it is reused
|
|
88
|
+
across the automatic retries within that invocation, so a transient storage
|
|
89
|
+
error cannot create the product twice. To make a retry safe **across**
|
|
90
|
+
invocations, for example in a shell loop of your own, pass the same
|
|
91
|
+
`--idempotency-key` each time. Reusing a key with a changed body is rejected
|
|
92
|
+
rather than silently creating a second product.
|
|
93
|
+
|
|
94
|
+
`product create` needs the `products:write` scope. Tokens minted before this
|
|
95
|
+
command shipped do not carry it, and the CLI will say so before making any
|
|
96
|
+
request:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
clickraft login --force-reauth
|
|
100
|
+
```
|
|
101
|
+
|
|
48
102
|
### Workflows
|
|
49
103
|
|
|
50
104
|
Create, inspect, and mutate visual workflows from your terminal:
|
|
@@ -93,6 +147,15 @@ The Clickraft CLI is designed to work with Claude Code, Cursor, Codex, and other
|
|
|
93
147
|
npx skills add clickraft/skills
|
|
94
148
|
```
|
|
95
149
|
|
|
150
|
+
### After upgrading: re-authorize for product creation
|
|
151
|
+
|
|
152
|
+
`product create` and the `product_create` MCP tool both require the
|
|
153
|
+
`products:write` scope, which is new. Existing credentials do not carry it.
|
|
154
|
+
|
|
155
|
+
- **CLI:** run `clickraft login --force-reauth`.
|
|
156
|
+
- **Clickraft MCP connector:** reconnect it, then confirm the tool works. If it
|
|
157
|
+
still reports a missing scope, remove the connector and add it again.
|
|
158
|
+
|
|
96
159
|
## Development
|
|
97
160
|
|
|
98
161
|
```bash
|