# Studio Use 🎬
**studio-use** · let your agent record and edit video with you.
Record your screen, then let Claude Code, Codex, or any agent cut the dead
air, zoom in on the click, caption what was said and export. It edits the
same timeline you are looking at, and every edit is one undoable entry with
its name on it. Built on [Remotion](https://www.remotion.dev).
```
● agent: wants to tighten the demo
│
● cuts() → 15 idle stretches, biggest at 1:16–4:50
│
● apply(remove_range 1:16–4:50) → history: [agent] cut 214s idle
│
● frame(76_000) → looks at the seam → clean
✓ done — undo it with one click if you disagree
```
## Setup
Paste into Claude Code or Codex:
```text
Set up studio-use for me. Clone https://github.com/ShawnPana/studio-use into ~/.studio-use, read `install.md` first, install it so `studio` and `studio-harness` are commands on my PATH, and register it as an agent skill named studio-use. Then read `onboarding.md` and walk me through it.
```
The agent installs everything and stops only for what needs your hands: on
macOS, granting Screen Recording and Input Monitoring to your terminal.
Details and troubleshooting in [install.md](install.md).
## Usage
```bash
studio new demo # a project at projects/demo/
studio app projects/demo --port 5173 # opens the editor; press Record
```
Then ask your agent, or drive it yourself:
```bash
studio-harness <<'PY'
print(outline()) # the timeline, as text
apply({"type": "remove_range", "fromMs": 76000, "toMs": 290000,
"ripple": True}, reason="cut the idle stretch")
print(frame(75500)) # render one frame, look at it
PY
```
[SKILL.md](SKILL.md) is the agent's guide. `studio ops` lists every op with
its JSON Schema.
## How it works
The agent never drives the UI or touches pixels. It edits a JSON timeline
through a fixed set of named ops, the same ops the editor uses, so it cannot
do anything you couldn't. A recording carries every keystroke, click and
cursor position on the same clock as the frames, which is how the agent
finds dead air without decoding a frame. It renders one frame to check a
cut, not thirty thousand to find it.
## Requirements
- Node 20+ and ffmpeg. Everything runs on your machine.
- Recording: macOS 14+ with Xcode Command Line Tools, or Linux with an X11
session. No Wayland, no Windows yet; editing works anywhere Node runs.
- Optional: `mlx_whisper` or `whisper` for transcripts.
## License
[Apache 2.0](LICENSE). Remotion has its own
[terms](https://www.remotion.pro/license): free for individuals and companies
of up to three people, a license above that.