Media Tooling lets a coding agent (Claude Code, Codex, Antigravity and others) work on your video and audio
projects. It turns raw recordings into transcripts, subtitles, contact sheets, shot lists and storyboards, then
assembles, grades, checks and delivers the edit. You ask for the outcome; the agent uses the toolkit's skills
and media-* commands, and everything it makes stays in your project folder.
It fits podcasts, interviews, tutorials, courses, product videos, explainers, shorts and YouTube uploads.
brew install uv ffmpeg
uv tool install "media-tooling[elevenlabs] @ git+https://github.com/kumanday/media-tooling"
media-tooling-link-skills # lets your agents find the skills
export PROJECT_DIR="$HOME/projects/my-project-media"
media-tooling-init "$PROJECT_DIR" # project folders plus an AGENTS.md for the agent
cd "$PROJECT_DIR"
Then open your agent in $PROJECT_DIR and ask for what you want:
Create a 5-minute highlight reel with representative samples of the different speakers and the topics discussed.
Turn this session into a short recap that explains the main workflows, tools, and takeaways.
Review this processed media project and propose a first-pass rough cut with the strongest clips and any obvious weak spots.
The full install, update and troubleshooting steps are in docs/INSTALL.md. It's written so an agent can follow it: give your agent its URL. More prompts are in docs/WORKFLOWS.md.
| Stage | Command | What it does |
|---|---|---|
| Setup | media-tooling-init |
Creates a project workspace and its managed AGENTS.md block |
media-tooling-link-skills |
Links the skills where coding agents look for them | |
| Transcripts and subtitles | media-subtitle |
Transcript, .srt and JSON for one audio or video file |
media-batch-subtitle |
The same for a manifest of files | |
media-pack-transcript |
Compact phrase-level transcript for the agent to reason over | |
media-translate-subtitles |
Translates subtitles in windows, then re-times the cues | |
media-burn-subtitles |
Burns subtitles into a video | |
media-batch-burn-subtitles |
The same for a manifest of videos | |
| Visual review | media-contact-sheet |
One image of frames sampled across a video |
media-batch-contact-sheet |
The same for a manifest of videos | |
media-timeline-view |
Filmstrip and waveform image at an editing decision point | |
| Assembly and finishing | media-rough-cut |
Quick first-pass cut from cards, image holds and clips |
media-edl-render |
Edited render from an EDL: grading, fades, overlays, subtitles, loudness | |
media-grade |
Automatic or preset color grading | |
media-loudnorm |
Two-pass loudness normalization (−14 LUFS) | |
media-verify |
Self-check of a render against its EDL | |
media-fcpxml-export |
FCPXML timeline for DaVinci Resolve | |
| Narration and sound | media-tts |
Narration from a script (ElevenLabs) |
media-tts-frames |
Per-scene narration clips with word timings | |
media-teleprompter |
Teleprompter page timed to a reference take | |
media-video-music |
Optional music and sound effects mixed under the voice | |
| Motion and generated media | media-generated |
Reviewed requests, imports and take selection for generated footage |
media-cloud-render |
Renders a HyperFrames project on Google Cloud Run | |
media-raea-timing |
Narration timing for raea compositions (pilot) |
Flags, backends and behavior for each command: docs/COMMANDS.md. Optional engines installed separately: HyperFrames and raea (pilot) for motion graphics.
media-render-pipeline handles "make me a finished video" from end to end. A single job, such as transcribing a
folder or voicing a script, goes straight to the skill that covers it. What each skill does and how the routing
works: docs/SKILLS.md.
| Read | For |
|---|---|
| INSTALL.md | Installing, updating and verifying the toolkit |
| SETUP.md | Project workspaces, optional installs and shell helpers |
| WORKFLOWS.md | Prompt patterns and runnable command examples |
| COMMANDS.md | Every command in detail |
| SKILLS.md | How prompts route through the agent skills |
| hard-rules.md | The production rules the renderers enforce |
| HYPERFRAMES.md | HTML-rendered motion graphics and overlays |
| RAEA.md | Pilot: raea as a faster motion-graphics backend |
| generated-media.md | Generated footage through TTV providers |
| CLOUD-RENDER.md | HyperFrames renders on Google Cloud Run |
| LOCAL-CONFIG.md | Private rules, skills and render profiles |
| EXPORTING.md | Layered exports for DaVinci Resolve |
| DEVELOPMENT.md | Working on the toolkit itself |
Inside a project workspace, follow the project's AGENTS.md and the skills it lists. Read the docs above when a
task needs detail. COMMANDS.md has each command's behavior, SKILLS.md the
routing, and WORKFLOWS.md worked examples. To change the toolkit itself, start with the
repo-root AGENTS.md.
Keep reusable code and installs outside the project workspace, and project outputs inside it.

