# Osmo CLI

Share videos, collect feedback, and run AI models on Osmo.

```sh
npm install -g @osmo.inc/cli
osmo login                # prints a link: open it and approve
osmo login                # again, to finish signing in
osmo share ./video.mp4
```

Runs on any OS with Node 22 or later. Sharing a video also needs ffprobe, which
comes with FFmpeg: `brew install ffmpeg` on macOS, `sudo apt install ffmpeg` on
Debian or Ubuntu, `winget install ffmpeg` on Windows.

## Share a video and collect feedback

Upload a video from any tool and get a review link with timestamped comments and
version history. No project setup or Git repository is needed.

```sh
osmo share ./video-v2.mp4 --to SHARE
osmo shares
osmo comments list SHARE --open --json
osmo comments reply COMMENT "Fixed in the latest version."
osmo unshare SHARE
```

SHARE is a share's link or its ID; `osmo shares` lists yours. A comment is
addressed by its ID alone. `osmo unshare` turns a share's links off and keeps
everything; `osmo shares delete SHARE --yes` removes it for good. Accepts H.264 MP4 with optional AAC audio, up to 2 GiB.

## Resources and AI models

```sh
osmo resources list
osmo resources show osmo/z-image-turbo
osmo run osmo/z-image-turbo --input prompt="a red bicycle on a quiet street" --out bike.jpg
osmo jobs
```

`osmo resources` lists the AI models that run on Osmo, charged to your plan.
`osmo resources show ID` lists a model's inputs. The catalog also holds packages
for Osmo scenes, such as shaders and 3D models, which `osmo resources get`
downloads.

Every command takes `--json` and `--help`.

[Sharing guide](https://unpkg.com/@osmo.inc/cli/DEPLOY.md) · [AI agent setup](https://unpkg.com/@osmo.inc/cli/SETUP.md)