roxy

Infrastructure for agents that edit video

A machine your agent edits video on.

Claude Code and Codex already know how to edit. They write the cut as commands. roxy is where those commands run: a box with every video tool installed, your footage a command away, and a link for whatever comes out. We do not edit. We are the room.

curl -fsSL /install | sh Open the Dashboard
launch-cut
roxy new launch-cutlaunch-cut ready
roxy put ~/Desktop/take3.mp4footage/take3.mp4 video 3840x2160 60 fps 60.0 s +audio, 380 MB
roxy look footage/take3.mp4 --at 4,19,41look.jpg 3 frames
roxy exec 'ffmpeg -y -ss 4 -t 12 -i footage/take3.mp4 -vf crop=1215:2160,scale=1080:1920 out/cut.mp4'exit 0
roxy export out/cut.mp4 --for instagram/l/0582d413561348698615/cut-instagram.mp4 exports/cut-instagram.mp4 10-bit colour to 8-bit 4:2:0

A real session on one shared 6-core machine with the server on the same network. Your uplink sets the upload; the machine sets the encode. The export caught that the cut was 10-bit, which phones will not play.

What a box gives your agent

Eleven verbs. Each prints a line or two, because every word an agent reads costs it tokens.

roxy new
A machine with a work folder, ready in milliseconds. FFmpeg, Node, Bun, Python and headless Chrome are on it, so Remotion and browser renders run as they are.
roxy put
Upload footage, files or whole folders, or hand it a link and the server fetches the footage itself. Stored by content, so nothing goes up twice. Big files travel in parts, resume after a break, and are usable about a second in, while the rest uploads. Originals are read-only.
roxy exec
Run any command. Back comes the exit code and the last lines, not ten thousand lines of encoder log. The full log stays in the box.
roxy ssh
A real terminal inside the box, from your shell or from the dashboard, for when a person wants to look around.
roxy look
Frames from any clip or finished video as one small image. How an agent picks a crop and checks its own cut without downloading anything.
roxy hear
What is said in a clip and when, a line per phrase, with every word's timing saved in the box. It also measures how loud the sound is around any moment, so an agent that cannot listen can still cut in the quiet between two words.
roxy push
Send a project folder: scripts, a Remotion project, fonts. In a git repository only what git does not ignore.
roxy fork
A copy of the box to try another cut on. Footage is shared, not copied, so forking an hour of 4K takes no time.
roxy review
A page for the cut instead of a file. Whoever has the address watches it, pins notes to exact frames and marks the picture. The next cut appears at the same address.
roxy notes
Those notes, for the agent: the second, the words, where on the picture, and the marked frames as one image. It can wait until the reviewer presses Send.
roxy get, link
Bring a file or a folder home, or hand someone an address for it.

Short form to 4K, delivered right

roxy export cut.mp4 --for instagram checks a finished file against where it is going and re-encodes only what is technically off. It never crops or pads: the shape of the picture is your agent's call.

instagramReels and Stories: 9:16, up to 1080x1920, H.264 up to 12 Mb/s, AAC
tiktok9:16, up to 1080x1920, H.264 up to 12 Mb/s, AAC
shortsYouTube Shorts: 9:16, up to 1080x1920, H.264 up to 12 Mb/s, AAC
youtubeAny shape up to 4K, H.264 up to 68 Mb/s, AAC
4kUp to 3840x2160, H.264 up to 120 Mb/s, AAC
webA small file for sharing: up to 1080p, up to 6 Mb/s
masterProRes 422 HQ with uncompressed sound, for an editor

Three ways in

The same verbs everywhere, so what your agent learns in one place holds in the others.

Command Line

For an agent with a shell, and for you.

roxy new
roxy put clip.mp4
roxy exec 'ffmpeg …'

Agent Tools

Twelve MCP tools, about 5 KB of definitions in all.

claude mcp add roxy -- roxy mcp
codex mcp add roxy -- roxy mcp

Dashboard

Every box in one table, each with a live page and a terminal.

roxy open

Watch it work

Every box has a page. Footage appears as it uploads, commands scroll as your agent runs them, and each new cut plays the moment it exists.

A box's page: the latest cut playing, files with thumbnails, and the commands an agent ran

Hand your agent one file

Everything an agent needs to work in a box fits on a page. Drop it into your project, or point the agent at the address, and say what you want made.

Loading the agent file…

roxy does not edit for you. It is the room, the machine and the tools.Agent FileDashboard