import motion from "@scenerok/basic-animations"

SceneRok CLI

Create videos from your terminal and agent workflows.

Installation

npm install -g @scenerok/cli

Or use with npx:

npx @scenerok/cli auth login

Quick Start

# Authenticate
scenerok auth login

# Validate a VidScript
scenerok validate video.vidscript

# Render a video
scenerok render video.vidscript --resolution 1080x1920 --watch

# Upload a local project and assets
scenerok project upload video.vidscript --assets ./assets

# Upload, render, watch, and download
scenerok project upload video.vidscript --assets ./assets --render --watch --download ./renders

# Pull generated asset cache
scenerok cache pull

# Check render status
scenerok status 42

Commands

auth

scenerok auth login        # Log in via browser
scenerok auth status       # Check auth status
scenerok auth logout       # Remove credentials

skills

scenerok skills install <platform>   # Install skills for your agent
scenerok skills list                 # List available platforms

Supported platforms: opencode, claude, codex, cursor, aider

validate

scenerok validate <file.vidscript>

Validates VidScript syntax and returns scene count, duration, and warnings.

render

scenerok render <file.vidscript> [options]

Options:

• -r, --resolution <resolution> - Output resolution (e.g. 1080x1920)
• -p, --project-id <id> - Attach the render to an uploaded project
• -w, --watch - Watch render status until complete
• --download [dir] - Download the completed MP4

status

scenerok status <render-id>

Check the status of a render job.

Use scenerok status <render-id> --download ./renders to download a completed render.

project

scenerok project upload <file.vidscript> --assets ./assets
scenerok project upload <file.vidscript> --assets ./assets --render --watch --download ./renders
scenerok project list
scenerok project render <project-id> --watch --download ./renders

project upload creates a private SceneRok project on the main server, uploads referenced local assets, rewrites local input paths to server asset URLs, and returns a project id. Project renders are visible on the website.

cache

scenerok cache pull
scenerok cache pull --plugin @scenerok/xai --output ~/.scenerok/cache/assets

Downloads cached generated assets and writes a manifest.json to the output folder.

Configuration

Config is stored in ~/.scenerok/config.json:

{
  "apiToken": "rf_...",
  "baseUrl": "https://scenerok.com"
}

VidScript

VidScript is a declarative language for describing video compositions.

import motion from "@scenerok/basic-animations"

input hero = "./assets/hero.mp4"

[0s .. 5s] = hero
[0.4s .. 3s] = text "Hello World", font: "Inter Bold", size: 72, x: "50%", y: "50%", align: center, animate: [motion.fadeIn(0.6s), motion.slideY(40, 0, 0.8s)]

output to "video.mp4", resolution: "1080x1920", fps: 30

Animation helpers are package functions: motion.fadeIn, motion.fadeOut, motion.slideX, motion.slideY, motion.popIn, motion.riseIn, motion.swingIn, motion.glitchIn, motion.float, motion.typewriter.

Links

• Website: https://scenerok.com
• Docs: https://scenerok.com/agents/get-started.md