[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_128":129},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93},"apiUrl","https://odel.app/api","creator","cassette-editor","moduleId","oh-my-cassette","@cassette-editor/oh-my-cassette","displayName","Oh My Cassette","tagline","Chat-driven AI video montage: beat-synced cuts, auto-matched music, subtitles, transitions.","iconKey","https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/main/assets/logo-400.png","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1785212619000,"updatedAt",1788409966000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Cassette-Editor%2Foh-my-cassette","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",131,"upstreamUpdatedAt",1788398705000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/Cassette-Editor/oh-my-cassette","githubRepoFullName","Cassette-Editor/oh-my-cassette","releaseId","ext-cassette-editor-oh-my-cassette","version","0.4.19","descriptionMarkdown","

\n $\"Oh$ \n

\n\n

\nOh My Cassette: Chat Your Raw Clips Into a Finished Cut\n

\n\n

\n \n $\"Version\"$ \n \n \n $\"License\"$ \n \n \n $\"Stars\"$ \n \n \n $\"Forks\"$ \n \n $\"Python\"$ \n \n $\"CI\"$ \n \n \n $\"Cassette$ \n \n \n $\"Hermes$ \n \n \n $\"Codex$ \n \n \n $\"Claude$ \n \n \n $\"OpenCode$ \n \n \n $\"Discord\"$ \n \n \n $\"oh-my-cassette$ \n \n

\n\n

\n 简体中文 | English\n

\n\n\n\n\n\n

\n\n

\n \n Point Claude Code, Codex, or Hermes at a folder of raw clips.
\n Describe the video you want. Get back a finished, beat-synced cut.\n \n

\n\n

\n 14 clips in. One prompt. ~13 minutes to a rendered file.
\n _{No timeline. No editing software. No GPU.}\n

\n\n## ⚡ Install in 30 seconds\n\n```bash\n# Claude Code\nclaude plugin marketplace add Cassette-Editor/oh-my-cassette\nclaude plugin install oh-my-cassette@cassette-editor\n```\n\n```bash\n# Codex\ncodex plugin marketplace add https://github.com/Cassette-Editor/oh-my-cassette.git\ncodex plugin add oh-my-cassette@cassette-editor\n```\n\nRestart your agent, then say: *\"Edit the clips in ./footage into a 30-second travel vlog with beat-synced cuts.\"*\n\nWant to try the workflow before installing? Open the [public web demo](https://trycassette.online/agent-demo).\n\nNeeds Python 3.11–3.13, `ffmpeg`, and a [Cassette account](https://trycassette.online/signup/). Full setup — including [OpenCode](#opencode), [Hermes](#hermes), and any other MCP host — is in [Quick Start](#-quick-start).\n\n# 🎥 Overview\n\n**Oh My Cassette** is an open-source AI video editing plugin and local MCP server for [Claude Code](https://claude.com/claude-code), [Codex](https://github.com/openai/codex), [Hermes Agent](https://github.com/nousresearch/hermes-agent), and [OpenCode](https://opencode.ai). It turns natural-language chat into finished montage videos on [Cassette](https://trycassette.online) — beat-synced cuts, auto-matched music, subtitles, transitions, and picture-in-picture — with minimal token overhead.\n\nThe agent does the parts that make editing tedious: it watches every clip, picks the shots, plans the cut, syncs it to the beat, and renders — while you stay in chat. Because it runs through your agent, you can do all of it from your phone.\n\n\n \n \n \n \n \n

💬 Chat-to-Edit

Describe the video in plain language — the agent handles shot selection, pacing, and the timeline, so you never open an editor.

🎵 Smart Music Matching

Finds and syncs music to the mood and rhythm of your footage, so the cut lands on the beat without you marking a single one.

👀 Nothing Renders Until You Say So

Every turn returns a timeline digest and a contact sheet you can review in seconds — you approve the plan before a frame is rendered.

\n\n## 🖥️ How it works\n\nUpload your clips, describe the video you want, and the agent edits it.\n\n\n\n

\n\n| Time | What happens |\n| --- | --- |\n| 0:09 | The brief — one line, style left entirely to the agent, typed into Claude Code |\n| 0:22 | 15 files upload to Cassette; every clip is analyzed for scene content |\n| 0:35 | The agent edits on its own — shot selection, title card, lower-third, grading, beat-synced cuts |\n| 0:58 | The timeline comes back as a readable digest, with a clickable contact-sheet link |\n| 1:03 | One `cmd+click` opens the real contact sheet — one frame per clip, zero render |\n| 1:12 | The contact sheet itself: what the cut looks like before a single frame is rendered |\n| 1:44 | The export lands, and the runtime measures it — duration, black frames, audio levels |\n| 1:52 | The finished cut |\n\n**The cut it produced**\n\n\n\n

\n\n_{The screen recording is compressed to keep this page light, so the terminal text looks softer here than it does on your machine; the cut below it is the full-quality render. Prompt to rendered file took 9 minutes 53 seconds of real time, sped up above. A person's face is pixelated in both the screen recording and the cut it produced, for privacy — that blur is not something the agent added.}\n\n_{**Token cost:** that session used 55K output tokens and 2.33M billed input tokens (2.07M of them cache reads) on Claude Opus 5 — roughly **$4 at API list price**, measured from the Claude Code transcript of this exact recording. One brief, one turn, start to exported file. The editing itself runs on Cassette, so the agent only pays for the brief and the timeline digests, not for the footage.}\n\n## 🎬 Case Videos\n\nEvery case below was edited end-to-end by an AI agent through Oh My Cassette, from the exact prompt shown — real inputs, real processing times, and the output is what the agent delivered.\n\n\n\n\n\n\n\n

Travel Vlog

\n _{🎞️ Input: 13 video clips · 1 audio track}
\n _{⏱️ Processing Time: 15 mins}\n

Prompt
\n Edit a 30-second travel vlog using all materials with a clear viewing flow. Add the title subtitle \"KOTA KINABALU\" at the beginning and end. Include the vlog shooting time, overlay the character video onto similar scenic shots as a picture-in-picture effect, keep the rhythm light and memorable, and use hard cuts plus music beat sync for a fresh vacation feeling.

Travel Vlog Beat Sync PiP

Cooking Tutorial

\n _{🎞️ Input: 12 video clips · 1 audio track}
\n _{⏱️ Processing Time: 8 mins}\n

Prompt
\n Use these materials to edit a cooking video for stir-fried pork with green peppers. Keep the steps smooth, preserve the cooking sounds, and add simple subtitles. The subtitles can be generated based on the visuals to help viewers understand each step. Keep the style clean and natural without covering the ingredients.

Food Tutorial Explainer

Commercial

\n _{🎞️ Input: 15 video clips · 15 sound effects · 1 audio track}
\n _{⏱️ Processing Time: 13 mins}\n

Prompt
\n Use these materials to edit a 15-second product commercial. Start with opening the bottle cap, add bubbles, water splashes, ice cubes, and product details in the middle, and end with the full product and brand. Keep it refreshing, thirst-quenching, and ad-like.

Product Short Commercial

\n\n

\n → See all six cases — daily vlog, cinematic short, and game highlights, each with its exact prompt.
\n _{★ More cases are on the way. Star the project to follow along.}\n

\n\n# 🚀 Quick Start\n\n## Before You Start 🎬\n\nOh My Cassette connects Codex, Claude, or Hermes to the Cassette Agent. You need:\n\n* Codex, Claude Code, or a working Hermes Agent installation.\n* A Cassette account.\n* For Hermes only, a configured gateway such as QQ or Telegram.\n\n> [!TIP]\n> **Apply for a Cassette account here:** [**Cassette Sign Up**](https://trycassette.online/signup/)\n\nIf you plan to use Hermes and it is not installed yet:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash\n```\n\nIf the Hermes Agent gateway is not configured yet:\n\n```bash\nhermes gateway setup\n```\n\nOh My Cassette currently supports QQ and Telegram gateways.\n\n\n## Requirements\n\n- macOS, Linux, or Windows for the local MCP plugin (Codex, Claude Code, or OpenCode). The Hermes Agent gateway path is macOS/Linux only.\n- Codex, Claude Code, or OpenCode for the local MCP plugin, or Hermes Agent with its gateway configured.\n- Python 3.11–3.13.\n- `ffmpeg`, required for Hermes gateway normalization and optional API export thumbnails.\n\n### Supported video uploads\n\nCassette currently accepts video source files that match all of the following limits:\n\n| Limit | Accepted input |\n| --- | --- |\n| Container | MP4 only |\n| Video | H.264/AVC, 8-bit `yuv420p`, SDR |\n| Audio | AAC mono, AAC stereo, or no audio track |\n| Frame rate | Constant 29.97 or 30 fps |\n| Landscape resolution | Up to `1920×1080` |\n| Portrait resolution | Up to `1080×1920` |\n| File size | Up to 2 GiB (`2,147,483,648` bytes) per video |\n| Duration | Up to 60 minutes per video |\n\nMOV, HEVC/H.265, AV1, VP9, ProRes, HDR, 10-bit, variable-frame-rate video, 24/25/50/60 fps, 4K, oversized files, and videos longer than 60 minutes are rejected rather than transcoded in the cloud.\n\n### Upload retention\n\nUploaded videos and plugin-managed previews, job state, and exports share one immutable **24-hour** deadline measured from the session's first ingest. After that deadline the plugin removes its local copies and the service removes its media; another session — even on the same host or the same account — cannot reach them. Keep your own copy of every source file, and move any export you want to retain outside the plugin-managed data directory before the deadline.\n\nInstall system tools:\n\n```bash\n# macOS\nbrew install uv ffmpeg\n```\n\n```bash\n# Debian/Ubuntu Linux\nsudo apt-get update\nsudo apt-get install -y ffmpeg\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n```powershell\n# Windows (PowerShell)\nwinget install Python.Python.3.13\nwinget install Gyan.FFmpeg\n```\n\n## Install\n\n### Codex\n\n```bash\ncodex plugin marketplace add https://github.com/Cassette-Editor/oh-my-cassette.git\ncodex plugin add oh-my-cassette@cassette-editor\n```\n\nStart a new Codex task after installation so plugin discovery runs again. The plugin contributes the host-neutral `cassette-video-edit` and `cassette-model` skills plus a local MCP process named `cassette`. Fresh editing sessions use GPT-5.6 Luna with Extra High thinking; invoke `$cassette-model` only when you want to inspect or change that session setting.\n\n### Claude Code\n\n```bash\nclaude plugin marketplace add Cassette-Editor/oh-my-cassette\nclaude plugin install oh-my-cassette@cassette-editor\n```\n\nRestart Claude Code after installation. You can verify the installation with:\n\n```bash\nclaude plugin details oh-my-cassette@cassette-editor\n```\n\nClaude Code can keep the plugin up to date on its own once you enable auto-update for the marketplace — see [Update](#update).\n\nFresh editing sessions use GPT-5.6 Luna with Extra High thinking. Invoke `/cassette-model` when you want to inspect or change the current session's model and thinking level.\n\n### OpenCode\n\nOpenCode's plugin manager installs npm packages only, and its plugins cannot contribute MCP servers, so there is no marketplace entry to add. One command instead:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/release/scripts/install_opencode.py | python3 -\n```\n\nThat downloads the current release, writes the `cassette` server into `~/.config/opencode/opencode.json` (merging with any servers and settings already there), installs the host-neutral skills into `~/.config/opencode/skills/`, and installs `/cassette-model` into `~/.config/opencode/commands/`. Restart OpenCode afterwards. Fresh editing sessions use GPT-5.6 Luna with Extra High thinking; the command changes the setting only when you invoke it.\n\n**Re-run the same command to update.** Only `git` is not required — the release tarball is fetched with Python's standard library.\n\nCassette credentials are shared across Codex, Claude Code, OpenCode, and Hermes, so if you have already set up another host there is nothing more to do. Otherwise the installer prints the `setup_local_mcp.py` command to finish authentication. Jamendo uses the host-specific BYOK setup described below.\n\nThe plugin tree lands in `~/.oh-my-cassette` (override with `OMC_HOME`). `--dry-run` previews the changes. If you prefer a git checkout, clone it and run the installer from there — it registers that tree and leaves it alone, and `--sync` fast-forwards it to the release channel.\n\n### Any other MCP host\n\nThe runtime is host-neutral, so any client that launches a local stdio MCP server can use it. Point the client at `scripts/run_local_mcp.py` (run with `python3`, or `python` on Windows) and set `CASSETTE_RUNTIME_ADAPTER=mcp`. The server ships full workflow guidance in its MCP `instructions`, and every tool returns a typed `phase`/`next_action` so a host without the packaged skill can still drive the flow. For the best experience, also install the `cassette-video-edit` and `cassette-model` skills (or equivalent system prompts). Generic clients can call `cassette_config` or ask in natural language to change the current session's model.\n\nLetting an AI assistant do the install for you — Cline, or any agent with shell access? Point it at [llms-install.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/llms-install.md): a machine-readable setup guide covering the runtime pre-build, host registration, authentication, media roots, and verification.\n\n### Hermes\n\nInstall through the Hermes plugin manager (recommended):\n\n```bash\nhermes plugins install Cassette-Editor/oh-my-cassette\n```\n\nThe Hermes installer prompts for your Cassette account email and password and saves them to `~/.hermes/.env`. Then run the setup finisher — it configures the same stdio MCP server and canonical editing skill used by the other hosts, sets Hermes's tool timeout to 1800 seconds, detects `ffmpeg`/`ffprobe`, and lets you pick the Cassette region — and enable the thin gateway plugin:\n\n```bash\npython3 ~/.hermes/plugins/cassette/scripts/install_plugin.py --setup-only\nhermes plugins enable cassette\nhermes gateway restart\n```\n\nYou can check the install status anytime from the Diagnose section.\n\n

Alternative: guided installer from a git checkout (for development)

\n\n```bash\ngit clone https://github.com/Cassette-Editor/oh-my-cassette.git\ncd oh-my-cassette\npython3 scripts/install_plugin.py\n```\n\nRun the installer and follow the prompts to set up Oh My Cassette with your Cassette account.\n\nThe installer:\n\n- installs the plugin into `~/.hermes/plugins/cassette` as a symlink by default;\n- writes the shared Cassette stdio server into `~/.hermes/config.yaml` with an 1800-second tool timeout;\n- asks whether to enable the plugin with `hermes plugins enable cassette`;\n- asks which Cassette URL to use:\n - `https://sg.trycassette.online/agent` (Asia, default)\n - `https://trycassette.online/agent` (America)\n- optionally verifies and saves a Jamendo Client ID into `~/.hermes/.env`;\n- detects `ffmpeg` and `ffprobe` paths for service environments;\n- restarts the Hermes gateway service.\n\nTo copy files instead of creating a symlink:\n\n```bash\npython3 scripts/install_plugin.py --copy --force\n```\n\nFor non-interactive installs:\n\n```bash\npython3 scripts/install_plugin.py \\\n --skip-plugin-enable \\\n --skip-cassette-url \\\n --skip-cassette-auth \\\n --skip-jamendo-auth\n```\n

\n\n## Use with agent clients over local MCP\n\nCodex, Claude Code, OpenCode, and Hermes use the same self-contained runtime. In this README, **MCP server** means a local child process connected over stdin/stdout: it opens no port. The separate Cassette backend remains the editing engine and continues to handle authentication, media processing, agent runs, project state, and rendering.\n\n### First-run authentication\n\nCassette passwords are generated by the server and emailed to you. You never choose one, and the plugin never invents one.\n\nMissing credentials do not prevent the MCP process from starting. There are two ways to hand the password over.\n\n**In the conversation.** Paste the password from your Cassette email and ask the agent to sign in; it calls the `cassette_login` tool, which verifies the account against Cassette before writing anything and then stores it privately. Nothing else is needed — no terminal, no browser. The trade-off is explicit: the password lands in your agent host's transcript on disk and is sent to the model provider for the rest of that conversation. If that is not acceptable to you, use the terminal instead.\n\n**In a private terminal.** The command keeps the password out of the transcript entirely — it prompts with `getpass`, verifies the account before writing anything, and stores credentials in the platform-standard Oh My Cassette config directory. Every `auth_required` envelope carries the exact command for your install; from a git checkout it is:\n\n```bash\npython3 scripts/setup_local_mcp.py --email you@example.com\n```\n\nCredentials may also come from process environment variables. Environment values take precedence over protected local config, so `cassette_login` refuses to write a file that would be shadowed. Importing an existing Hermes `.env` is explicit and optional:\n\n```bash\npython3 scripts/setup_local_mcp.py --import-hermes\n```\n\nEither route creates config directories with mode `0700` and credential files with mode `0600`, rejects symlinks and permissive files, and never persists access or refresh tokens.\n\n### Jamendo BYOK setup\n\nJamendo music matching is strictly bring-your-own-key for every local agent host. Create a read-only application in the [Jamendo developer portal](https://devportal.jamendo.com/) and copy its Client ID. A Client Secret is neither needed nor accepted.\n\n**In the conversation.** Ask the agent to configure Jamendo, paste your Client ID, and it calls `cassette_jamendo_setup`. The tool verifies a minimal Tracks request before writing anything. The trade-off is the same as chat sign-in: the ID reaches the host transcript and model provider for that conversation.\n\n**In a private terminal.** Keep the ID out of the conversation entirely:\n\n```bash\npython3 scripts/setup_local_mcp.py --jamendo\n```\n\nCodex, Claude Code, and OpenCode store it in the protected `settings.json`; Hermes stores it in `~/.hermes/.env`. `JAMENDO_CLIENT_ID` in the process environment remains highest precedence. A failed validation preserves the previous working value.\n\nBYOK assigns API access and quota to your Jamendo application; it does not grant commercial rights to selected music. Review the returned track URL, license URL, download eligibility, and attribution requirements before publishing or commercial use.\n\n### Resetting the password\n\nYou cannot pick a replacement — Cassette generates one and emails it to the account address. Ask the agent for a new password and it calls `cassette_login` with `request_new_password` and `confirm_replace`; or from a terminal:\n\n```bash\npython3 scripts/setup_local_mcp.py --reset-password\n```\n\nBoth routes ask you to confirm first, because the request is irreversible: **it replaces the account password everywhere, including on your other machines**, it is limited to a few attempts an hour, and the replacement happens before the email is sent — so even a delivery failure kills the old password. Check your inbox before retrying.\n\nThe reset only mails the new password; paste it back (in the conversation, or at the terminal prompt) to finish signing this machine in. The verified password is stored in `credentials.json`:\n\n- macOS: `~/Library/Application Support/Oh My Cassette/credentials.json`\n- Linux: `~/.config/oh-my-cassette/credentials.json` (or under `XDG_CONFIG_HOME` when set)\n- Windows: `%APPDATA%\\Oh My Cassette\\credentials.json`\n\nTo make this machine forget the stored password without touching the account:\n\n```bash\npython3 scripts/setup_local_mcp.py --logout\n```\n\n### Usage: point it at your clips\n\n1. **Start your agent in the folder that holds the clips** — or in any parent of it. That folder is the trusted media root (`CASSETTE_PROJECT_ROOT`, set to the host's project directory), and everything beneath it is ingestible, so `~/videos/trip/raw/*.mp4` works when you start in `~/videos/trip`. Clips somewhere else? Register that directory once:\n\n ```bash\n python3 scripts/setup_local_mcp.py --allowed-root /absolute/path/to/media\n ```\n\n Ingesting a file outside every trusted root fails with `source_path_not_allowed`.\n\n2. **Say what you want, in one message, naming the folder.** No upload step to run yourself — the agent ingests the files it needs.\n\n > Edit the clips in ./footage into a 30-second travel vlog with beat-synced cuts. Add the title \"KOTA KINABALU\" at the start and end, and keep the rhythm light.\n\n3. **Keep going in the same conversation.** Each turn commits the edit and returns a timeline digest plus a contact-sheet JPEG saved locally with a clickable link — nothing renders. Hermes labels this as the thumbnail and uses the same saved file; no editor deep link is exposed. \"Make the intro shorter\", \"swap the music for something calmer\", and \"undo that\" all continue the same session.\n\n4. **Say \"export\" when you're happy.** That's the only thing that starts a render; the finished file lands in `cassette/exports//`.\n\nSupported inputs are video, image, and audio files (`.mp4`, `.mov`, `.jpg`, `.png`, `.mp3`, `.wav`, and friends). Mixed folders are fine — send the footage and the music track together.\n\n### Guided editing flow\n\nWhat the plugin does under the hood on each of those turns:\n\n1. Ask your agent client to edit one or more media files in the current project.\n2. The plugin ingests only media inside the active project or another explicitly trusted root. It canonicalizes paths and rejects traversal and symlink escapes.\n3. Describe the edit, answer any guided choices, and start the job. `cassette_run_job` is the wait: the host calls it exactly once for that user turn while the runtime streams progress notifications.\n4. When that call settles, follow its typed `phase` and `next_action`; do not start a status-poll loop or retry the edit in the same user turn. `cassette_job_status` is reserved for a deliberately detached or interrupted call.\n5. If Cassette needs a real user decision, answer it with the returned job ID. On hosts that support MCP elicitation, `cassette_job_status` collects the answer inline and returns the already-resumed status; other hosts use the `cassette_answer_question` round-trip. API jobs persist their private continuation metadata across host restarts.\n6. When editing completes, review the result. Rendering starts only after an explicit `export` decision.\n7. The result contains validated absolute paths, file URIs, MIME type, size, and an MCP resource link for each exported artifact. Large media bytes are never embedded in the tool response.\n\nWhen a background job reaches a terminal state (finished, needs input, failed, or cancelled), the MCP runtime posts a best-effort local desktop notification — `osascript` on macOS, `notify-send` on Linux — so you learn a long render is done even after the monitor budget hands the job back. Set `CASSETTE_MCP_NOTIFY=0` to disable it.\n\nSessions are isolated by a cryptographically random session ID. Codex, Claude Code, OpenCode, and Hermes share host-neutral storage, so you can deliberately hand a session or job ID from one host to another; nothing is shared implicitly.\n\nAdditional trusted media directories can be registered during setup:\n\n```bash\npython3 scripts/setup_local_mcp.py --allowed-root /absolute/path/to/media\n```\n\nExports stay under the shared Oh My Cassette data directory at `cassette/exports//`. Only files contained in that job-specific directory can be returned.\n\n### How the plugin reaches Cassette\n\nOne way: direct calls to the separate Cassette backend. Authentication retries once after a `401`, access tokens are kept in memory only, and continuation metadata is persisted, so a paused job resumes after the agent client restarts.\n\nThere is no browser to install, drive, or keep alive. The Playwright transport that used to sit behind `CASSETTE_TRANSPORT=browser` has been removed; a leftover setting is reported once on stderr and ignored.\n\n### MCP tools\n\nThe local MCP runtime exposes the same 16 tool names as Hermes:\n\n| Tool | Purpose |\n|---|---|\n| `cassette_ingest_media` | Safely ingest trusted project media into an isolated session |\n| `cassette_list_assets` | Read the session's media manifest |\n| `cassette_make_prompt` | (legacy) Build a full edit brief — superseded by verbatim relay |\n| `cassette_match_bgm` | Match Free To Use background music |\n| `cassette_match_exact_bgm` | Match a specific title and artist |\n| `jamendo_music_matcher` | Match structured Jamendo preferences |\n| `cassette_jamendo_setup` | Verify and privately store this machine's Jamendo Client ID |\n| `cassette_answer_question` | Answer a guided question or resume a paused job |\n| `cassette_run_job` | Run one conversational turn (`message` = the user's verbatim words); `export=true` renders |\n| `cassette_job_status` | Resume a deliberately detached or interrupted job call |\n| `cassette_review_completion` | Review completion and explicitly approve export |\n| `cassette_cancel_job` | Request cooperative cancellation |\n| `cassette_timeline` | Read the live project timeline as a bounded text digest (+ optional contact sheet) |\n| `cassette_edit` | Surgical no-LLM edit / undo through the manual command lane (`CASSETTE_DIRECT_EDIT=1`) |\n| `cassette_config` | Get/set the session's model + thinking level (static product list, applies next turn) |\n| `cassette_login` | Verify and privately store this machine's credentials, or request a new emailed password (MCP hosts only) |\n\nEvery tool returns a structured envelope with `ok`, typed `data` or `error`, `session_id`, `job_id`, the current phase, and a runtime-derived `next_action`.\n\n### Local preview links and plan review\n\nThe runtime returns **no editor deep link**. A `…?projectSessionId=&chatSessionId=` URL is a bearer capability: the backend binds no owner to a scratch session, so the only checks on that route are \"signed in\" and \"knows the id\" — any authenticated account that sees the link can open the project *and* run edits on the thread. Tool output ends up in chat transcripts, logs and screen recordings, so the runtime no longer emits one, and the skills instruct the agent not to construct one. Previews are the timeline digest, the contact sheet, and the export.\n\nThis narrows exposure rather than closing it: the route still resolves for anyone who reconstructs the URL. Binding a session to its owner has to happen server-side.\n\nTwo concurrency semantics worth knowing: a plugin turn never cancels a run started from the open editor tab (it fails typed as `thread_busy` instead — wait and retry), while typing a fresh message in the tab DOES cancel an in-flight plugin turn (the tab takes over; existing product behavior).\n\n**Behavior change (0.4.14):** the agent receives the user's `message` verbatim (no brief wrapper), sessions are multi-turn on one thread, and a turn ends with the edit committed but **nothing rendered** — the envelope carries `timeline_delta`, `quality.timeline_ctl`, and a contact-sheet preview instead; pass `export=true` on the turn where the user asks to finish. A fresh session starts immediately with GPT-5.6 Luna and Extra High thinking; model selection is opt-in through `$cassette-model` in Codex, `/cassette-model` in Claude Code/OpenCode, `/cassette_model` in Hermes, or an explicit natural-language request. The saved session preference applies from the next turn.\n\n**Behavior change (0.4.0):** on MCP hosts, `edit_plan_review` now surfaces as a real question by default (`CASSETTE_PLAN_REVIEW=user`) instead of being silently auto-approved — answer with `approve`, `revise `, or `reject`, in chat or in the open editor tab (first answer wins). Set `CASSETTE_UNATTENDED=1` to restore the previous fully headless behavior. Status envelopes additionally carry `timeline_delta` (what changed) and `plan_progress`, fed by the run's SSE event stream (`CASSETTE_API_STREAM=0` disables).\n\n## Ready to Use with Hermes 📼\n**Now you can pick up your phone and DM your agent! Don't forget to keep your agent alive and network connected.**\n\nIn QQ or Telegram:\n\n1. Send one or more video, image, or audio files.\n2. Wait for the saved-material acknowledgement.\n3. Send the edit instruction in the same conversation or prefix it with `/edit`. The session starts with GPT-5.6 Luna and Extra High thinking; send `/cassette_model` only when you want to change them. Your words go to the Cassette agent verbatim; optimization and BGM remain explicit via `/refine` and `/music`.\n4. Each turn ends with the edit saved (timeline delta + contact-sheet preview, no render). Depending on the client, the preview is delivered as an image or a labeled local thumbnail link. Keep editing in the same conversation. Say \"export\" when you want the video, and the plugin renders and delivers it through the gateway when supported.\n\n| Command | Explanation |\n|---|---|\n| `/new` or `/reset` | Clear your assets and start a new conversation with Hermes |\n| `/edit ` | Edit the current video based on your instruction. |\n| `/refine ` | Refine your edit instruction and start editing. |\n| `/music ` | Match and add a BGM to your assets based on your request. |\n| `/cut` | Stop the current Cassette edit. |\n| `/check_assets` | Check the uploaded assets and their status. |\n| `/cassette_model` | Select the current Cassette model and thinking level. |\n| `/cassette language zh` | Set Cassette’s response language to Chinese. |\n| `/cassette language en` | Set Cassette’s response language to English. |\n| `/cassette status ` | Check the status of a specific job. |\n| `/cassette cancel ` | Cancel a specific job. |\n\n* Assets and video state are preserved within the same conversation session. You can send additional messages in the same session to further modify the edited video results.\n\n* Use `/new` or `/reset` to start a fresh Hermes session and clear the live Cassette session and your assets for that conversation.\n\n* QQ is set to Chinese and Telegram is set to English by default, you can set language by command `/cassette language zh/en` manually.\n\n## Update\n\nThe runtime checks the release channel once a day and, when a newer version exists, tells your agent — which mentions it once and offers to run the command below for you. Set `CASSETTE_UPDATE_CHECK=0` to turn that check off.\n\n| Host | Automatic | Manual |\n| --- | --- | --- |\n| Claude Code | yes, once enabled (below) | `claude plugin marketplace update cassette-editor && claude plugin update oh-my-cassette@cassette-editor` |\n| Codex | marketplace snapshot only | `codex plugin add oh-my-cassette@cassette-editor` |\n| Hermes | no | `hermes plugins update cassette && hermes gateway restart` |\n| OpenCode | no | re-run the install command |\n\n### Claude Code: automatic updates\n\nClaude Code checks for marketplace and plugin updates after your session starts, with a random delay of up to ten minutes, so the session you are in keeps the version it launched with — you are prompted to run `/reload-plugins`, or the new version loads next launch. It is off by default for third-party marketplaces, so turn it on once — `scripts/setup_local_mcp.py` offers to do this during setup (skip with `--no-auto-update`), or do it yourself in `/plugin` → **Marketplaces** → `cassette-editor` → **Enable auto-update**, or in `~/.claude/settings.json`:\n\n```json\n{\n \"extraKnownMarketplaces\": {\n \"cassette-editor\": {\n \"source\": { \"source\": \"github\", \"repo\": \"Cassette-Editor/oh-my-cassette\" },\n \"autoUpdate\": true\n }\n }\n}\n```\n\nDeclaring it in `settings.json` wins over the `/plugin` toggle — Claude Code syncs the declared value into its marketplace state and then points you back at the settings file to change it.\n\nBecause the setup prompt only runs at setup, an install that predates it — or one where it was declined — would never hear about the toggle again. So on Claude Code the runtime also reads that setting at startup and, while auto-update is off, asks your agent to mention it at most once per session and point you at the toggle. Your agent will not edit your Claude configuration itself. `CASSETTE_UPDATE_CHECK=0` silences this along with the release check.\n\nClaude Code's `DISABLE_AUTOUPDATER` turns off all automatic updates including plugins; pair it with `FORCE_AUTOUPDATE_PLUGINS=1` to keep plugin updates while managing Claude Code itself manually.\n\n### Codex\n\nCodex refreshes configured git marketplace snapshots on its own, but installed plugins are cached per version, so one command applies the new one:\n\n```bash\ncodex plugin marketplace upgrade cassette-editor # only needed if the snapshot is stale\ncodex plugin add oh-my-cassette@cassette-editor\n```\n\n### OpenCode\n\nRe-run the install command — it is the same command for installs and updates:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Cassette-Editor/oh-my-cassette/release/scripts/install_opencode.py | python3 -\n```\n\nThe local launcher updates its locked, plugin-managed virtual environment automatically on the next start after any of these.\n\n### Hermes\n\nIf installed through the Hermes plugin manager:\n\n```bash\nhermes plugins update cassette\nhermes gateway restart\n```\n\nIf installed from a git checkout (symlink install), update the checkout:\n\n```bash\ngit pull --ff-only\nhermes gateway restart\n```\n\nIf the plugin was installed with --copy, reinstall the copied plugin after pulling:\n```bash\ngit pull --ff-only\npython3 scripts/install_plugin.py --copy --force\nhermes gateway restart\n```\n\nSee [CHANGELOG.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/CHANGELOG.md) for what changed in each release.\n\n

Migrating a symlink install to the Hermes plugin manager (optional)

\n\nExisting symlink installs keep working — migration is optional. To switch:\n\n```bash\nrm ~/.hermes/plugins/cassette # removes only the symlink, not your checkout\nhermes plugins install Cassette-Editor/oh-my-cassette\nhermes gateway restart\n```\n\nYour credentials in `~/.hermes/.env` and the plugin's enabled state carry over;\nalready-set values are not prompted again. Don't run\n`hermes plugins install --force` on top of a symlink — it fails with a\nconfusing error instead of replacing it.\n

\n\n# ❓ FAQ\n\n### Which AI agents does Oh My Cassette work with?\n\nClaude Code, Codex, OpenCode, and Hermes Agent are supported out of the box, and any other MCP host can connect to the local `cassette` MCP server. Sessions live in a host-agnostic data directory, so you can start an edit in one host and continue it in another.\n\n### Does it edit videos locally or in the cloud?\n\nThe plugin runs locally beside your agent and handles media ingestion, edit planning, and job supervision. The actual editing and rendering happen on [Cassette](https://trycassette.online), so you don't need a GPU or any editing software installed.\n\n### Do I need a Cassette account?\n\nYes. The installer asks for your Cassette account email and password on first run and stores them locally; the plugin authenticates with Cassette on your behalf.\n\n### What kinds of videos can it make?\n\nMontage and story edits — vlogs, travel videos, music-driven shorts, cooking tutorials, product commercials, and game highlights — with beat-synced cuts, subtitles, picture-in-picture, transitions, and auto-matched background music. See [Case Videos](#-case-videos) for real examples with prompts and processing times.\n\n### Can I see what the agent is doing mid-edit?\n\nYes. After each editing turn you get a timeline digest and a contact-sheet JPEG saved locally. Terminal clients present a clickable local thumbnail link, and supported gateway clients can deliver the preview as an image. Before the edit runs, the agent can also surface the plan as a storyboard sheet (one source frame per planned beat) for review. The plugin intentionally does not expose an editor deep link.\n\n### Can I try it without installing anything?\n\nNo. Install the plugin in a supported agent host and sign in with a Cassette account.\n\n### Is Oh My Cassette free and open source?\n\nThis plugin is free and open source under the MIT license — all of it, including the MCP server and the skill.\n\nRendering runs on [Cassette](https://trycassette.online), a separate hosted service that requires an account. See [Cassette's pricing](https://trycassette.online) for what an account costs.\n\n# 🔨 Development & Troubleshooting\n\nSetup for contributors, the full configuration reference, transport internals, the diagnostic\nscripts, and answers to common runtime problems all live in\n**[docs/development.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/docs/development.md)**.\n\nQuick diagnostic — run this first when something misbehaves:\n\n```bash\npython3 scripts/diagnose_local_mcp.py # Codex / Claude / OpenCode\npython3 scripts/diagnose_install.py # Hermes\n```\n\nBoth report bootstrap, config, transport, and media-root state without printing credentials.\n\n# 💬 Community\n\n- **[Discussions](https://github.com/Cassette-Editor/oh-my-cassette/discussions)** — ask questions, share the cuts you made, and see what's planned.\n- **[Discord](https://discord.gg/qd9NY4k8d7)** — chat with contributors and other users.\n- **[Issues](https://github.com/Cassette-Editor/oh-my-cassette/issues)** — bug reports and feature requests. Issues labelled `good first issue` are a good place to start.\n- **[CONTRIBUTING.md](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/CONTRIBUTING.md)** — how to propose a change.\n\nMade something you like with it? Post it in Discussions — we feature the best cuts in the showcase.\n\n\n## License\n\nMIT. See [LICENSE](https://github.com/Cassette-Editor/oh-my-cassette/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_111":112,"_113":114,"_115":116,"_117":118,"_119":120,"_121":122},"requiredSecrets",[],"tags",[96,97,98,99,100,101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","agent","agent-skills","ai-agent","ai-video-editing","chat-to-edit","claude-code","claude-code-plugin","claude-code-skills","codex","ffmpeg","hermes-agent","llm","mcp-tools","opencode","python","topics",[96,97,98,99,100,101,102,103,104,105,106,107,123,124,108,109,110,125,126,127],"license","MIT","language","Python","registryName","io.github.Cassette-Editor/oh-my-cassette","homepage","https://cassette-editor.github.io/oh-my-cassette/","packages",[],"mcp","mcp-server","video-editing","video-editor","video-montage","ENV",{"_130":131,"_132":133,"_134":135},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

\nOh My Cassette: Chat Your Raw Clips Into a Finished Cut\n

\n \n Point Claude Code, Codex, or Hermes at a folder of raw clips.\n Describe the video you want. Get back a finished, beat-synced cut.\n \n

💬 Chat-to-Edit

🎵 Smart Music Matching

👀 Nothing Renders Until You Say So

Travel Vlog

Cooking Tutorial

Commercial

\n \n Point Claude Code, Codex, or Hermes at a folder of raw clips.
\n Describe the video you want. Get back a finished, beat-synced cut.\n \n