@eosa/cli

The command-line interface for the Eosa Video-as-Code ecosystem.

🖥️ What is Eosa CLI?

The Eosa CLI is the primary interface for generating, validating, previewing, and rendering your videos. It is designed to work seamlessly in local development and within CI/CD pipelines for automated video production.

🚀 Commands

1. Initialize a Project

npx @eosa/cli init my-video

2. Live Preview

Start a local server with hot-reload for your video.ts.

reactcut preview video.ts --watch

3. Validate

Ensure your timeline schema and local assets are correct.

reactcut validate video.ts

4. Quality Analysis (AI-Friendly)

Get a quality score and suggestions for improvement.

reactcut analyze video.ts --json

5. Render to MP4

Export your code-defined video to a high-quality MP4 file.

reactcut render video.ts --out result.mp4

📜 Features

• Intelligent Linting: Checks for safe areas, audio presence, and best practices.
• Multi-format Support: Direct loading of .ts, .tsx, .js, and .json project files.
• Headless Snapshots: Generate PNG thumbnails for specific frames via thumbnails.

🔗 Links

• Main Repository
• Agent Contract (AGENTS.md)