@mevdragon/vidfarm-devcli 0.3.0 → 0.3.1

package/SKILL.director.md

@@ -254,17 +254,20 @@ For agents that operate Vidfarm headlessly, the typical loop is:
 
 Always send a stable `tracer` on publish to make retries idempotent.
 
-## Local dev loop with `vidfarm dev-serve`
+## Local dev loop with `vidfarm-devcli`
 
-For iterating on a composition on disk (e.g. Claude Code editing HTML directly), skip the cloud entirely:
+For iterating on a composition on disk (e.g. Claude Code editing HTML directly), pair the hosted editor with a local composition directory:
 
 ```bash
-npm install -g @mevdragon/vidfarm-devcli
-vidfarm dev-serve --dir ./my-fork --port 4321
-# ./my-fork must contain composition.html; composition.json + manifest.json optional
+npx -y @mevdragon/vidfarm-devcli <template_id>
+# → downloads composition.html/json + manifest.json into .vidfarm/<template_id>/
+# → starts dev-serve on http://localhost:4321
+# → prints https://vidfarm.cc/editor/<template_id>?fork=<forkId>&dev=http%3A%2F%2Flocalhost%3A4321
 ```
 
-Then open the Trackpad Editor with `?dev=1` appended to the URL (or `?dev=host:port` / `?dev=<full-url>`). An orange **LOCAL DEV MODE** banner pins to the top with an Exit button. All fork API fetches route to the devcli instead of the deployed API; file saves on disk push an SSE reload event and the iframe re-fetches automatically.
+Open the printed URL in your browser. An orange **LOCAL DEV MODE** banner pins to the top with an Exit button. All fork API fetches now route to your local dir instead of the deployed API; disk edits push an SSE reload event and the editor re-fetches automatically.
+
+Flags: `--port`, `--dir`, `--host`, `--fork`, `--api-key` (or set `VIDFARM_API_KEY`), `--share`, `--refetch`. For a fork that already has composition files on disk (or that you've populated manually), use `vidfarm-devcli dev-serve --dir ./my-fork --port 4321` to skip the fetch step.
 
 The dev source is persisted in `localStorage.VIDFARM_DEV_SOURCE`, so you don't need to keep the `?dev=` param in the URL after the first load.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mevdragon/vidfarm-devcli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Local bridge for the Vidfarm Trackpad Editor. Point it at a template id, edit composition.html on disk (Claude Code, Codex, etc.), preview live in the browser at https://vidfarm.cc/editor/.",
   "type": "module",
   "bin": {