henshusha

henshusha

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

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

Recommended for Bun users on the first run:

bunx henshusha@latest demo

If Bun still reuses an old cached package:

bun pm cache rm
bunx henshusha@latest my-studio

Repository CI keeps this starter checked in three layers: fast PR checks on Ubuntu, cross-platform CLI smoke on Ubuntu/macOS/Windows, and publish-time npx / bunx verification after npm propagation.

Scaffolding installs workspace dependencies and runs git init by default so the first Remotion preview and GitHub handoff are ready quickly. Use --no-install or --no-git to opt out.

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

my-studio/
  .git/
  .gitattributes
  .gitignore
  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/

After the workspace install finishes, the generated package already includes a local henshusha devDependency. That keeps workspace scripts off the network on later runs.

MVP commands inside the generated workspace:

npm run validate
npm run render:dry-run
npm run render
npm run remotion:props
npm run doctor:updates
npm run 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 Remotion starter includes text-templates.tsx with reusable presets for richer text overlays: headline-pop, bottom-caption, karaoke-caption, lower-third, and quote-card. Set preset, plus optional accent, label, or speaker, on title / caption timeline items to switch the look without rewriting the composition.

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.

doctor --updates checks npm for a newer henshusha package and prints the update command. A full workspace file upgrade command is planned; current generated workspaces keep user-edited files under normal Git control.