@impractical-ai/motion 0.1.10 → 0.1.12

package/README.md

@@ -1,5 +1,17 @@
 # Impractical Motion CLI
 
+<!-- ARRIVAL-DRIFT-STANDARD START -->
+## Default motion: arrival and residual drift
+
+Foreground motion defaults to an energetic arrival, strong deceleration, and small continuing travel through the reading hold. Compose a deterministic residual trajectory with the native entrance; do not stop and restart with a disconnected tween. “Settled” and “hold” mean readable and visually stable, with subtle nonzero travel unless an explicit freeze, exact alignment or reduced-motion mode requires stillness.
+
+Use the Rox `ambientOffset(seconds, amount, phase)` pattern: native 960×540 product groups start around amount 3.2–4, text around 0.8–1. Keep a signed velocity floor with gentle curvature, not a pure sine bob. Move attached labels, controls, connectors and shadows together, avoid double drift, preserve 3D hierarchy, and verify reverse/retimed seeks and late-hold displacement.
+
+The host owns the background environment. Animate foreground objects only; never move or retime the background to simulate object motion. Reusable foregrounds should be transparent. Keep one primary focus and room around it; purposeful object camera moves remain welcome, and a generic card is not the default visual container.
+
+Full specification: [motion standard](../docs/motion-standard.md).
+<!-- ARRIVAL-DRIFT-STANDARD END -->
+
 Connect Claude Code, Codex, Cursor, or OpenCode to Impractical Motion through
 its MCP server.
 
@@ -34,6 +46,58 @@ Setup writes the API credential to `~/.impractical/config.json` with mode `0600`
 variables `IMPRACTICAL_API_KEY`, `IMPRACTICAL_SUPABASE_URL`, and `IMPRACTICAL_APP_URL` take
 precedence over that file.
 
+## Start from a shared video
+
+When the sender includes an editable project, the public video page has an
+**Edit this video** action. Its single command both connects your agent and
+copies the project into your workspace:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 setup --agent --from https://impractical.ai/v/SHARE_TOKEN
+```
+
+Use the real URL copied from the page. Sign in when prompted, then restart your
+coding agent. The command prints your new project URL and a prompt containing
+its project ID. Drafts stay in your Impractical workspace and are edited through
+MCP; no source is executed or written into your current directory by this command.
+
+Already connected, or retrying an interrupted import:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 clone https://impractical.ai/v/SHARE_TOKEN
+```
+
+Repeating the command returns the same copy for that share and workspace. The
+copy is independent of the sender's project. An MP4-only share cannot be cloned.
+
+## Choose who can edit a shared video
+
+Each link is **view only by default**. Upload without `--project` to share just
+the video and its public brand information; the page will hide **Edit this video**
+and the API will reject project-copy requests for that link:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 share ./video.mp4 --title "For Acme" --references ./public-brand.json
+```
+
+`--project` explicitly lets recipients copy **all editable drafts and assets**
+from that project, so use a project you intend to share:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 share ./video.mp4 --title "For Acme" --references ./public-brand.json --project PROJECT_ID
+```
+
+Enable cloning on an existing video share, or disable future clones:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 share allow-editing SHARE_ID --project PROJECT_ID
+npx --yes @impractical-ai/motion@0.1.11 share view-only SHARE_ID
+```
+
+Detaching the source or revoking the video does not remove copies already owned
+by recipients. The existing upload API accepts the same opt-in as `projectId`.
+The shorter `share attach` and `share detach` aliases also remain supported.
+
 ## MCP server
 
 The installer configures supported clients to run: