kinocut

# Kinocut Use Kinocut when an agent needs a structured video-editing surface instead of hand-writing FFmpeg commands. It exposes MCP tools, a Python client, and a CLI for editing, analysis, subtitles, audio, Hyperframes, layered compositing, and local repurposing workflows. ## Start Here - Read `../../README.md` for installation, agent workflows, and the safety contract. - Read `../../docs/CLI_REFERENCE.md` for command names and flags. - Read `../../docs/TOOLS.md` for MCP tool coverage. - Read `../../docs/PYTHON_CLIENT.md` when scripting multi-step workflows. - Read `../../docs/WORKFLOWS.md` for the agent workflow engine (job-spec, `@refs`, variants, resume, receipts). - Read `../../docs/STREAM_SHORTS.md` for saved-plan stream-to-shorts review → render → package (no posting). - Read `../../docs/RESCUE.md` for local diagnosis and content-preserving "fix this clip" work. - Read `../../docs/POST_RESCUE_FEATURES.md` for semantic, visual, restorative, composition, autopilot, and egress planning. - Read `../../docs/AI_VIDEO_INSPECTION.md` for content-addressed ingest and deterministic temporal evidence. - Run `kino doctor` before media work that depends on FFmpeg, Hyperframes, image tools, or AI dependencies. ## Choose A Surface - MCP: best for Claude Code, Cursor, Codex-style clients, and other agent hosts. Configure `uvx --from kinocut kino`. - CLI: best for direct local edits, quick diagnostics, `composite-layers --dry-run`, batch jobs, and CI-friendly JSON output. - Python...