Skip to content

Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.

docs: the openscreen-demo skill, and how to let an agent make the whole video

EtienneLescot747e9ed9bea1
diff --git a/README.md b/README.md
index 48280bb0e..4347bf43c 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,22 @@ openscreen export demo.openscreen -o demo.mp4 --json
See the [CLI reference](https://getopenscreen.com/docs/cli/).
+### Let your coding agent make the demo
+
+Give Claude Code, Codex or Cursor OpenScreen's MCP tools, and the skill that
+teaches the whole job:
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+npx skills add getopenscreen/openscreen --skill openscreen-demo
+```
+
+Then ask: *"Make a demo video of this feature with OpenScreen."* The agent plans
+the storyboard, records the app, edits the take with OpenScreen's own editing
+tools, exports the MP4, checks it frame by frame, and drafts the post for X,
+which it publishes only once you say yes. The executable on Windows and Linux,
+and the other clients, are in [AI editing](https://getopenscreen.com/docs/ai-editing/#letting-an-agent-make-the-whole-video).
+
## Installation
Every platform has a recommended route below. On Windows that is the Microsoft Store; everywhere else it is the installer from the [GitHub Releases](https://github.com/getopenscreen/openscreen/releases) page.
diff --git a/skills/openscreen-demo/SKILL.md b/skills/openscreen-demo/SKILL.md
new file mode 100644
index 000000000..48e142a61
--- /dev/null
+++ b/skills/openscreen-demo/SKILL.md
@@ -0,0 +1,92 @@
+---
+name: openscreen-demo
+description: Make a polished product demo video of an app or a feature with OpenScreen's MCP tools, from storyboard to recording, editing, export and a post on X. Use when the user asks for a demo, a demo video, a screen recording, a product video, a launch clip, or a video for X/Twitter, LinkedIn, a README or a pull request.
+---
+
+# Make a demo video with OpenScreen
+
+You produce a short MP4 (20 to 60 s, 1080p, 60 fps) that shows one feature, zooms on the action and carries its message in on-screen callouts, then a post ready for X. You do the whole job through OpenScreen's MCP tools: record, edit, export, look. **Nothing is ever posted without the user's explicit yes.**
+
+## 1. Connect OpenScreen
+
+You need the tools `startRecording`, `stopRecording`, `exportVideo` and `getFrames`. If they are missing, add OpenScreen's MCP server: it is the desktop app's own executable, started with `mcp`.
+
+| OS | Executable |
+|---|---|
+| Windows | `%LOCALAPPDATA%\Programs\Openscreen\Openscreen.exe`, or `C:\Program Files\Openscreen\Openscreen.exe` |
+| macOS | `/Applications/Openscreen.app/Contents/MacOS/Openscreen` |
+| Linux | `openscreen` on the PATH, or the AppImage |
+
+- **Claude Code:** `claude mcp add openscreen -- "<executable>" mcp`
+- **Codex:** `codex mcp add openscreen -- "<executable>" mcp`
+- **Cursor and others:** a stdio server with the executable as `command` and `["mcp"]` as `args`.
+
+Then ask the user to start a new session so the tools load. If the app is not installed, send the user to https://getopenscreen.com/download/ and stop there.
+
+- **macOS:** the app that runs the agent needs the Screen Recording permission.
+- **Linux:** the desktop's picker opens on every recording, and the user chooses the window.
+
+## 2. Plan before recording
+
+Write a storyboard and show it to the user in a few lines, then carry on unless they object.
+
+- **One message.** What should a viewer remember after 3 seconds? The first beat shows the result, not a setup screen.
+- **3 to 6 beats.** Each beat is one action and one callout of 6 words or fewer.
+- **20 to 60 seconds.** X autoplays muted, so the callouts carry the story, not a voice.
+- **Realistic data.** Seed the app with believable content. No real customer data, secrets, tokens or personal notifications on screen.
+
+## 3. Set the stage
+
+- Start the app and open it on the starting state of the first beat.
+- Give it one clean window of about 1600×1000. For a web app, open it in an app window without browser chrome: `chrome --app=http://localhost:3000 --window-size=1600,1000 --user-data-dir=<temp folder>`. Its title is the page's `<title>`.
+- Call `listSources` and pick a unique part of the window's title.
+- Close or hide anything personal. Recording one window keeps the rest of the desktop out.
+
+## 4. Record
+
+1. `startRecording` with `window`. It returns once capture has started.
+2. Play the storyboard. Move deliberately, and pause about one second after each result appears.
+3. `stopRecording` with a `title`. Keep what it returns: `projectId`, `checkpointId`, `videoPath`, `recordingStartedAt`.
+
+**How you drive the app decides the cursor.**
+- **Real mouse** (computer-use, or any tool that moves the actual pointer): OpenScreen records the pointer, draws a clean cursor and already zooms on each click.
+- **A script** (Playwright, CDP): the screen pointer never moves, so the take has no cursor and no zoom. In the script, log every action as it runs: `at` is `Date.now()`, `x` and `y` are the action's position as fractions of the window, `click` is true for a click. Hand the log to `setPointerTrack` after `stopRecording`; its description gives the formula from a page's coordinates. A script also gives the cleanest take: same timing on every run, no hesitation.
+
+## 5. Check the take
+
+`getFrames` on the `videoPath`, about 6 frames. Is it the right window? Is anything private visible? Did every beat happen? If not, record again: a new take costs less than a fix in editing.
+
+## 6. Edit
+
+Use the document tools, always with the `projectId`. Read the project first with `getCurrentDocument`: its notes say which times are in the recording's seconds and which in the edited video's.
+
+- **Cut dead time:** the setup at the start, the stop at the end, any wait. Use `addTrims`, or `addSpeed` to fast-forward a wait instead of cutting it.
+- **Zoom on the action:** the clicks already have zooms. Check them, then add or move zooms with `addZooms` and `setZoom` where a result appears without a click. Hold a zoom at least 1.5 s.
+- **Callouts:** one `addAnnotation` per beat, short text placed clear of the action.
+- **Undo:** `restoreCheckpoint` with the `checkpointId` takes the project back to the raw take in one step.
+
+Keep the rest as it is: the background, padding, shadow and cursor style are chosen to look good.
+
+## 7. Export and review
+
+1. `exportVideo` with the `projectId` and a path such as `demo/demo.mp4`.
+2. `getFrames` on the export, at the moments of your beats.
+3. Check every frame:
+ - Is each callout readable and clear of the action?
+ - Is each zoom on the thing that changes?
+ - Are there black frames, cut-off text or a leftover setup screen?
+4. Fix the project and export again until it holds.
+
+## 8. Post on X
+
+1. **Write the post.** At most 280 characters: the hook first, then what it does, then the link if there is one. One or two hashtags at most.
+2. **Check X's limits.** The video must be an MP4 of at most 2 min 20 s and 512 MB for an account without Premium. The export fits.
+3. **Ask the user.** Show the post text, the video path and one frame, and ask for an explicit yes. A "looks good" given to an earlier step is not one.
+4. **Post, after the yes only.** Use a browser tool that can attach a file to the composer at https://x.com/compose/post, or the X API if the user has set one up. If you cannot attach a file, give the user the text and the file instead.
+5. Report the post's URL.
+
+## When it goes wrong
+
+- **`The recording did not start`:** the window title did not match, or capture is not permitted. Check `listSources` and the permissions in step 1.
+- **No cursor in the video:** the app was driven by a script. See step 4.
+- **No zoom on an early click:** the first 2.5 s stay wide on purpose. Start the first action after that.
diff --git a/website/docs/ai-editing.md b/website/docs/ai-editing.md
index 99337601a..c507d8cfe 100644
--- a/website/docs/ai-editing.md
+++ b/website/docs/ai-editing.md
@@ -68,3 +68,19 @@ If you already use an AI coding agent such as Claude Code or Codex, it can drive
3. Keep a project open in the OpenScreen editor, then ask your agent for the edit.
The tools are the ones the built-in agent uses, and they act on the project open in the editor. MCP clients can only **read** the project until you also turn on **Project edits** in the MCP server section; this switch is separate from the built-in agent's, and it starts off. Once on, each edit is saved as it lands and undone with `Ctrl/Cmd + Z`. Clients are told to save a checkpoint before a series of edits, so you can ask them to put the project back as it was in a single step, which `Ctrl/Cmd + Z` can itself undo. **Regenerate** the token to disconnect every client set up with the old one.
+
+## Letting an agent make the whole video
+
+The server above edits projects. To have an agent make a whole video on its own, from the recording to the export, add OpenScreen to it as a stdio server instead: the agent starts the app's own executable with `mcp`. It gets the same editing tools, plus `listSources`, `startRecording`, `stopRecording`, `setPointerTrack`, `exportVideo` and `getFrames`.
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+The executable on each system is listed in [Running the CLI](./cli.md#running-the-cli).
+
+- **No port, no token, no setting.** The agent starts the process itself, with your rights, as it would run `openscreen record`. So it can record your screen and edit without the **Project edits** switch.
+- **Each take becomes a new project** in your project list, with a zoom on each recorded click, as a recording made in the app. Do not edit it in the editor while the agent is still working on it: the editor keeps its own copy.
+- **A take driven by a script** (Playwright, for example) never moves the screen pointer. The agent hands OpenScreen its own log of the actions with `setPointerTrack`, and the video gets a cursor and its zooms all the same.
+- **The `openscreen-demo` skill** teaches an agent the whole job, from the storyboard to a post on X that it publishes only once you say yes. Add it with `npx skills add getopenscreen/openscreen --skill openscreen-demo`. The recipe is [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/docs/cli.md b/website/docs/cli.md
index 293e3cb4e..e6590764c 100644
--- a/website/docs/cli.md
+++ b/website/docs/cli.md
@@ -14,7 +14,7 @@ keywords:
# Screen recorder CLI
-OpenScreen's command-line interface is built into the desktop app's own executable. `openscreen record`, `captions`, `export`, `pack`, `info` and `sources` run from a terminal without opening a window, and `--json` turns their output into NDJSON on stdout. A script, a CI job or a coding agent can record a take, edit the `.openscreen` project as plain JSON, and render an MP4 or GIF with the same native compositor as the editor's **Export** button.
+OpenScreen's command-line interface is built into the desktop app's own executable. `openscreen record`, `captions`, `export`, `pack`, `info`, `sources` and `mcp` run from a terminal without opening a window, and `--json` turns their output into NDJSON on stdout. A script, a CI job or a coding agent can record a take, edit the `.openscreen` project as plain JSON, and render an MP4 or GIF with the same native compositor as the editor's **Export** button.
It is not a server tool. Every command starts Electron, which needs a display server even though no window appears, and recording needs a real desktop session. See [When the CLI is not the right tool](#when-the-cli-is-not-the-right-tool).
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- The project's screen video must have an audio track, for example from `record --mic`.
- Captions are burned into the export. There is no subtitle file output. See [Captions](./captions.md).
+### `openscreen mcp`
+
+Serves OpenScreen's MCP tools on stdin and stdout, for a coding agent that starts it: the editing tools, plus recording, export and still frames. You do not run it yourself; your agent does, once it is set up as [Letting an agent make the whole video](./ai-editing.md#letting-an-agent-make-the-whole-video) shows.
+
### `openscreen pack`
Copies a project and everything it references (screen video, webcam video, cursor telemetry) into one folder, and rewrites the media paths in the copied project.
@@ -297,5 +301,6 @@ The CLI is part of the [OpenScreen repository](https://github.com/getopenscreen/
- `electron/cli/args.ts`: the argument parser and the usage text, unit-tested in `args.test.ts`.
- `electron/cli/cliMain.ts`: the windowless boot, the stdio protocol, stop signals and exit codes.
- `electron/cli/projectCommands.ts`: `pack` and `info`.
+- `electron/mcp/stdio-server.ts` and `electron/mcp/media-tools.ts`: `mcp`.
- `src/cli/`: the hidden-window runners for `record`, `sources`, `export` and `captions`.
- `src/lib/cliContracts.ts`: the request and result types shared by both sides.
diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md
index dd11d5a63..daa540564 100644
--- a/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ Der Eintrag **Smart cuts** (mit *With AI* markiert) im Menü **Auto-enhance** de
## Was deinen Anbieter sonst noch nutzt {#what-else-uses-your-provider}
Die [Untertitelübersetzung](./captions.md#translation) ist ein einzelner Aufruf zur Textumwandlung an dasselbe Modell. Sie startet keine Agentenschleife und kann dein Dokument nicht verändern. Transkription und Untertitel-Rendering bleiben in jedem Fall vollständig auf deinem Gerät.
+
+## Claude Code, Codex oder einen anderen MCP-Client nutzen {#using-claude-code-codex-or-another-mcp-client}
+
+Wenn du bereits einen KI-Coding-Agenten wie Claude Code oder Codex nutzt, kann er dieselben Bearbeitungswerkzeuge steuern, angemeldet mit seinem eigenen Konto. Nichts von diesem Konto läuft über OpenScreen.
+
+1. **AI settings** → **MCP server** → einschalten. Er lauscht nur auf deinem eigenen Rechner (`127.0.0.1`), auf dem angezeigten Port.
+2. Kopiere den dort angezeigten Befehl für **Claude Code** oder **Codex** und führe ihn in einem Terminal aus. Der Befehl für Claude Code enthält das Zugriffstoken. Codex liest es stattdessen aus der Umgebungsvariable `OPENSCREEN_MCP_TOKEN`: Setze sie in der Shell, aus der du Codex startest.
+3. Lass ein Projekt im OpenScreen-Editor geöffnet und bitte dann deinen Agenten um die Änderung.
+
+Die Werkzeuge sind die, die der eingebaute Agent nutzt, und sie wirken auf das im Editor geöffnete Projekt. MCP-Clients können das Projekt nur **lesen**, bis du im Abschnitt MCP-Server auch **Project edits** einschaltest; dieser Schalter ist von dem des eingebauten Agenten getrennt und steht anfangs auf aus. Ist er an, wird jede Änderung gespeichert, sobald sie ankommt, und mit `Ctrl/Cmd + Z` rückgängig gemacht. Clients werden angewiesen, vor einer Reihe von Änderungen einen Wiederherstellungspunkt zu speichern. So kannst du sie bitten, das Projekt in einem einzigen Schritt wiederherzustellen, wie es war, und auch diesen Schritt kann `Ctrl/Cmd + Z` rückgängig machen. Wenn du das Token mit **Regenerate** ersetzt, werden alle Clients getrennt, die mit dem alten eingerichtet wurden.
+
+## Einen Agenten das ganze Video erstellen lassen {#letting-an-agent-make-the-whole-video}
+
+Der Server oben bearbeitet Projekte. Soll ein Agent ein ganzes Video selbstständig erstellen, von der Aufnahme bis zum Export, füge OpenScreen stattdessen als stdio-Server zum Agenten hinzu: Der Agent startet die eigene ausführbare Datei der App mit `mcp`. Er bekommt dieselben Bearbeitungswerkzeuge, dazu `listSources`, `startRecording`, `stopRecording`, `setPointerTrack`, `exportVideo` und `getFrames`.
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+Die ausführbare Datei für jedes System steht unter [Die CLI ausführen](./cli.md#running-the-cli).
+
+- **Kein Port, kein Token, keine Einstellung.** Der Agent startet den Prozess selbst, mit deinen Rechten, so wie er `openscreen record` ausführen würde. Deshalb kann er deinen Bildschirm aufnehmen und bearbeiten, ohne den Schalter **Project edits**.
+- **Jeder Take wird zu einem neuen Projekt** in deiner Projektliste, mit einem Zoom auf jeden aufgezeichneten Klick, wie eine in der App gemachte Aufnahme. Bearbeite es nicht im Editor, solange der Agent noch daran arbeitet: Der Editor hält seine eigene Kopie.
+- **Ein per Skript gesteuerter Take** (zum Beispiel mit Playwright) bewegt nie den Zeiger auf dem Bildschirm. Der Agent übergibt OpenScreen mit `setPointerTrack` sein eigenes Protokoll der Aktionen, und das Video bekommt trotzdem einen Cursor und dessen Zooms.
+- **Der Skill `openscreen-demo`** bringt einem Agenten die ganze Arbeit bei, vom Storyboard bis zu einem Post auf X, den er erst veröffentlicht, wenn du Ja sagst. Füge ihn mit `npx skills add getopenscreen/openscreen --skill openscreen-demo` hinzu. Das Rezept ist [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/de/docusaurus-plugin-content-docs/current/cli.md
index a2445d8d3..39e23c460 100644
--- a/website/i18n/de/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/de/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# Bildschirmrekorder-CLI
-Die Kommandozeilenschnittstelle von OpenScreen ist in die ausführbare Datei der Desktop-App selbst eingebaut. `openscreen record`, `captions`, `export`, `pack`, `info` und `sources` laufen im Terminal, ohne ein Fenster zu öffnen, und `--json` macht aus ihrer Ausgabe NDJSON auf stdout. Ein Skript, ein CI-Job oder ein Coding-Agent kann einen Take aufnehmen, das `.openscreen`-Projekt als einfaches JSON bearbeiten und mit demselben nativen Compositor wie die Schaltfläche **Export** im Editor ein MP4 oder GIF rendern.
+Die Kommandozeilenschnittstelle von OpenScreen ist in die ausführbare Datei der Desktop-App selbst eingebaut. `openscreen record`, `captions`, `export`, `pack`, `info`, `sources` und `mcp` laufen im Terminal, ohne ein Fenster zu öffnen, und `--json` macht aus ihrer Ausgabe NDJSON auf stdout. Ein Skript, ein CI-Job oder ein Coding-Agent kann einen Take aufnehmen, das `.openscreen`-Projekt als einfaches JSON bearbeiten und mit demselben nativen Compositor wie die Schaltfläche **Export** im Editor ein MP4 oder GIF rendern.
Ein Server-Tool ist sie nicht. Jeder Befehl startet Electron, das einen Displayserver braucht, auch wenn kein Fenster erscheint, und für die Aufnahme ist eine echte Desktop-Sitzung nötig. Siehe [Wann die CLI nicht das richtige Werkzeug ist](#when-the-cli-is-not-the-right-tool).
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- Das Bildschirmvideo des Projekts muss eine Audiospur haben, zum Beispiel aus `record --mic`.
- Untertitel werden in den Export eingebrannt. Eine Ausgabe als Untertiteldatei gibt es nicht. Siehe [Untertitel](./captions.md).
+### `openscreen mcp` {#openscreen-mcp}
+
+Stellt die MCP-Werkzeuge von OpenScreen über stdin und stdout bereit, für einen Coding-Agenten, der den Befehl startet: die Bearbeitungswerkzeuge, dazu Aufnahme, Export und Standbilder. Du führst ihn nicht selbst aus; das macht dein Agent, sobald er so eingerichtet ist, wie [Einen Agenten das ganze Video erstellen lassen](./ai-editing.md#letting-an-agent-make-the-whole-video) zeigt.
+
### `openscreen pack` {#openscreen-pack}
Kopiert ein Projekt und alles, worauf es verweist (Bildschirmvideo, Webcam-Video, Cursor-Telemetrie), in einen Ordner und schreibt die Medienpfade im kopierten Projekt um.
@@ -297,5 +301,6 @@ Die CLI ist Teil des [OpenScreen-Repositorys](https://github.com/getopenscreen/o
- `electron/cli/args.ts`: der Argument-Parser und der Hilfetext, mit Unit-Tests in `args.test.ts`.
- `electron/cli/cliMain.ts`: der Start ohne Fenster, das stdio-Protokoll, Stoppsignale und Exit-Codes.
- `electron/cli/projectCommands.ts`: `pack` und `info`.
+- `electron/mcp/stdio-server.ts` und `electron/mcp/media-tools.ts`: `mcp`.
- `src/cli/`: die Runner in versteckten Fenstern für `record`, `sources`, `export` und `captions`.
- `src/lib/cliContracts.ts`: die Anfrage- und Ergebnistypen, die beide Seiten teilen.
diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md
index e010779fb..061976835 100644
--- a/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ La opción **Cortes inteligentes** (marcada *Con IA*) del menú de mejora autom
## Qué más usa tu proveedor {#what-else-uses-your-provider}
La [traducción de subtítulos](./captions.md#translation) es una sola llamada de transformación de texto al mismo modelo: no ejecuta el ciclo del agente y no puede tocar tu documento. La transcripción y el renderizado de los subtítulos se hacen por completo en tu equipo en cualquier caso.
+
+## Usar Claude Code, Codex u otro cliente MCP {#using-claude-code-codex-or-another-mcp-client}
+
+Si ya usas un agente de código con IA como Claude Code o Codex, puede manejar las mismas herramientas de edición, con la sesión iniciada en su propia cuenta. Nada de esa cuenta pasa por OpenScreen.
+
+1. **Configuración de IA** → **Servidor MCP** → actívalo. Solo escucha en tu propio equipo (`127.0.0.1`), en el puerto que se muestra.
+2. Copia el comando de **Claude Code** o de **Codex** que aparece ahí y ejecútalo en una terminal. El comando de Claude Code lleva el token de acceso. Codex, en cambio, lo lee de la variable de entorno `OPENSCREEN_MCP_TOKEN`: defínela en el shell desde el que inicias Codex.
+3. Mantén un proyecto abierto en el editor de OpenScreen y luego pídele la edición a tu agente.
+
+Las herramientas son las que usa el agente integrado, y actúan sobre el proyecto abierto en el editor. Los clientes MCP solo pueden **leer** el proyecto hasta que también actives **Ediciones del proyecto** en la sección Servidor MCP; este interruptor es independiente del del agente integrado, y empieza desactivado. Una vez activado, cada edición se guarda en cuanto se aplica y se deshace con `Ctrl/Cmd + Z`. A los clientes se les indica que guarden un punto de restauración antes de una serie de ediciones, así que puedes pedirles que dejen el proyecto como estaba en un solo paso, que el propio `Ctrl/Cmd + Z` puede deshacer. **Regenerar** el token desconecta a todos los clientes configurados con el anterior.
+
+## Dejar que un agente haga todo el video {#letting-an-agent-make-the-whole-video}
+
+El servidor de arriba edita proyectos. Para que un agente haga un video completo por sí solo, desde la grabación hasta la exportación, agrega en cambio OpenScreen al agente como servidor stdio: el agente inicia el propio ejecutable de la app con `mcp`. Obtiene las mismas herramientas de edición, además de `listSources`, `startRecording`, `stopRecording`, `setPointerTrack`, `exportVideo` y `getFrames`.
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+El ejecutable de cada sistema aparece en [Ejecutar la CLI](./cli.md#running-the-cli).
+
+- **Sin puerto, sin token, sin ajuste.** El agente inicia el proceso él mismo, con tus permisos, como ejecutaría `openscreen record`. Así puede grabar tu pantalla y editar sin el interruptor **Ediciones del proyecto**.
+- **Cada toma se convierte en un proyecto nuevo** en tu lista de proyectos, con un zoom en cada clic grabado, como una grabación hecha en la app. No lo edites en el editor mientras el agente siga trabajando en él: el editor conserva su propia copia.
+- **Una toma controlada por un script** (Playwright, por ejemplo) nunca mueve el puntero de la pantalla. El agente le pasa a OpenScreen su propio registro de las acciones con `setPointerTrack`, y el video obtiene igualmente un cursor y sus zooms.
+- **La skill `openscreen-demo`** le enseña a un agente todo el trabajo, desde el storyboard hasta un post en X que solo publica cuando dices que sí. Agrégala con `npx skills add getopenscreen/openscreen --skill openscreen-demo`. La receta es [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/es/docusaurus-plugin-content-docs/current/cli.md
index 7094fbfd3..615a75b51 100644
--- a/website/i18n/es/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/es/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# CLI de grabación de pantalla
-La interfaz de línea de comandos de OpenScreen está integrada en el propio ejecutable de la app de escritorio. `openscreen record`, `captions`, `export`, `pack`, `info` y `sources` se ejecutan desde una terminal sin abrir ninguna ventana, y `--json` convierte su salida en NDJSON por stdout. Un script, un trabajo de CI o un agente de código puede grabar una toma, editar el proyecto `.openscreen` como JSON normal y renderizar un MP4 o un GIF con el mismo compositor nativo que el botón **Exportar** del editor.
+La interfaz de línea de comandos de OpenScreen está integrada en el propio ejecutable de la app de escritorio. `openscreen record`, `captions`, `export`, `pack`, `info`, `sources` y `mcp` se ejecutan desde una terminal sin abrir ninguna ventana, y `--json` convierte su salida en NDJSON por stdout. Un script, un trabajo de CI o un agente de código puede grabar una toma, editar el proyecto `.openscreen` como JSON normal y renderizar un MP4 o un GIF con el mismo compositor nativo que el botón **Exportar** del editor.
No es una herramienta para servidores. Cada comando inicia Electron, que necesita un servidor gráfico aunque no aparezca ninguna ventana, y grabar requiere una sesión de escritorio real. Consulta [Cuándo la CLI no es la herramienta adecuada](#when-the-cli-is-not-the-right-tool).
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- El video de pantalla del proyecto debe tener una pista de audio, por ejemplo de `record --mic`.
- Los subtítulos se incrustan en la exportación. No se genera ningún archivo de subtítulos. Consulta [Subtítulos](./captions.md).
+### `openscreen mcp` {#openscreen-mcp}
+
+Expone las herramientas MCP de OpenScreen por stdin y stdout, para un agente de código que lo inicia: las herramientas de edición, además de la grabación, la exportación y los fotogramas fijos. No lo ejecutas tú; lo hace tu agente, una vez configurado como muestra [Dejar que un agente haga todo el video](./ai-editing.md#letting-an-agent-make-the-whole-video).
+
### `openscreen pack` {#openscreen-pack}
Copia un proyecto y todo aquello a lo que hace referencia (video de pantalla, video de la cámara web, telemetría del cursor) en una sola carpeta, y reescribe las rutas de los archivos multimedia en el proyecto copiado.
@@ -297,5 +301,6 @@ La CLI forma parte del [repositorio de OpenScreen](https://github.com/getopenscr
- `electron/cli/args.ts`: el analizador de argumentos y el texto de uso, con pruebas unitarias en `args.test.ts`.
- `electron/cli/cliMain.ts`: el arranque sin ventana, el protocolo stdio, las señales de detención y los códigos de salida.
- `electron/cli/projectCommands.ts`: `pack` e `info`.
+- `electron/mcp/stdio-server.ts` y `electron/mcp/media-tools.ts`: `mcp`.
- `src/cli/`: los ejecutores en ventana oculta de `record`, `sources`, `export` y `captions`.
- `src/lib/cliContracts.ts`: los tipos de solicitud y de resultado que comparten ambos lados.
diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md
index 64eaeff6b..c8eb22925 100644
--- a/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ L'entrée **Coupes intelligentes** (marquée *Avec l'IA*) du menu Amélioration
## Ce qui utilise aussi votre fournisseur {#what-else-uses-your-provider}
La [traduction des sous-titres](./captions.md#translation) est un simple appel de transformation de texte adressé au même modèle : elle ne lance pas la boucle de l'agent et ne peut pas toucher à votre document. La transcription et le rendu des sous-titres restent entièrement en local dans tous les cas.
+
+## Utiliser Claude Code, Codex ou un autre client MCP {#using-claude-code-codex-or-another-mcp-client}
+
+Si vous utilisez déjà un agent de code IA comme Claude Code ou Codex, il peut piloter les mêmes outils d'édition, connecté avec son propre compte. Rien de ce compte ne passe par OpenScreen.
+
+1. **Paramètres IA** → **Serveur MCP** → activez-le. Il n'écoute que sur votre propre machine (`127.0.0.1`), sur le port affiché.
+2. Copiez la commande **Claude Code** ou **Codex** affichée à cet endroit et lancez-la dans un terminal. La commande Claude Code contient le jeton d'accès. Codex, lui, le lit dans la variable d'environnement `OPENSCREEN_MCP_TOKEN` : définissez-la dans le shell depuis lequel vous lancez Codex.
+3. Gardez un projet ouvert dans l'éditeur d'OpenScreen, puis demandez la modification à votre agent.
+
+Les outils sont ceux qu'utilise l'agent intégré, et ils agissent sur le projet ouvert dans l'éditeur. Les clients MCP ne peuvent que **lire** le projet tant que vous n'avez pas aussi activé **Modifications du projet** dans la section Serveur MCP ; cet interrupteur est distinct de celui de l'agent intégré, et il est désactivé au départ. Une fois activé, chaque modification est enregistrée dès qu'elle est appliquée et s'annule avec `Ctrl/Cmd + Z`. Les clients ont pour consigne d'enregistrer un point de restauration avant une série de modifications : vous pouvez donc leur demander de remettre le projet dans son état d'avant en une seule étape, que `Ctrl/Cmd + Z` peut lui-même annuler. **Régénérer** le jeton déconnecte tous les clients configurés avec l'ancien.
+
+## Laisser un agent faire toute la vidéo {#letting-an-agent-make-the-whole-video}
+
+Le serveur ci-dessus modifie des projets. Pour qu'un agent fasse une vidéo entière tout seul, de l'enregistrement à l'export, ajoutez plutôt OpenScreen à l'agent comme serveur stdio : l'agent lance l'exécutable même de l'application avec `mcp`. Il dispose des mêmes outils d'édition, plus `listSources`, `startRecording`, `stopRecording`, `setPointerTrack`, `exportVideo` et `getFrames`.
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+L'exécutable de chaque système est indiqué dans [Lancer la CLI](./cli.md#running-the-cli).
+
+- **Ni port, ni jeton, ni réglage.** L'agent lance lui-même le processus, avec vos droits, comme il lancerait `openscreen record`. Il peut donc enregistrer votre écran et faire des modifications sans l'interrupteur **Modifications du projet**.
+- **Chaque prise devient un nouveau projet** dans votre liste de projets, avec un zoom sur chaque clic enregistré, comme un enregistrement fait dans l'application. Ne le modifiez pas dans l'éditeur tant que l'agent y travaille encore : l'éditeur garde sa propre copie.
+- **Une prise pilotée par un script** (Playwright, par exemple) ne déplace jamais le pointeur de l'écran. L'agent transmet à OpenScreen son propre journal des actions avec `setPointerTrack`, et la vidéo a malgré tout un curseur et ses zooms.
+- **La skill `openscreen-demo`** enseigne à un agent tout le travail, du storyboard jusqu'à un post sur X qu'il ne publie qu'une fois que vous avez dit oui. Ajoutez-la avec `npx skills add getopenscreen/openscreen --skill openscreen-demo`. La recette est [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/cli.md
index 437407a4b..6fd6b9fd8 100644
--- a/website/i18n/fr/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# CLI d'enregistrement d'écran
-L'interface en ligne de commande d'OpenScreen est intégrée à l'exécutable même de l'application de bureau. `openscreen record`, `captions`, `export`, `pack`, `info` et `sources` s'exécutent depuis un terminal sans ouvrir de fenêtre, et `--json` transforme leur sortie en NDJSON sur stdout. Un script, un job de CI ou un agent de code peut enregistrer une prise, modifier le projet `.openscreen` comme du simple JSON, et produire un MP4 ou un GIF avec le même moteur de composition natif que le bouton **Exporter** de l'éditeur.
+L'interface en ligne de commande d'OpenScreen est intégrée à l'exécutable même de l'application de bureau. `openscreen record`, `captions`, `export`, `pack`, `info`, `sources` et `mcp` s'exécutent depuis un terminal sans ouvrir de fenêtre, et `--json` transforme leur sortie en NDJSON sur stdout. Un script, un job de CI ou un agent de code peut enregistrer une prise, modifier le projet `.openscreen` comme du simple JSON, et produire un MP4 ou un GIF avec le même moteur de composition natif que le bouton **Exporter** de l'éditeur.
Ce n'est pas un outil pour serveur. Chaque commande démarre Electron, qui a besoin d'un serveur d'affichage même si aucune fenêtre n'apparaît, et l'enregistrement exige une vraie session de bureau. Voir [Quand la CLI n'est pas le bon outil](#when-the-cli-is-not-the-right-tool).
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- La vidéo d'écran du projet doit avoir une piste audio, par exemple issue de `record --mic`.
- Les sous-titres sont incrustés dans l'export. Aucun fichier de sous-titres n'est produit. Voir [Sous-titres et transcription](./captions.md).
+### `openscreen mcp` {#openscreen-mcp}
+
+Expose les outils MCP d'OpenScreen sur stdin et stdout, pour un agent de code qui la lance : les outils d'édition, plus l'enregistrement, l'export et les images fixes. Vous ne la lancez pas vous-même ; votre agent le fait, une fois configuré comme le montre [Laisser un agent faire toute la vidéo](./ai-editing.md#letting-an-agent-make-the-whole-video).
+
### `openscreen pack` {#openscreen-pack}
Copie un projet et tout ce qu'il référence (vidéo d'écran, vidéo de la webcam, télémétrie du curseur) dans un seul dossier, et réécrit les chemins des médias dans le projet copié.
@@ -297,5 +301,6 @@ La CLI fait partie du [dépôt OpenScreen](https://github.com/getopenscreen/open
- `electron/cli/args.ts` : l'analyseur d'arguments et le texte d'aide, couverts par des tests unitaires dans `args.test.ts`.
- `electron/cli/cliMain.ts` : le démarrage sans fenêtre, le protocole stdio, les signaux d'arrêt et les codes de sortie.
- `electron/cli/projectCommands.ts` : `pack` et `info`.
+- `electron/mcp/stdio-server.ts` et `electron/mcp/media-tools.ts` : `mcp`.
- `src/cli/` : les exécuteurs en fenêtre cachée de `record`, `sources`, `export` et `captions`.
- `src/lib/cliContracts.ts` : les types de requête et de résultat partagés par les deux côtés.
diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md
index bc9e3dcb4..bd93fb631 100644
--- a/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ ChatGPT と GitHub Copilot のサインインは、**1.8.0 で削除されまし
## プロバイダーを使うその他の機能 {#what-else-uses-your-provider}
[字幕の翻訳](./captions.md#translation)は、同じモデルに対する単発のテキスト変換の呼び出しです。エージェントのループは実行せず、プロジェクトのドキュメントに触れることもできません。どちらの場合も、文字起こしと字幕のレンダリングは完全に端末上で行われます。
+
+## Claude Code、Codex などの MCP クライアントを使う {#using-claude-code-codex-or-another-mcp-client}
+
+Claude Code や Codex などの AI コーディングエージェントをすでに使っている場合は、そのエージェントが自身のアカウントでサインインしたまま、同じ編集ツールを操作できます。そのアカウントに関する情報が OpenScreen を経由することは一切ありません。
+
+1. **AI設定** → **MCP サーバー** → オンにします。サーバーは自分のマシン(`127.0.0.1`)上の、表示されているポートでのみ待ち受けます。
+2. そこに表示される **Claude Code** または **Codex** のコマンドをコピーし、ターミナルで実行します。Claude Code のコマンドにはアクセストークンが含まれています。Codex は代わりに環境変数 `OPENSCREEN_MCP_TOKEN` からトークンを読み取るため、Codex を起動するシェルでこの変数を設定してください。
+3. OpenScreen のエディターでプロジェクトを開いたまま、エージェントに編集を依頼します。
+
+ツールは組み込みのエージェントが使うものと同じで、エディターで開いているプロジェクトに作用します。MCP サーバーのセクションで**プロジェクトの編集**もオンにするまで、MCP クライアントはプロジェクトを**読み取る**ことしかできません。このスイッチは組み込みのエージェントのものとは別で、最初はオフです。オンにすると、各編集は反映された時点で保存され、`Ctrl/Cmd + Z` で元に戻せます。クライアントには一連の編集の前にチェックポイントを保存するよう指示されているため、プロジェクトを 1 回の操作で元の状態に戻すよう頼むことができ、その操作自体も `Ctrl/Cmd + Z` で取り消せます。トークンを**再生成**すると、古いトークンで設定したクライアントはすべて切断されます。
+
+## エージェントに動画全体を作らせる {#letting-an-agent-make-the-whole-video}
+
+上のサーバーはプロジェクトを編集するものです。録画からエクスポートまで、エージェントに動画全体を自力で作らせるには、代わりに OpenScreen を stdio サーバーとしてエージェントに追加します。エージェントは、アプリ自身の実行ファイルを `mcp` 付きで起動します。エージェントは同じ編集ツールに加えて、`listSources`、`startRecording`、`stopRecording`、`setPointerTrack`、`exportVideo`、`getFrames` を使えます。
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+各システムでの実行ファイルは、[CLI の実行](./cli.md#running-the-cli)に記載しています。
+
+- **ポートも、トークンも、設定も不要。** エージェントは、`openscreen record` を実行するときと同じように、あなたの権限でプロセスを自分で起動します。そのため、**プロジェクトの編集**スイッチなしで、画面を録画し、編集できます。
+- **テイクはそれぞれ新しいプロジェクトになり**、プロジェクト一覧に表示されます。アプリで作った録画と同じく、記録された各クリックにズームが付きます。エージェントがまだ作業している間は、エディターで編集しないでください。エディターは独自のコピーを保持しています。
+- **スクリプトで操作するテイク**(たとえば Playwright)では、画面のポインターはまったく動きません。エージェントが `setPointerTrack` で自分の操作ログを OpenScreen に渡せば、動画には同じようにカーソルとそのズームが付きます。
+- **`openscreen-demo` スキル**は、絵コンテから X への投稿まで、作業全体をエージェントに教えます。投稿は、あなたが了承してはじめて公開されます。`npx skills add getopenscreen/openscreen --skill openscreen-demo` で追加します。手順は [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md) にあります。
diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/cli.md
index d0d857eeb..e4979da0f 100644
--- a/website/i18n/ja/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# 画面録画 CLI
-OpenScreen のコマンドラインインターフェースは、デスクトップアプリ自身の実行ファイルに組み込まれています。`openscreen record`、`captions`、`export`、`pack`、`info`、`sources` はウィンドウを開かずにターミナルから実行でき、`--json` を付けると出力が stdout への NDJSON になります。スクリプト、CI ジョブ、コーディングエージェントは、テイクを録画し、`.openscreen` プロジェクトをただの JSON として編集し、エディターの**エクスポート**ボタンと同じネイティブコンポジターで MP4 や GIF をレンダリングできます。
+OpenScreen のコマンドラインインターフェースは、デスクトップアプリ自身の実行ファイルに組み込まれています。`openscreen record`、`captions`、`export`、`pack`、`info`、`sources`、`mcp` はウィンドウを開かずにターミナルから実行でき、`--json` を付けると出力が stdout への NDJSON になります。スクリプト、CI ジョブ、コーディングエージェントは、テイクを録画し、`.openscreen` プロジェクトをただの JSON として編集し、エディターの**エクスポート**ボタンと同じネイティブコンポジターで MP4 や GIF をレンダリングできます。
これはサーバー向けのツールではありません。どのコマンドも Electron を起動するため、ウィンドウは表示されなくてもディスプレイサーバーが必要です。また、録画には実際のデスクトップセッションが必要です。[CLI が適さない場合](#when-the-cli-is-not-the-right-tool)を参照してください。
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- プロジェクトの画面動画には、音声トラックが必要です(たとえば `record --mic` で録音したもの)。
- 字幕はエクスポートに焼き込まれます。字幕ファイルは出力されません。[字幕と文字起こし](./captions.md)を参照してください。
+### `openscreen mcp` {#openscreen-mcp}
+
+OpenScreen の MCP ツールを、これを起動するコーディングエージェントに stdin と stdout で提供します。編集ツールに加えて、録画、エクスポート、静止フレームのツールです。自分で実行するものではありません。[エージェントに動画全体を作らせる](./ai-editing.md#letting-an-agent-make-the-whole-video)のとおりに設定すると、エージェントが実行します。
+
### `openscreen pack` {#openscreen-pack}
プロジェクトと、それが参照するすべてのファイル(画面動画、ウェブカメラの動画、カーソルテレメトリ)をひとつのフォルダーにコピーし、コピーしたプロジェクト内のメディアのパスを書き換えます。
@@ -297,5 +301,6 @@ CLI は [OpenScreen のリポジトリ](https://github.com/getopenscreen/openscr
- `electron/cli/args.ts`:引数パーサーと使い方のテキスト。`args.test.ts` で単体テストされています。
- `electron/cli/cliMain.ts`:ウィンドウなしの起動処理、stdio のプロトコル、停止シグナル、終了コード。
- `electron/cli/projectCommands.ts`:`pack` と `info`。
+- `electron/mcp/stdio-server.ts` と `electron/mcp/media-tools.ts`:`mcp`。
- `src/cli/`:`record`、`sources`、`export`、`captions` を非表示のウィンドウで実行するランナー。
- `src/lib/cliContracts.ts`:両側で共有するリクエストと結果の型。
diff --git a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md
index be340945c..1872c4e01 100644
--- a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ A opção **Cortes inteligentes** (marcada *Com IA*) no menu de melhoria automá
## O que mais usa o seu provedor {#what-else-uses-your-provider}
A [tradução de legendas](./captions.md#translation) é uma única chamada de transformação de texto ao mesmo modelo — ela não roda o loop do agente e não pode mexer no seu documento. A transcrição e a renderização das legendas continuam inteiramente no seu computador em qualquer caso.
+
+## Como usar o Claude Code, o Codex ou outro cliente MCP {#using-claude-code-codex-or-another-mcp-client}
+
+Se você já usa um agente de código com IA, como o Claude Code ou o Codex, ele pode conduzir as mesmas ferramentas de edição, conectado com a própria conta. Nada dessa conta passa pelo OpenScreen.
+
+1. **Configurações de IA** → **Servidor MCP** → ative-o. Ele só escuta no seu próprio computador (`127.0.0.1`), na porta exibida.
+2. Copie o comando do **Claude Code** ou do **Codex** exibido ali e execute-o em um terminal. O comando do Claude Code leva o token de acesso. Já o Codex o lê da variável de ambiente `OPENSCREEN_MCP_TOKEN`: defina-a no shell a partir do qual você inicia o Codex.
+3. Mantenha um projeto aberto no editor do OpenScreen e depois peça a edição ao seu agente.
+
+As ferramentas são as que o agente integrado usa, e elas agem sobre o projeto aberto no editor. Os clientes MCP só podem **ler** o projeto até você também ativar **Edições do projeto** na seção Servidor MCP; esse interruptor é separado do interruptor do agente integrado e começa desativado. Depois de ativado, cada edição é salva assim que é aplicada e se desfaz com `Ctrl/Cmd + Z`. Os clientes são instruídos a salvar um ponto de restauração antes de uma série de edições, então você pode pedir a eles que deixem o projeto como estava em um único passo, que o próprio `Ctrl/Cmd + Z` pode desfazer. **Gerar novo** token desconecta todos os clientes configurados com o antigo.
+
+## Como deixar um agente fazer o vídeo inteiro {#letting-an-agent-make-the-whole-video}
+
+O servidor acima edita projetos. Para que um agente faça um vídeo inteiro sozinho, da gravação à exportação, adicione, em vez disso, o OpenScreen ao agente como servidor stdio: o agente inicia o próprio executável do app com `mcp`. Ele recebe as mesmas ferramentas de edição, mais `listSources`, `startRecording`, `stopRecording`, `setPointerTrack`, `exportVideo` e `getFrames`.
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+O executável de cada sistema está listado em [Como executar a CLI](./cli.md#running-the-cli).
+
+- **Sem porta, sem token, sem configuração.** O agente inicia o processo por conta própria, com as suas permissões, como faria ao rodar `openscreen record`. Por isso ele pode gravar a sua tela e editar sem o interruptor **Edições do projeto**.
+- **Cada tomada vira um novo projeto** na sua lista de projetos, com um zoom em cada clique gravado, como uma gravação feita no app. Não o edite no editor enquanto o agente ainda estiver trabalhando nele: o editor mantém a própria cópia.
+- **Uma tomada conduzida por um script** (o Playwright, por exemplo) nunca move o ponteiro da tela. O agente passa ao OpenScreen o próprio registro das ações com `setPointerTrack`, e o vídeo ganha um cursor e seus zooms do mesmo jeito.
+- **A skill `openscreen-demo`** ensina a um agente o trabalho inteiro, do storyboard até um post no X que ele só publica depois que você disser sim. Adicione-a com `npx skills add getopenscreen/openscreen --skill openscreen-demo`. A receita é [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/cli.md
index d4a7560fc..64847aee5 100644
--- a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# CLI de gravação de tela
-A interface de linha de comando do OpenScreen vem embutida no próprio executável do app para desktop. `openscreen record`, `captions`, `export`, `pack`, `info` e `sources` rodam em um terminal sem abrir nenhuma janela, e `--json` transforma a saída deles em NDJSON no stdout. Um script, um job de CI ou um agente de código pode gravar uma tomada, editar o projeto `.openscreen` como JSON puro e renderizar um MP4 ou GIF com o mesmo compositor nativo do botão **Exportar** do editor.
+A interface de linha de comando do OpenScreen vem embutida no próprio executável do app para desktop. `openscreen record`, `captions`, `export`, `pack`, `info`, `sources` e `mcp` rodam em um terminal sem abrir nenhuma janela, e `--json` transforma a saída deles em NDJSON no stdout. Um script, um job de CI ou um agente de código pode gravar uma tomada, editar o projeto `.openscreen` como JSON puro e renderizar um MP4 ou GIF com o mesmo compositor nativo do botão **Exportar** do editor.
Não é uma ferramenta de servidor. Todo comando inicia o Electron, que precisa de um servidor de exibição mesmo que nenhuma janela apareça, e a gravação precisa de uma sessão de desktop real. Veja [Quando a CLI não é a ferramenta certa](#when-the-cli-is-not-the-right-tool).
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- O vídeo de tela do projeto precisa ter uma faixa de áudio, por exemplo de `record --mic`.
- As legendas são embutidas na exportação. Não há saída em arquivo de legenda. Veja [Legendas](./captions.md).
+### `openscreen mcp` {#openscreen-mcp}
+
+Disponibiliza as ferramentas MCP do OpenScreen no stdin e no stdout, para um agente de código que o inicia: as ferramentas de edição, mais a gravação, a exportação e os quadros estáticos. Você não o executa por conta própria; quem executa é o seu agente, depois de configurado como mostra [Como deixar um agente fazer o vídeo inteiro](./ai-editing.md#letting-an-agent-make-the-whole-video).
+
### `openscreen pack` {#openscreen-pack}
Copia um projeto e tudo o que ele referencia (vídeo da tela, vídeo da webcam, telemetria do cursor) para uma única pasta e reescreve os caminhos de mídia no projeto copiado.
@@ -297,5 +301,6 @@ A CLI faz parte do [repositório do OpenScreen](https://github.com/getopenscreen
- `electron/cli/args.ts`: o parser de argumentos e o texto de uso, com testes unitários em `args.test.ts`.
- `electron/cli/cliMain.ts`: a inicialização sem janela, o protocolo de stdio, os sinais de parada e os códigos de saída.
- `electron/cli/projectCommands.ts`: `pack` e `info`.
+- `electron/mcp/stdio-server.ts` e `electron/mcp/media-tools.ts`: `mcp`.
- `src/cli/`: os executores em janela oculta de `record`, `sources`, `export` e `captions`.
- `src/lib/cliContracts.ts`: os tipos de requisição e de resultado compartilhados pelos dois lados.
diff --git a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md
index 9a80d8cf7..ca3d06673 100644
--- a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ ChatGPT 和 GitHub Copilot 登录选项已**在 1.8.0 中移除**。它们的工
## 还有哪些功能会用到你的提供方 {#what-else-uses-your-provider}
[字幕翻译](./captions.md#translation)是对同一模型发起的单次文本转换调用:它不运行 AI 代理循环,也无法改动你的文档。无论哪种情况,转录和字幕渲染都完全在本机进行。
+
+## 使用 Claude Code、Codex 或其他 MCP 客户端 {#using-claude-code-codex-or-another-mcp-client}
+
+如果你已经在使用 Claude Code 或 Codex 等 AI 编程代理,它可以用自己的账号登录,驱动同样的编辑工具。该账号的任何信息都不会经过 OpenScreen。
+
+1. **AI 设置** → **MCP 服务器** → 将其开启。它只在你自己的电脑(`127.0.0.1`)上、在显示的端口上监听。
+2. 复制那里显示的 **Claude Code** 或 **Codex** 命令,并在终端中运行。Claude Code 命令中带有访问令牌。Codex 则改为从 `OPENSCREEN_MCP_TOKEN` 环境变量读取令牌:请在启动 Codex 的终端中设置它。
+3. 在 OpenScreen 编辑器中保持一个项目处于打开状态,然后让你的 AI 代理进行编辑。
+
+这些工具就是内置 AI 代理所使用的工具,它们作用于编辑器中打开的项目。在你同时开启 MCP 服务器部分中的**项目编辑**之前,MCP 客户端只能**读取**项目;这个开关独立于内置 AI 代理的开关,默认处于关闭状态。开启后,每项编辑都会在生效时立即保存,并可用 `Ctrl/Cmd + Z` 撤销。客户端会被要求在进行一系列编辑之前保存一个检查点,因此你可以让它们一步把项目恢复原样,而这一步本身也可以用 `Ctrl/Cmd + Z` 撤销。**重新生成**令牌,即可断开所有使用旧令牌配置的客户端。
+
+## 让 AI 代理制作整段视频 {#letting-an-agent-make-the-whole-video}
+
+上面的服务器用于编辑项目。若要让 AI 代理从录制到导出独立完成一整段视频,请改为把 OpenScreen 作为 stdio 服务器添加到 AI 代理中:AI 代理会用 `mcp` 启动应用自身的可执行文件。它能使用同样的编辑工具,另外还有 `listSources`、`startRecording`、`stopRecording`、`setPointerTrack`、`exportVideo` 和 `getFrames`。
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+各系统上的可执行文件列在[运行 CLI](./cli.md#running-the-cli)中。
+
+- **无需端口、令牌或设置**。AI 代理以你的权限自行启动进程,就像它运行 `openscreen record` 一样。因此,它无需**项目编辑**开关,就能录制你的屏幕并进行编辑。
+- **每次录制都会成为一个新项目**,出现在你的项目列表中,并且与在应用中录制的内容一样,在每次录制下来的点击处添加缩放。在 AI 代理仍在处理它时,不要在编辑器中编辑它:编辑器会保留自己的副本。
+- **由脚本驱动的录制**(例如 Playwright)永远不会移动屏幕指针。AI 代理通过 `setPointerTrack` 把它自己的操作日志交给 OpenScreen,视频照样会有光标及其缩放。
+- **`openscreen-demo` 技能**会教 AI 代理完成整个工作,从分镜脚本到 X 上的帖子,而且只有在你同意之后,它才会发布这条帖子。使用 `npx skills add getopenscreen/openscreen --skill openscreen-demo` 添加它。具体步骤见 [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md)。
diff --git a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/cli.md
index 55e19fe40..41f5fc824 100644
--- a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# 录屏 CLI
-OpenScreen 的命令行界面内置在桌面应用自身的可执行文件中。`openscreen record`、`captions`、`export`、`pack`、`info` 和 `sources` 可以在终端中运行,而不会打开窗口;`--json` 会把它们的输出变成 stdout 上的 NDJSON。脚本、CI 任务或 AI 编程代理可以录制一段内容,把 `.openscreen` 项目当作普通 JSON 来编辑,再用与编辑器**导出**按钮相同的原生合成器渲染出 MP4 或 GIF。
+OpenScreen 的命令行界面内置在桌面应用自身的可执行文件中。`openscreen record`、`captions`、`export`、`pack`、`info`、`sources` 和 `mcp` 可以在终端中运行,而不会打开窗口;`--json` 会把它们的输出变成 stdout 上的 NDJSON。脚本、CI 任务或 AI 编程代理可以录制一段内容,把 `.openscreen` 项目当作普通 JSON 来编辑,再用与编辑器**导出**按钮相同的原生合成器渲染出 MP4 或 GIF。
它不是服务器工具。每条命令都会启动 Electron,即使不显示窗口,Electron 也需要显示服务器;录制则需要真实的桌面会话。请参阅[什么情况下不适合使用 CLI](#when-the-cli-is-not-the-right-tool)。
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- 项目的屏幕视频必须带有音轨,例如由 `record --mic` 录制的视频。
- 字幕会烧录进导出的视频中,不会输出字幕文件。请参阅[字幕](./captions.md)。
+### `openscreen mcp` {#openscreen-mcp}
+
+通过 stdin 和 stdout 提供 OpenScreen 的 MCP 工具,供启动它的 AI 编程代理使用:包括编辑工具,以及录制、导出和静态帧工具。你不需要亲自运行它;按照[让 AI 代理制作整段视频](./ai-editing.md#letting-an-agent-make-the-whole-video)中的说明设置好之后,由你的 AI 代理来运行。
+
### `openscreen pack` {#openscreen-pack}
把项目及其引用的所有内容(屏幕视频、摄像头视频、光标遥测数据)复制到同一个文件夹中,并改写复制出的项目中的媒体路径。
@@ -297,5 +301,6 @@ CLI 是 [OpenScreen 仓库](https://github.com/getopenscreen/openscreen)的一
- `electron/cli/args.ts`:参数解析器和用法说明文本,单元测试位于 `args.test.ts`。
- `electron/cli/cliMain.ts`:无窗口启动、stdio 协议、停止信号和退出码。
- `electron/cli/projectCommands.ts`:`pack` 和 `info`。
+- `electron/mcp/stdio-server.ts` 和 `electron/mcp/media-tools.ts`:`mcp`。
- `src/cli/`:`record`、`sources`、`export` 和 `captions` 的隐藏窗口运行器。
- `src/lib/cliContracts.ts`:两端共用的请求和结果类型。
diff --git a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md
index 09692a52e..9ac2e5153 100644
--- a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -58,3 +58,29 @@ ChatGPT 與 GitHub Copilot 的登入選項已**在 1.8.0 中移除**。它們的
## 還有哪些功能會使用你的提供者 {#what-else-uses-your-provider}
[字幕翻譯](./captions.md#translation)是對同一個模型發出的單次文字轉換呼叫:它不會執行代理的循環,也無法更動你的文件。無論如何,轉錄與字幕算繪都完全在你的裝置上進行。
+
+## 使用 Claude Code、Codex 或其他 MCP 用戶端 {#using-claude-code-codex-or-another-mcp-client}
+
+如果你已經在使用 Claude Code 或 Codex 等 AI 程式設計代理,它可以用自己的帳號登入,驅動相同的剪輯工具。該帳號的任何資訊都不會經過 OpenScreen。
+
+1. **AI 設定** → **MCP 伺服器** → 將它開啟。它只會在你自己的電腦(`127.0.0.1`)上、於顯示的連接埠監聽。
+2. 複製那裡顯示的 **Claude Code** 或 **Codex** 指令,並在終端機中執行。Claude Code 指令中帶有存取權杖。Codex 則改為從 `OPENSCREEN_MCP_TOKEN` 環境變數讀取權杖:請在啟動 Codex 的終端機中設定它。
+3. 讓專案在 OpenScreen 編輯器中保持開啟,然後請你的代理進行剪輯。
+
+這些工具就是內建代理所使用的工具,作用於編輯器中開啟的專案。在你同時開啟 MCP 伺服器區段中的**專案編輯**之前,MCP 用戶端只能**讀取**專案;這個開關與內建代理的開關各自獨立,預設為關閉。開啟後,每項編輯都會在生效時立即儲存,並可用 `Ctrl/Cmd + Z` 復原。用戶端會被告知在進行一系列編輯之前先儲存檢查點,因此你可以請它們一步將專案還原成原本的樣子,而這一步本身也可以用 `Ctrl/Cmd + Z` 復原。**重新產生**權杖,即可中斷所有使用舊權杖設定的用戶端。
+
+## 讓代理製作整支影片 {#letting-an-agent-make-the-whole-video}
+
+上述伺服器用於剪輯專案。若要讓代理從錄影到匯出自行製作一整支影片,請改為將 OpenScreen 以 stdio 伺服器的形式加入代理:代理會以 `mcp` 啟動應用程式本身的執行檔。它能使用相同的剪輯工具,另外還有 `listSources`、`startRecording`、`stopRecording`、`setPointerTrack`、`exportVideo` 與 `getFrames`。
+
+```bash
+claude mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscreen" mcp
+```
+
+各系統上的執行檔列在[執行 CLI](./cli.md#running-the-cli)中。
+
+- **不需要連接埠、權杖或設定。** 代理會以你的權限自行啟動程序,就像它執行 `openscreen record` 一樣。因此,它不需要**專案編輯**開關,就能錄製你的螢幕並進行剪輯。
+- **每段錄影都會成為一個新專案**,出現在你的專案清單中,並和在應用程式中錄製的影片一樣,在每個錄下的點擊處加上縮放。代理仍在處理時,請不要在編輯器中剪輯它:編輯器會保留自己的副本。
+- **由腳本驅動的錄影**(例如 Playwright)永遠不會移動螢幕上的指標。代理會用 `setPointerTrack` 把它自己的操作記錄交給 OpenScreen,影片照樣會有游標與其縮放。
+- **`openscreen-demo` 技能**會教代理完成整個工作,從分鏡腳本到 X 上的貼文,而且只有在你同意之後,它才會發布這則貼文。使用 `npx skills add getopenscreen/openscreen --skill openscreen-demo` 加入它。完整步驟請見 [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md)。
diff --git a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/cli.md b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/cli.md
index 0579b52dd..b2a13b994 100644
--- a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/cli.md
+++ b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/cli.md
@@ -14,7 +14,7 @@ keywords:
# 螢幕錄影 CLI
-OpenScreen 的命令列介面內建在桌面應用程式本身的執行檔中。`openscreen record`、`captions`、`export`、`pack`、`info` 與 `sources` 可以在終端機中執行,不會開啟任何視窗,而 `--json` 會把它們的輸出轉為 stdout 上的 NDJSON。腳本、CI 工作或程式設計代理可以錄製一段影片、將 `.openscreen` 專案當作一般 JSON 編輯,再用與編輯器**匯出**按鈕相同的原生合成器算繪出 MP4 或 GIF。
+OpenScreen 的命令列介面內建在桌面應用程式本身的執行檔中。`openscreen record`、`captions`、`export`、`pack`、`info`、`sources` 與 `mcp` 可以在終端機中執行,不會開啟任何視窗,而 `--json` 會把它們的輸出轉為 stdout 上的 NDJSON。腳本、CI 工作或程式設計代理可以錄製一段影片、將 `.openscreen` 專案當作一般 JSON 編輯,再用與編輯器**匯出**按鈕相同的原生合成器算繪出 MP4 或 GIF。
它不是伺服器工具。每個指令都會啟動 Electron,即使不會出現任何視窗,Electron 仍然需要顯示伺服器,而錄影則需要真正的桌面工作階段。請參閱[什麼情況下不適合使用 CLI](#when-the-cli-is-not-the-right-tool)。
@@ -163,6 +163,10 @@ openscreen export demo.openscreen -o demo.mp4 # captions are burned into the v
- 專案的螢幕影片必須有音軌,例如用 `record --mic` 錄製的影片。
- 字幕會燒錄進匯出的影片,不會輸出字幕檔。請參閱[字幕](./captions.md)。
+### `openscreen mcp` {#openscreen-mcp}
+
+透過 stdin 與 stdout 提供 OpenScreen 的 MCP 工具,供啟動它的程式設計代理使用:包括剪輯工具,以及錄影、匯出與靜態影格的工具。你不需要自己執行它;依照[讓代理製作整支影片](./ai-editing.md#letting-an-agent-make-the-whole-video)的說明設定好之後,就由你的代理執行。
+
### `openscreen pack` {#openscreen-pack}
將專案及其參照的所有內容(螢幕影片、網路攝影機影片、游標遙測資料)複製到同一個資料夾,並改寫複製後專案中的媒體路徑。
@@ -297,5 +301,6 @@ CLI 是 [OpenScreen 儲存庫](https://github.com/getopenscreen/openscreen)的
- `electron/cli/args.ts`:參數解析器與用法說明文字,單元測試位於 `args.test.ts`。
- `electron/cli/cliMain.ts`:無視窗啟動、stdio 通訊協定、停止訊號與結束代碼。
- `electron/cli/projectCommands.ts`:`pack` 與 `info`。
+- `electron/mcp/stdio-server.ts` 與 `electron/mcp/media-tools.ts`:`mcp`。
- `src/cli/`:`record`、`sources`、`export` 與 `captions` 的隱藏視窗執行器。
- `src/lib/cliContracts.ts`:兩端共用的請求與結果型別。
diff --git a/website/static/llms.txt b/website/static/llms.txt
index 29aaf7d89..72b2c059d 100644
--- a/website/static/llms.txt
+++ b/website/static/llms.txt
@@ -27,6 +27,7 @@ OpenScreen is not the same product as Open Screen at openscreen.io.
- [AI editing](https://getopenscreen.com/docs/ai-editing/): optional chat editing with an LLM key you supply, off by default
- [Export](https://getopenscreen.com/docs/export/): MP4 and GIF settings and encoders
- [CLI](https://getopenscreen.com/docs/cli/): record, caption and export from scripts, CI jobs and coding agents, with NDJSON output
+- [Letting an agent make the whole video](https://getopenscreen.com/docs/ai-editing/#letting-an-agent-make-the-whole-video): `openscreen mcp` gives a coding agent the editing tools plus recording, export and still frames over stdio; the `openscreen-demo` skill (`npx skills add getopenscreen/openscreen --skill openscreen-demo`) teaches it the whole job, up to a post on X that it publishes only after the user's yes
- [How to make a product demo video](https://getopenscreen.com/docs/guides/product-demo-video/): a step-by-step guide from script to export
## Platforms and features