@osmo.inc/cli 0.1.17 → 0.1.18-preview.1

package/DEPLOY.md

@@ -6,13 +6,13 @@ Share a rendered video from any tool, including drafts and work in progress. Req
 
 ```sh
 osmo login
-osmo share --video ./film.mp4 --name "Launch film"
-osmo share --video ./film-v2.mp4 --project PROJECT_ID
+osmo share ./film.mp4 --name "Launch film"
+osmo share ./film-v2.mp4 --to SHARE
 ```
 
-Without `--project`, each upload creates a new review. With `--project`, the upload adds a version to that review. The command does not initialize or write anything in the working folder.
+Without `--to`, each upload creates a new share. With `--to`, the upload adds a version to that share. SHARE accepts a review link, a version link, or a share ID. `osmo shares` lists yours. The command does not initialize or write anything in the working folder.
 
-Add `--json` for machine-readable output containing `project`, `render`, `link`, and `versionLink`. A failed upload reports the project ID for retrying; only completed uploads appear in review history.
+Add `--json` for machine-readable output containing `share`, `version`, `link`, and `versionLink`. A failed upload reports the new share's ID for retrying; only completed uploads appear in review history.
 
 ## Supported videos
 
@@ -27,24 +27,25 @@ Fractional frame rates are preserved. Variable-frame-rate videos retain playback
 `versionLink` points to one specific video version. Comments stay attached to that version, and existing version links continue to work while sharing is enabled. Anyone with a review link can access the review.
 
 ```sh
-osmo comments list --project PROJECT_ID --open --json
-osmo comments reply COMMENT_ID "Updated in the latest version." --project PROJECT_ID
-osmo comments resolve COMMENT_ID --project PROJECT_ID
-osmo comments reopen COMMENT_ID --project PROJECT_ID
+osmo comments list SHARE --open --json
+osmo comments add SHARE "The logo lands late." --at 3.5
+osmo comments reply COMMENT_ID "Updated in the latest version."
+osmo comments resolve COMMENT_ID
+osmo comments reopen COMMENT_ID
 ```
 
-Reviews support time ranges, canvas annotations, replies, and resolving comments.
+Reviews support time ranges, canvas annotations, replies, and resolving comments. Local review comments are not automatically uploaded by `osmo share`; the command uploads the video only.
 
 ## Disable review links
 
 ```sh
-osmo unshare --project PROJECT_ID
+osmo unshare SHARE
 ```
 
-Requires login and owner or editor access to the project. Works from any folder without local project files, Git, or FFmpeg. Add `--json` for `{ "status": "undeployed", "project": "PROJECT_ID" }`. Repeating the command is safe.
+Requires login and owner or editor access. Works from any folder without local project files, Git, or FFmpeg. Add `--json` for `{ "status": "unshared", "share": "SHARE_ID", "next": "..." }`. Repeating the command is safe.
 
-Videos, comments, and history remain stored. The main review link, all version links, public comment reads/writes, and new public download links stop working. Authenticated project access is retained.
+Videos, comments, and history remain stored. The main review link, all version links, public comment reads/writes, and new public download links stop working. Authorized members retain access to read and answer comments through the CLI.
 
 Previously obtained direct media URLs and downloaded copies are not revoked; already issued signed downloads can remain valid until expiry.
 
-A successful new `osmo share --video FILE.mp4 --project PROJECT_ID` restores the review links for the project and its existing versions. Uploads begun before links were disabled, failed uploads, and retries of old completion requests do not restore them. Start a new upload to restore sharing.
+A successful new `osmo share FILE.mp4 --to SHARE` restores the review links for the share and its existing versions. Uploads begun before links were disabled, failed uploads, and retries of old completion requests do not restore them. Start a new upload to restore sharing.

package/README.md

@@ -2,22 +2,34 @@
 
 Share videos. Collect feedback.
 
