Installation

Reelcraft Documentation

Reelcraft is both a Universal AI Agent Skill (for Antigravity, Claude Code, Cursor, Codex) and a Standalone Node CLI that can be run in any shell.

1. Install as Universal AI Agent Skill

Install globally across all supported AI coding assistants with the official skills CLI:

$ npx skills add -g https://github.com/dusmamud/reelcraft --skill reelcraft

2. Claude Code Plugin Marketplace

If you use Claude Code, install directly through the plugin marketplace:

$ /plugin marketplace add dusmamud/reelcraft

$ /plugin install reelcraft@reelcraft

3. Standalone CLI

No AI agent required. Run directly with npx or install globally:

$ npm install -g reelcraft

Command Reference

Core CLI Commands

reelcraft init [name]Scaffold

Scaffolds a new 1080×1920 60fps reel project with editable HTML/CSS/JS and bundled music.

$ npx reelcraft init my-reel

reelcraft preview [path]Realtime

Launches an instant live browser preview with zero render lag.

$ npx reelcraft preview my-reel

reelcraft render [options] [path]Export

Renders finished 1080×1920 MP4, Frame-1 poster thumbnail, and captions.txt.

$ npx reelcraft render my-reel

reelcraft doctorHealth

Audits system dependencies: Node, Hyperframes, Python, Kokoro, and Edge-TTS.

$ npx reelcraft doctor

Options

Supported Flags

Flag	Values	Default	Description
--tone	luminous, cyberpunk, paper-and-ink, terminal-hacker, apple-minimal	Auto	Visual aesthetic and rhythm.
--format	vertical (1080×1920), landscape (1920×1080)	vertical	Target aspect ratio.
--duration	15, 20, 30	20s	Total duration in seconds.
--voice	flag	off	Enables AI studio narration.
--lang	en, hi	en	Selects Kokoro (en) or Edge-TTS (hi).

Quality & Safety

3-Tier Pre-Flight Linting

Tier 1: StaticGuard (<50ms)

AST & Markup Audit

Checks for unquoted CSS variables, missing audio files, broken media IDs, and negative duration timers.

Tier 2: Chromium Runtime

Headless Visual Check

Spins up headless Chromium, checks 46/46 WCAG AA contrast rules, and detects frame drops before rendering.

Support

Troubleshooting FAQ

Q: Why is audio muted in browser preview?

Browsers require user interaction before autoplaying audio. Click anywhere on the preview canvas to unmute.

Q: Where can I submit bug reports?

Open an issue at github.com/dusmamud/reelcraft/issues or email dusmamud0@gmail.com.