CLI reference

Record Skills + CLI.

A command-line interface designed for agents: deterministic exit codes, structured JSON, background recording, and durable publishing.

Install

Global install

npm install --global https://recordthis.dev/downloads/record-cli.tgz

Verify

System status

record-cli doctor --json

Common workflows

# Record for ten seconds
record-cli start --duration 10 --title "Homepage scan" --agent codex --json

# Stop and publish
record-cli stop --publish --json

# Read reviewer feedback
record-cli inbox --type feedback.* --json

Automation guarantees

--json prints one machine-readable result object.
Errors include a stable code, message, and non-zero exit status.
Run tokens are least-privilege and expire when a live run closes.
Uploads stream instead of loading the entire video into memory.

For the complete command list, run record-cli --help.