+This preview build requires the matching cloud API update for the new share and comment commands. It does not replace the stable npm release.
+
 Upload a video from any tool and get a review link with timestamped comments and version history.
 
 ```sh
-npm install -g @osmo.inc/cli
+npm install -g @osmo.inc/cli@preview
 osmo login
-osmo share --video ./video.mp4
+osmo share ./video.mp4
 ```
 
 Add a version, read feedback, or disable the link:
 
 ```sh
-osmo share --video ./video-v2.mp4 --project PROJECT_ID
-osmo comments list --project PROJECT_ID --open --json
-osmo unshare --project PROJECT_ID
+osmo shares
+osmo share ./video-v2.mp4 --to SHARE
+osmo comments list SHARE --open --json
+osmo comments add SHARE "The logo lands late." --at 3.5
+osmo comments reply COMMENT_ID "Updated in the latest version."
+osmo comments resolve COMMENT_ID
+osmo unshare SHARE
 ```
 
+SHARE accepts a review link, version link, or share ID. Comments are addressed by their ID. Videos, comments, and history are retained when links are disabled; authorized members can still read and answer feedback. Sharing a new version restores the review links.
+
 Requires **Apple Silicon macOS, Node 22, and ffprobe**. Accepts H.264 MP4 with optional AAC audio, up to 2 GiB. No project setup or Git required.
 
-[Sharing guide](DEPLOY.md) · [AI agent setup](SETUP.md)
+Discover resources and AI models with `osmo resources list --json`; inspect inputs with `osmo resources show ID --json`. `osmo run --help` explains model execution. Model runs use your account's energy allowance; `osmo login --no-spend` requests project access without model spending permission.
+
+The default service is https://studio.osmo.inc. For preview testing, set `OSMO_BASE_URL=https://preview.osmo.inc`; each service has a separate login.
+
+See the [setup guide](SETUP.md) and [sharing guide](DEPLOY.md). Run `osmo --help` for all commands.

package/SETUP.md

@@ -1,30 +1,28 @@
 # Osmo CLI setup
 
-Requires an Apple Silicon Mac, arm64 Node 22, and ffprobe (included with FFmpeg). The default service is **https://studio.osmo.inc**.
-
-## Install
+Requires an Apple Silicon Mac, arm64 Node 22, and ffprobe (included with FFmpeg). The default service is https://studio.osmo.inc.
 
 ```sh
-npm install -g @osmo.inc/cli
+npm install -g @osmo.inc/cli@preview
 osmo login
-osmo share --video ./video.mp4
+osmo share ./video.mp4
 ```
 
 ## Setup prompt for an AI agent
 
 ```text
-Install @osmo.inc/cli from npm. Check for arm64 Node 22 and ffprobe.
+Install @osmo.inc/cli@preview from npm. Check for arm64 Node 22 and ffprobe.
 Run osmo login --json and show me the approval link and code. After I approve,
 poll login status with the returned sessionId, respecting retryAfter.
-Run osmo whoami --json, then osmo share --video /path/to/video.mp4 --json.
-No project setup or Git repository is needed. Return the review link and project ID.
+Run osmo whoami --json, then osmo share /path/to/video.mp4 --json.
+No project setup or Git repository is needed. Return the review link and share ID.
 Never read or print stored credentials.
 ```
 
 Use H.264 MP4, 8-bit 4:2:0 video, optionally with AAC audio, up to 2 GiB. Files are uploaded as supplied.
 
-For later versions, use `osmo share --video FILE.mp4 --project PROJECT_ID`.
-Read feedback with `osmo comments list --project PROJECT_ID --open --json`.
-Disable review links with `osmo unshare --project PROJECT_ID`, preserving the data.
+For later versions, use `osmo share FILE.mp4 --to SHARE`, where SHARE is a link or ID. `osmo shares` lists your shares. Read feedback with `osmo comments list SHARE --open --json`, and answer it with `osmo comments reply COMMENT_ID "message"`. Disable review links with `osmo unshare SHARE`, preserving the data.
+
+For project access without model spending permission, use `osmo login --no-spend`. A `scope_required` response names the login command needed to grant missing permissions.
 
 See the [sharing guide](DEPLOY.md) for version history, comments, and link access.