cli-cinema

Cinematic terminal demo builder for product showcases.

cli-cinema gives you:

• A local glassy terminal UI to design demos
• A timeline DSL for deterministic command/output playback
• Headless rendering via Playwright to .webm or .mp4

Install

npm i -g cli-cinema

Or use locally in a repo:

npm i -D cli-cinema

Quickstart (local project clone)

git clone https://github.com/nativ3ai/cli-cinema.git
cd cli-cinema
npm install
npm run dev

Open http://127.0.0.1:4311/.

CLI

Preview static UI

cli-cinema preview --port 4311

Render headless video

cli-cinema render \
  --config examples/default.config.json \
  --out dist/demo.mp4 \
  --width 1366 \
  --height 768 \
  --fps 30 \
  --timeout 120000 \
  --port 4312 \
  --record-padding 48 \
  --strict-size false

If ffmpeg is unavailable and output is .mp4, cli-cinema writes a .webm fallback.

Timeline DSL

Supported commands:

• [pause:MS]
• [type:COMMAND]
• [spinner:PRESET:MS:TEXT]
• [spinner:MS]
• [output:ok|info|warn|error|success:TEXT]
• Legacy: [ok] text

License

MIT