henshusha

henshusha

Create and operate a Henshusha agent-native video editing workspace.

npx henshusha my-studio
# or
bunx henshusha my-studio

The generated workspace is not a single-video project. It is a studio root that can contain many video projects:

my-studio/
  henshusha.config.json
  projects/
    sample-video/
      sources/raw/
      scripts/edit-plan.md
      transcripts/
      timelines/main.timeline.json
      renders/
      jobs/
  .claude/skills/
  .codex/skills/
  .pi/skills/

MVP commands:

npx henshusha validate projects/sample-video
npx henshusha render projects/sample-video --dry-run
npx henshusha render projects/sample-video
npx henshusha remotion-props projects/sample-video
npx henshusha new-project next-video

render --dry-run writes projects/<project>/jobs/render-plan.json with resolved paths, overlay timings, and the FFmpeg command without requiring FFmpeg to run.

Generated workspaces also include a Remotion starter under projects/sample-video/remotion/ plus these scripts:

npm run remotion:props
npm run remotion:preview
npm run remotion:render

The first renderer is a manual cut + overlay path: source video clips are concatenated, then title/caption text is overlaid with FFmpeg. The Remotion path is available for richer visual composition. Whisper/ASR and VOICEVOX/Zundamon narration are intentionally deferred.

Packaged skills include henshusha-digest-story, which guides agents through a quick digest workflow: story beats → edit plan → Timeline JSON → FFmpeg dry-run/render → Remotion props/preview.