cli-operations

name	cli-operations
description	Guide for running the Video Generator CLI commands.
version	5.0.0
metadata	{"requires":{"bins":["node","npm","ffmpeg","python"],"env":["PEXELS_API_KEY"]}}

Video Generator CLI Operations Skill

This skill explains the different terminal commands available to run, resume, or fix video generations.

1. Standard Generation Commands

These commands are used for a "Fresh Start." They clean up old temporary files to prevent conflicts.

npm run generate (or npm run build)

• What it does:
  1. Wipes the .video-cache.json file.
  2. Cleans the public/videos and public/audio folders.
  3. Parses your script from input/scripts/input-scripts.json.
  4. Downloads new stock footage and generates voiceovers.
  5. Renders the video scene-by-scene (Segmented Mode).
• When to use: When you have a new script or want to see fresh visuals for an existing script.

---

2. Advanced Recovery Commands

These commands save time by reusing already-completed work.

npm run resume

• What it does:
  1. Preserves everything in public/ and the .video-cache.json.
  2. Only downloads visuals/audio that are missing.
  3. Only renders segments that don't exist yet in the output folder.
  4. Automatically stitches everything together at the end.
• When to use: If your computer crashed, or you lost internet during a long generation. It will pick up exactly where it left off.

npm run segment

• What it does:
  1. Skips ALL asset fetching and generation.
  2. Jumps directly to "Phase 7: Assembly."
  3. Takes the existing .mp4 segments in your output folder and merges them.
• When to use: Use this if the video was rendered successfully but the final "stitching" failed or if you want to manually re-assemble the segments.

---

3. Developer / Debugging Tools

npm run dev

• What it does: Starts the local asset server.
• When to use: Only needed if you are manually debugging the Remotion components in the browser.

---

4. Operational Summary

Command	Action	Fresh/Resume
npm run generate	Full Process	Fresh (Wipes old data)
npm run build	Full Process	Fresh (Alias for generate)
npm run resume	Skip Existing	Resume (Saves time)
npm run segment	Assembly Only	Fix (Stitching only)

---

5. Configuration (JSON Script)

When editing input/scripts/input-scripts.json, agents can use these newer properties:

Property	Type	Description
showText	Boolean	Set to false to disable on-screen subtitles.
defaultVideo	String	Filename in input/visuals/ to use as a visual fallback.
orientation	String	portrait or landscape.
voice	String	AI voice ID (e.g., en-US-JennyNeural).