Skip to content
Back to search

cassette-editor

Video editing through the Cassette agent for Claude Code, Codex, OpenCode and Hermes.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cassette-editor--oh-my-cassette/badge.svg)](/listings/cassette-editor--oh-my-cassette)

HTML

<a href="/listings/cassette-editor--oh-my-cassette"><img src="/api/listings/cassette-editor--oh-my-cassette/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need [uv](https://docs.astral.sh/uv/) (it fetches Python and the package on first start) and, to import video into a cloud project, [ffmpeg](https://ffmpeg.org/download.html).

**1. Add Oh My Cassette to your agent.**

# Claude Code
claude plugin marketplace add Cassette-Editor/oh-my-cassette
claude plugin install oh-my-cassette@cassette-editor
# Codex
codex plugin marketplace add https://github.com/Cassette-Editor/oh-my-cassette.git
codex plugin add oh-my-cassette@cassette-editor
# Hermes
hermes mcp add cassette --command uvx --args oh-my-cassette==0.7.4

For OpenCode or any other MCP host, see [Install](#install) below.

**2. Sign in**, whichever host you use:

uvx oh-my-cassette==0.7.4 login

Your browser asks for the code Cassette emails you. Then restart your agent if it cannot refresh its tool list, and say:

> *Start a new Cassette project and import the clips in ./footage, then cut a 30-second travel video with a title at the start.*

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 27 lines
  1. {
  2. "name": "cassette-editor",
  3. "description": "Video editing through the Cassette agent for Claude Code, Codex, OpenCode and Hermes.",
  4. "owner": {
  5. "name": "Oh My Cassette contributors",
  6. "url": "https://github.com/Cassette-Editor/oh-my-cassette"
  7. },
  8. "plugins": [
  9. {
  10. "name": "oh-my-cassette",
  11. "description": "Import local media, drive the Cassette editing agent turn by turn, read the timeline, export.",
  12. "source": {
  13. "source": "github",
  14. "repo": "Cassette-Editor/oh-my-cassette",
  15. "ref": "v0.7.4"
  16. },
  17. "version": "0.7.4",
  18. "category": "productivity",
  19. "tags": [
  20. "video-editing",
  21. "media",
  22. "mcp",
  23. "cassette"
  24. ]
  25. }
  26. ]
  27. }
README.md · README · 318 lines
  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/main/assets/banner.jpg" width="80%" alt="Oh My Cassette" />
  3. </p>
  4. <h1 align="center">Oh My Cassette</h1>
  5. <p align="center">
  6. Edit video by talking to the <a href="https://trycassette.online">Cassette</a> agent from Claude Code, Codex, OpenCode or Hermes.<br />
  7. <sub>A small MCP bridge, installed from PyPI. The editing tools come from the Cassette MCP service, so they stay current without a plugin update.</sub>
  8. </p>
  9. <p align="center">
  10. <a href="https://pypi.org/project/oh-my-cassette/"><img alt="PyPI" src="https://img.shields.io/pypi/v/oh-my-cassette?label=oh-my-cassette" /></a>
  11. <a href="https://github.com/Cassette-Editor/oh-my-cassette/blob/main/LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue" /></a>
  12. <a href="https://discord.gg/qd9NY4k8d7"><img alt="Discord" src="https://img.shields.io/discord/1514649803626250452?logo=discord&logoColor=white&label=Discord&color=5865F2" /></a>
  13. <a href="https://github.com/Cassette-Editor/oh-my-cassette/blob/main/README.zh-cn.md">中文</a>
  14. </p>
  15. ---
  16. <p align="center">
  17. <img src="https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/main/assets/demo-claude-code.gif" width="100%" alt="One Claude Code session: import five 4K films and a song, ask for a 30-second teaser, revise it, export it" />
  18. </p>
  19. **One real Claude Code session, with every prompt shown as it was typed.** Five 4K travel films (10½ minutes of
  20. footage) and a song go in, a two-sentence brief and a one-line revision go to the Cassette agent word for word, and a
  21. 30-second 1080p MP4 lands in `cassette-exports/`. Waits are fast-forwarded: in real time the import took 4½ minutes, the first cut 9½, the revision
  22. 3½ and the export 1.
  23. > *Cut a 30-second teaser for Turkey from these five films, on the beat of Pamgaea.mp3. Open on a hot-air balloon
  24. > lighting up at dawn in Cappadocia, travel from the ancient ruins to the sea, name each place when it first appears,
  25. > and end on the misty lake with the title TURKEY.*
  26. >
  27. > *The ruins part drags. Keep only the two best Ephesus shots, and put the camel right after the balloons.*
  28. <p align="center">
  29. <a href="https://github.com/Cassette-Editor/oh-my-cassette/releases/download/v0.5.0/turkey-teaser.mp4"><img src="https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/main/assets/turkey-teaser.jpg" width="100%" alt="Frames of the teaser it made: the balloon at dawn, the camel, two Ephesus shots, the Datça coast, the misty lake with the title TURKEY" /></a>
  30. <br /><sub><a href="https://github.com/Cassette-Editor/oh-my-cassette/releases/download/v0.5.0/turkey-teaser.mp4">Watch the teaser it made (MP4, 30 s, with sound)</a>. Footage and music credits are <a href="#credits">below</a>.</sub>
  31. </p>
  32. ## Install in 30 seconds
  33. You need [uv](https://docs.astral.sh/uv/) (it fetches Python and the package on first start) and, to import video
  34. into a cloud project, [ffmpeg](https://ffmpeg.org/download.html).
  35. **1. Add Oh My Cassette to your agent.**
  36. ```bash
  37. # Claude Code
  38. claude plugin marketplace add Cassette-Editor/oh-my-cassette
  39. claude plugin install oh-my-cassette@cassette-editor
  40. ```
  41. ```bash
  42. # Codex
  43. codex plugin marketplace add https://github.com/Cassette-Editor/oh-my-cassette.git
  44. codex plugin add oh-my-cassette@cassette-editor
  45. ```
  46. ```bash
  47. # Hermes
  48. hermes mcp add cassette --command uvx --args oh-my-cassette==0.7.4
  49. ```
  50. For OpenCode or any other MCP host, see [Install](#install) below.
  51. **2. Sign in**, whichever host you use:
  52. ```bash
  53. uvx oh-my-cassette==0.7.4 login
  54. ```
  55. Your browser asks for the code Cassette emails you. Then restart your agent if it cannot refresh its tool list, and say:
  56. > *Start a new Cassette project and import the clips in ./footage, then cut a 30-second travel video with a title at the start.*
  57. ## Projects and retention
  58. A new project lives in the cloud unless you place it on one of your Macs; when your account has a Mac running Cassette
  59. for Mac, the service asks which you want.
  60. - **A cloud project** is deleted with its media after three idle days. Every use pushes that back, and each answer says
  61. when it is due (`retention_expires_at`). Exported files are already on your machine in `cassette-exports/` and stay
  62. there.
  63. - **A project held by Cassette for Mac** is kept. The bridge can open, edit, import into and export it while that Mac is
  64. online. When the bridge runs on that Mac, the app reads each file where it is and nothing uploads; from any other
  65. machine each file uploads unchanged, with its embedded metadata, and the cloud copy is deleted once the Mac has it.
  66. [docs/privacy.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/docs/privacy.md) has the details.
  67. ## Overview
  68. Oh My Cassette connects your coding agent to the Cassette editing agent. It is a local stdio MCP server
  69. that relays to the Cassette MCP service (`CASSETTE_MCP_URL`), which in turn calls the Cassette backend:
  70. ```text
  71. Claude Code / Codex / OpenCode / Hermes ──stdio──▶ oh-my-cassette ──HTTP──▶ Cassette MCP service ──▶ Cassette backend
  72. ```
  73. - **The tools are the service's.** Whatever it lists (projects, editing turns, questions, undo,
  74. export) is what your agent sees, with the service's own descriptions and workflow instructions.
  75. When Cassette changes, the tools change with it; the plugin does not need a release.
  76. - **The bridge adds only what needs your machine.** Local files named in a call are sent first (only
  77. from the workspace, media types only). For a cloud project they are prepared here: video is
  78. transcoded with ffmpeg into the renditions the service declares, and audio or images the service
  79. cannot take as they are get converted. For a project a Mac holds they go as they are (see
  80. [Projects and retention](#projects-and-retention)). Each file uploads while the next one is prepared, in parts, four transfers at a time; a file whose
  81. upload was interrupted picks up its earlier import when you import it again.
  82. Exported files are downloaded into `cassette-exports/`. The workspace identity travels with each
  83. call so the service can remember a project per directory.
  84. - **Long work never times out the host.** Every call waits a bounded time; slow local preparation
  85. answers `preparing` and keeps going in the background, and the next identical call picks it up. An
  86. export download that outlasts the wait goes on in the background too, and the answer says where the
  87. file will appear.
  88. - **It survives deploys.** It reconnects on its own, retries a call that carries a request id when
  89. the connection drops or the service turns it away, resumes interrupted downloads, reports `bridge.*`
  90. errors with a `retryable` flag (and `retry_after_seconds` when the service said when), and, while
  91. the service is unreachable or refuses the token, lists a single `cassette_bridge_status` tool that
  92. says why.
  93. The rules between the plugin and the service are defined in
  94. [`src/oh_my_cassette/contract.py`](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/src/oh_my_cassette/contract.py); `oh-my-cassette check` verifies a
  95. service against them.
  96. ## Requirements
  97. - An invited Cassette account. While the service is unreachable or refuses your sign-in, the only tool
  98. listed is `cassette_bridge_status`, which says why.
  99. - [uv](https://docs.astral.sh/uv/getting-started/installation/) 0.5 or newer. `uvx oh-my-cassette==0.7.4` resolves Python 3.11 or newer by itself.
  100. - [ffmpeg](https://ffmpeg.org/download.html) (with ffprobe) to import video into a cloud project:
  101. `brew install ffmpeg`, `sudo apt install ffmpeg` or `winget install ffmpeg`. Video is transcoded on
  102. your machine before it uploads, and a build with `zscale` also tone-maps HDR footage properly. A
  103. project held by Cassette for Mac does not need it.
  104. The service declares which file types each tool accepts and how they are prepared; the bridge sends
  105. only video, audio and images unless you set `CASSETTE_UPLOAD_ANY_TYPE`.
  106. ## Configuration
  107. Sign in once with `oh-my-cassette login`, using the Cassette account that holds your projects; the browser asks for the emailed code and your consent. One sign-in reaches every project of the account, whether it was made on the web or in Cassette for Mac. `login`, `status` and `logout` keep the credentials in your operating-system keyring, so no token needs to be copied. The environment variables below are optional overrides.
  108. | Variable | Default | Meaning |
  109. | --- | --- | --- |
  110. | `CASSETTE_MCP_URL` | the saved connection, otherwise `https://mcp.trycassette.online/mcp` | Explicit MCP endpoint override. |
  111. | `CASSETTE_AUTH_TOKEN` | unset | Advanced bearer-token override. Normally use `login`; the same account, scope and resource checks apply. Never place it in shared configuration. |
  112. | `CASSETTE_WORKSPACE` | the directory the host starts the server in | Where relative paths resolve, where local files may come from, and the directory the service may remember a project for. A host that starts the server in the whole disk or your home folder gives it no files to read until you set this, or `CASSETTE_ALLOWED_ROOTS`. |
  113. | `CASSETTE_ALLOWED_ROOTS` | unset | Extra directories local files may come from (`:`-separated; `;` on Windows). |
  114. | `CASSETTE_DOWNLOAD_DIR` | `<workspace>/cassette-exports` | Where exported files are saved. The default must stay inside the workspace: a `cassette-exports` symlink leading elsewhere is refused. |
  115. | `CASSETTE_MAX_UPLOAD_MB` / `CASSETTE_MAX_DOWNLOAD_MB` | `4096` / `16384` | Size limits per file. |
  116. | `CASSETTE_UPLOAD_ANY_TYPE` | off | Allow non-media uploads when a tool accepts them. |
  117. | `CASSETTE_LOCAL_WAIT_SEC` | `240` | How long one call waits for local preparation and upload before it answers `preparing`. |
  118. | `CASSETTE_FFMPEG` / `CASSETTE_FFPROBE` | from `PATH` | The ffmpeg and ffprobe programs used to prepare local media. |
  119. | `CASSETTE_TEMP_DIR` | the system temp directory | Where each upload makes its own private directory (`oh-my-cassette-job-*`) for prepared files until they are uploaded. |
  120. | `CASSETTE_CONNECT_TIMEOUT_SEC` | `10` | How long to wait for the service when connecting. |
  121. | `CASSETTE_MCP_HOST` | unset | The host name sent to the service when the host does not identify itself. |
  122. | `CASSETTE_AUTH_DIRECTORY` | `~/.config/oh-my-cassette` | Where the saved connection's settings are kept (the token and your own OpenAI key stay in the keyring). |
  123. | `OH_MY_CASSETTE_LOG` | `WARNING` | Log level on stderr. |
  124. ### Your own OpenAI key
  125. An account can pay for its Cassette agent turns with its own OpenAI key instead of Cassette's. Save it once, after `login`:
  126. ```bash
  127. uvx oh-my-cassette==0.7.4 key set # prompts for the key (sk-…) without echoing it
  128. uvx oh-my-cassette==0.7.4 key status # shows whether one is saved, and its fingerprint
  129. uvx oh-my-cassette==0.7.4 key remove
  130. ```
  131. The key stays in your operating-system keyring (service `oh-my-cassette.provider-key`), kept for the account you signed in with, and is never written to a file. The bridge sends it in the `x-cassette-provider-key` header on its requests to the Cassette MCP service only; the service hands it to Cassette, which holds it in memory while your turns need it and switches the account to its own key. `key remove` first has Cassette let go of the key it holds at once, then forgets it here; the account stays on its own key, so its turns wait for one until you set a key again. Switch back to Cassette's key in Cassette settings. A turn that waits for a key Cassette does not hold answers `needs_credential`; save the key and continue the turn. With `CASSETTE_AUTH_TOKEN` set, no key is sent. `status` shows the fingerprint Cassette shows: the first 8 hex digits of the key's SHA-256 and its last four characters.
  132. ## Install
  133. ### Claude Code
  134. Plugin (recommended): the two commands at the top. The plugin uses the connection saved by `oh-my-cassette login` and starts `uvx oh-my-cassette==0.7.4` with a 10-minute tool timeout.
  135. Project scope without the plugin: copy [`.mcp.json`](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/.mcp.json) into your project, or run:
  136. ```bash
  137. claude mcp add --transport stdio cassette -- uvx oh-my-cassette==0.7.4
  138. ```
  139. The skill lives in [`skills/cassette-video-edit/SKILL.md`](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/skills/cassette-video-edit/SKILL.md) and ships with the plugin.
  140. ### Codex
  141. Plugin: the two commands at the top ([`.codex-plugin/plugin.json`](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/.codex-plugin/plugin.json) declares the server inline with `tool_timeout_sec: 600` and passes the `CASSETTE_*` variables through from your shell). Or add the server directly:
  142. ```bash
  143. codex mcp add cassette -- uvx oh-my-cassette==0.7.4
  144. ```
  145. ### OpenCode
  146. Add to `opencode.json` (project or `~/.config/opencode/opencode.json`):
  147. ```json
  148. {
  149. "mcp": {
  150. "cassette": {
  151. "type": "local",
  152. "command": ["uvx", "oh-my-cassette==0.7.4"],
  153. "timeout": 600000
  154. }
  155. }
  156. }
  157. ```
  158. Then copy the skill so OpenCode loads it:
  159. ```bash
  160. mkdir -p ~/.config/opencode/skills/cassette-video-edit
  161. curl -fsSL https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/v0.7.4/skills/cassette-video-edit/SKILL.md \
  162. -o ~/.config/opencode/skills/cassette-video-edit/SKILL.md
  163. ```
  164. OpenCode has no MCP elicitation, which is fine: the editing agent's questions come back as ordinary tool results, and the service's tools say how to answer them.
  165. ### Hermes
  166. ```bash
  167. hermes mcp add cassette --command uvx --args oh-my-cassette==0.7.4
  168. mkdir -p ~/.hermes/skills/cassette-video-edit
  169. curl -fsSL https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/v0.7.4/skills/cassette-video-edit/SKILL.md \
  170. -o ~/.hermes/skills/cassette-video-edit/SKILL.md
  171. ```
  172. Set `mcp_servers.cassette.timeout: 600` in `~/.hermes/config.yaml` so a call's bounded waits fit. Hermes is a plain MCP host here: the 0.4 gateway/plugin layer is gone.
  173. ### Any other MCP host
  174. Command `uvx`, args `["oh-my-cassette==0.7.4"]`, stdio transport, a tool timeout of 10 minutes, and the environment variables above. No uv? `pipx run oh-my-cassette==0.7.4` works too.
  175. ## How a turn looks
  176. ```text
  177. you: Import intro.mp4 and beach.mov, then make a 20-second cut with the title "Kota Kinabalu".
  178. agent: (calls the service's import tool with ["intro.mp4", "beach.mov"])
  179. bridge: transcodes both videos, uploads them, passes the service media references
  180. (calls the service's editing tool with your sentence, verbatim; progress streams while it runs)
  181. "Done. Added a 20 s cut from both clips with the title at the start. Open it: <editor link>"
  182. you: Export it.
  183. agent: (calls the service's export tool)
  184. bridge: downloads the MP4 to cassette-exports/kota-kinabalu.mp4
  185. ```
  186. The editor link comes from the service: open it in a browser to watch the run live and take over by hand.
  187. ## Check a service
  188. ```bash
  189. uvx oh-my-cassette==0.7.4 check --url http://127.0.0.1:8790/mcp --upload \
  190. --arguments '{"project_id": "<a test project>"}'
  191. ```
  192. Prints one line per check (transport and token, contract declaration, instructions, tool schemas,
  193. local-file and `prepare` declarations, and with `--upload` a real upload round trip; `--arguments`
  194. are the file tool's other arguments for it) and exits 1 on any failure. `--json` gives
  195. machine-readable output for the service's CI. The service must speak MCP 2026-07-28; one that only
  196. answers the handshake-era `initialize` fails the transport check, and the bridge refuses it with
  197. `bridge.protocol_unsupported`.
  198. ## Upgrading from 0.4
  199. 0.5 is a rewrite. The 0.4 plugin carried its own editing runtime, music search and Hermes gateway; 0.5 is a thin bridge
  200. to the Cassette MCP service, and the tools your agent sees are the service's.
  201. - **Sign in again** with `uvx oh-my-cassette==0.7.4 login`. 0.4 passwords and tokens are not used.
  202. - **Tools are new.** Projects, editing turns, questions, plans, undo, media, analysis and export come from the service,
  203. with their own descriptions; the 0.4 tool names (`cassette_run_job`, `cassette_ingest_media`, `cassette_match_bgm`, …)
  204. are gone. Reinstall the plugin, or point your host config at `uvx oh-my-cassette==0.7.4`.
  205. - **Projects live in your Cassette account**, the same ones you open on the web or in Cassette for Mac, and the editor
  206. link each answer carries opens the project you are working on. 0.4 sessions do not carry over.
  207. - **Hermes** is a plain MCP host now; remove the 0.4 gateway plugin.
  208. ## Update
  209. Bump the pin in your host config (`oh-my-cassette==<new version>`) or reinstall the plugin; `uvx` fetches the new wheel on next start. Releases: [CHANGELOG.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/CHANGELOG.md).
  210. ## Development
  211. ```bash
  212. git clone https://github.com/Cassette-Editor/oh-my-cassette && cd oh-my-cassette
  213. uv sync --group dev
  214. uv run pytest -q # reference service on loopback, no network; ffmpeg tests skip without it
  215. uv run oh-my-cassette # the bridge itself (stdio)
  216. uv run oh-my-cassette check --url <endpoint> # conformance check
  217. ```
  218. `tests/reference_remote.py` is an executable reference service for the contract;
  219. [RELEASING.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/RELEASING.md) has the PyPI release flow.
  220. ## Credits
  221. The demo footage is by [yasin ilcebay](https://vimeo.com/yasinilcebay), licensed
  222. [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/), from Wikimedia Commons:
  223. [Aizanoi Temple of Zeus](https://commons.wikimedia.org/wiki/File:Aizonai_Temple_of_Zeus_(4K)_-_TURKEY.webm),
  224. [Cappadocia](https://commons.wikimedia.org/wiki/File:Cappadocia_4K_-_TURKEY.webm),
  225. [Datça](https://commons.wikimedia.org/wiki/File:Dat%C3%A7a_-_TURKEY_4K.webm),
  226. [Ephesus](https://commons.wikimedia.org/wiki/File:Ephesus_Ancient_City_-_Celsus_Library_4K.webm) and
  227. [Gölcük Lake](https://commons.wikimedia.org/wiki/File:G%C3%B6lc%C3%BCk_Natural_Park_4K_-_Turkey.webm). The teaser
  228. trims and reorders it, and adds place names, a title and music.
  229. The music is "Pamgaea" by Kevin MacLeod (incompetech.com)<br />
  230. Licensed under Creative Commons: By Attribution 4.0<br />
  231. https://creativecommons.org/licenses/by/4.0/<br />
  232. The teaser uses an excerpt of it.
  233. ## License
  234. The code is MIT. Oh My Cassette is the client; the Cassette service has its own terms.
  235. The demo recording (`assets/demo-claude-code.gif`), the teaser frames (`assets/turkey-teaser.jpg`)
  236. and the teaser video attached to the release contain the works credited above. They are not covered
  237. by the MIT license and remain under their own licenses (CC BY 3.0 for the footage, CC BY 4.0 for
  238. the music).
  239. <sub>MCP registry: `mcp-name: io.github.Cassette-Editor/oh-my-cassette`</sub>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.