A command-line client for your Preview production data: projects, stories, scenes, shots, takes, media, and library items. It’s JSON-first and built for scripting and for agentic tooling like Claude Code and Codex, not as a replacement for the app.
Install
Log in
Run preview auth login. It opens a browser to confirm a device code, then stores your credentials locally; every other command works once you’re signed in.
What it’s useful for
- Scripting your production data: list, create, and update projects, stories, scenes, shots, and takes from the command line or a script, without opening the app.
- Uploading and managing media: attach files to shots, manage library items (Characters, Locations, Props), and organize project assets.
- Connecting coding agents: give Claude Code, Codex, or similar tools direct, structured access to a project so they can help plan and build it out.
- Batch operations: run a list of operations from a single file instead of one command at a time.
Every command supports --json for scripting; destructive commands require an extra --yes confirmation flag.
