@imgly/codesign-mcp 0.3.1 → 0.3.2-canary.20260907135136.gb5be8d7

package/README.md

@@ -66,9 +66,9 @@ top-level key differ. Cursor (`.cursor/mcp.json`) and Windsurf
   sessions.
 - **An embedded handbook.** A single `skill` tool reads and searches a bundled
   catalog — handbook, API reference, guides, plus task skills for brand,
-  localization, resizing, format conversion and design review. Each is also
-  surfaced as an MCP prompt, so hosts expose them as slash commands (`/create`
-  and friends).
+  localization, resizing, format conversion and design review. One MCP
+  prompt, `/codesign`, loads the whole design context in a single message
+  (optionally with a brief) so a session needs no reference reads.
 - **Import and export.** `import` opens Photoshop (`.psd`/`.psb`), InDesign
   (`.idml`), PowerPoint (`.pptx`), PDF, plain images and SVG as a new design;
   `export` writes PDF, print-ready PDF/X, PNG, JPEG, WebP, SVG, HTML and the
@@ -118,6 +118,55 @@ codesign-mcp --help
 
 Questions, bug reports and licensing: [img.ly/support](https://img.ly/support).
 
+## Release channels
+
+Three npm dist-tags, from the same source:
+
+| Channel  | Install                          | Engine                | Video  |
+| -------- | -------------------------------- | --------------------- | ------ |
+| `latest` | `npx @imgly/codesign-mcp`        | WASM                  | off    |
+| `next`   | `npx @imgly/codesign-mcp@next`   | WASM                  | off    |
+| `canary` | `npx @imgly/codesign-mcp@canary` | **native (required)** | **on** |
+
+`next` is the tip of `main`, published on every push. `canary` is the **same
+commit** built with the native engine and the video surface on — it exists so the
+native engine gets real usage before it becomes everyone's default.
+
+Two things to know before installing `canary`:
+
+- It **requires** `@cesdk/node-native` and refuses to start without it, rather than
+  quietly falling back to WASM. A canary that silently ran WASM would tell you
+  nothing about the thing it exists to test.
+- There is no native binary for **linux-arm64**, so `canary` cannot run there —
+  including Docker on Apple Silicon. Use `next` or `latest` on those hosts.
+
+## Environment knobs
+
+<!-- flags:start -->
+
+| Variable                        | Meaning                                                                    |
+| ------------------------------- | -------------------------------------------------------------------------- |
+| `IMGLY_CESDK_ENGINE`            | engine flavor: wasm \| native (default: wasm, or native when video is on). |
+| `IMGLY_FEATURE_VIDEO`           | on \| off — video export and video/audio import (default: off).            |
+| `IMGLY_TELEMETRY`               | on \| off — usage telemetry (default: on).                                 |
+| `IMGLY_DIAGNOSTICS_FILE`        | false stops local diagnostics logging (default: true).                     |
+| `IMGLY_DIAGNOSTICS_TOOL`        | false hides the diagnostics tool (default: true).                          |
+| `IMGLY_DIAGNOSTICS_DIR`         | where diagnostics logs are written (default: the platform state dir).      |
+| `IMGLY_GATEWAY_API_KEY`         | AI gateway key; an alternative to signing in with the login tool.          |
+| `IMGLY_GATEWAY_BASE_URL`        | AI gateway endpoint (default: IMG.LY hosted).                              |
+| `IMGLY_AUTH_ISSUER`             | override the built-in sign-in endpoints — set both together, or neither.   |
+| `IMGLY_AUTH_CLIENT_ID`          | see IMGLY_AUTH_ISSUER.                                                     |
+| `IMGLY_DEFAULT_ASSETS_BASE_URL` | manifest root for the default asset sources (default: IMG.LY CDN).         |
+| `IMGLY_DEMO_ASSETS_BASE_URL`    | manifest root for the demo asset sources (default: IMG.LY CDN).            |
+| `IMGLY_GFONTS_CONTENT_URL`      | Google Fonts content root (default: IMG.LY CDN).                           |
+
+These are a development surface: a published build **deletes** every `IMGLY_*` /
+`CESDK_*` / `CODESIGN_*` variable at startup except the licence, workspace,
+engine-sizing and gateway-credential ones — see `src/cli/frozen-env.ts`. Setting
+one on a released build has no effect and reports no error.
+
+<!-- flags:end -->
+
 ## License and terms
 
 Use of CoDesign is governed by the