Skip to content

Releases: Young-1231/cutroom

cutroom v0.1.0

12 Jun 08:33
@Young-1231 Young-1231
v0.1.0
cd97365

Choose a tag to compare

View all tags
cutroom v0.1.0 Latest
Latest

First public release.

cutroom is a film-editor agent that logs your footage before it cuts: local-first, GPU-free, and every cut ships with receipts — the transcript segments it cites and the frames it actually viewed.

Highlights

  • Index-first architecture: the agent never sees the full transcript — it works from a hierarchical video map plus budgeted, paged search tools. On a 92-minute film this is a 4.8–8.5× budget saving over pasting the transcript (ablation in the README).
  • Every cut has receipts: a cut is only accepted if it cites transcript segments and frames the agent rendered to pixels; renders include a human-auditable receipts.md.
  • A real agent harness: plan mode, recipes as markdown skill files with progressive disclosure, parallel scout fan-out, lifecycle gates + audit trail (cutroom trail), a file sandbox on the editor's only fs tool, EDL checkpoints with 3-scope restore, session resume/fork, mid-run steering (--steer), and a fresh-eyes verification round (--verify).
  • Honest benchmarks: a mechanical repurpose scorecard (duration, receipts, boundary cleanliness) — 3/3 tasks pass on the demo film; reproduce with scripts/bench_repurpose.py.

Install

brew install ffmpeg yt-dlp        # macOS; Linux: apt install ffmpeg && pipx install yt-dlp
git clone https://github.com/Young-1231/cutroom && cd cutroom
uv sync && uv run cutroom --help

Requires Python 3.12+, uv, and a logged-in Claude Code (or ANTHROPIC_API_KEY).

187 offline tests, CI green on ubuntu + macOS.

Assets 4
Loading