diff --git a/README.md b/README.md
index 29bfeef..05f0790 100644
--- a/README.md
+++ b/README.md
@@ -9,15 +9,14 @@ The open-source AI video editor for Claude Code and any MCP client: remove silen
+
-
-
-
+
**MakeMyClip Editor is a free, open-source (MIT) video editor that AI agents drive.** You ask Claude to edit a recording; it calls the editor's tools, and FFmpeg and a local whisper.cpp do the work on your computer. It ships as a Claude Code skill, the `clip` CLI, an MCP server, and a browser timeline editor. No cloud upload, no account, no API key, no telemetry, no generative AI.
@@ -85,7 +84,7 @@ clip ui # opens http://127.0.0.1:5573
Put your videos in the extension's **Media folder** (by default `Documents/MakeMyClip`); the editor reads and writes only there. The extension doesn't include FFmpeg (see [License](#license)): it finds the one Homebrew, MacPorts, winget, Scoop or Chocolatey installed, or you pick it in the extension's settings, along with the optional whisper model.
-**As an MCP server** (drive it from Claude Desktop / Cursor / any MCP client — no API key, on your existing Claude):
+**As an MCP server** (drive it from Claude Desktop / Cursor / Codex / any MCP client — no API key, on the plan you already have):
```jsonc
// claude_desktop_config.json → "mcpServers"
@@ -101,6 +100,15 @@ Put your videos in the extension's **Media folder** (by default `Documents/MakeM
}
```
+Codex (the CLI and the IDE extension) reads the same server from `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.makemyclip-editor]
+command = "npx"
+args = ["-y", "@makemyclip/editor", "mcp"]
+env = { MAKEMYCLIP_WORKSPACE = "/path/to/your/media", MAKEMYCLIP_WHISPER_MODEL = "/path/to/ggml-base.en.bin" }
+```
+
It is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.MakeMyClip/editor) as `io.github.MakeMyClip/editor`, so MCP clients that browse the registry can install it from there. The Claude Code skill auto-discovers triggers and shells out via `npx -y` on demand. The MCP server exposes the timeline tools (show / edit / check / transcribe / undo / redo / export) and a `doctor` setup check over stdio; media stays confined to `MAKEMYCLIP_WORKSPACE`, and `MAKEMYCLIP_WHISPER_MODEL` is only needed for transcription and captions. Everything runs locally and offline — no API key.
**Optional: local transcription** (for editing by transcript, removing retakes, and captions):
@@ -187,6 +195,10 @@ Plus four meta-ops not in the registry: `snapshot`, `undo`, `inspect`, `delete`.
The browser UI is a dark timeline editor: drag-drop import, a monitor (the composited frame at the playhead), an editable timeline (select a clip to trim / split / move / transition / remove, frame it (fill, zoom, position), cut its silences, or cut words and retakes from its transcript), the output shape (16:9, 9:16, 1:1 or 4:5) and loudness, captions from transcripts, one-click export (an mp4, or a project for Final Cut Pro, DaVinci Resolve or Premiere Pro), timeline undo/redo, snapshot, and keyboard shortcuts.
+
+
+
+
---
## Why it exists
diff --git a/docs/hero.png b/docs/hero.png
index c95f5bf..d8d7c0b 100644
Binary files a/docs/hero.png and b/docs/hero.png differ
diff --git a/docs/social-preview.jpg b/docs/social-preview.jpg
new file mode 100644
index 0000000..422b696
Binary files /dev/null and b/docs/social-preview.jpg differ
diff --git a/docs/ui-screenshot.jpg b/docs/ui-screenshot.jpg
new file mode 100644
index 0000000..ba27828
Binary files /dev/null and b/docs/ui-screenshot.jpg differ
diff --git a/src/ui/web/src/App.tsx b/src/ui/web/src/App.tsx
index 8092dda..8f57d75 100644
--- a/src/ui/web/src/App.tsx
+++ b/src/ui/web/src/App.tsx
@@ -1,4 +1,4 @@
-import { useState } from 'react';
+import { useMemo, useState } from 'react';
import { ClipInspector } from './components/ClipInspector.js';
import { DetailPane } from './components/DetailPane.js';
import { DocTimeline } from './components/DocTimeline.js';
@@ -23,7 +23,7 @@ import { useKeyboardShortcuts } from './hooks/useKeyboardShortcuts.js';
import { useSession } from './hooks/useSession.js';
import { useSessionSafety } from './hooks/useSessionSafety.js';
import { useTimeline } from './hooks/useTimeline.js';
-import { findClip, nextClipOnTrack } from './lib/composition.js';
+import { findClip, mediaNames, nextClipOnTrack } from './lib/composition.js';
import { applyTimelineVerbs, type Verb } from './lib/verbs.js';
export function App() {
@@ -42,6 +42,7 @@ export function App() {
const selectedEntry =
selectedId === null ? null : (session.entries.find((e) => e.id === selectedId) ?? null);
const selected = selectedClipId === null ? null : findClip(composition, selectedClipId);
+ const names = useMemo(() => mediaNames(session.entries), [session.entries]);
// Selecting an op and selecting a doc-clip are mutually exclusive — each owns
// the inspector pane, so picking one clears the other.
@@ -224,6 +225,7 @@ export function App() {
;
playheadSec: number;
hasNext: boolean;
/** The timeline's fit, which a clip without its own follows. */
@@ -84,7 +87,7 @@ export function ClipInspector({
-
{clipLabel(clip)}
+
{clipLabel(clip, mediaNames)}
{clip.kind} · {clip.id} · {start.toFixed(2)}–{end.toFixed(2)}s (
{clipDuration(clip).toFixed(2)}s)
diff --git a/src/ui/web/src/components/DocTimeline.tsx b/src/ui/web/src/components/DocTimeline.tsx
index fe1f4dd..44b8158 100644
--- a/src/ui/web/src/components/DocTimeline.tsx
+++ b/src/ui/web/src/components/DocTimeline.tsx
@@ -21,6 +21,7 @@ const MAX_THUMBS = 16; // cap thumbnails per clip to bound requests
*/
export function DocTimeline({
composition,
+ mediaNames,
selectedClipId,
onSelectClip,
playheadSec,
@@ -33,6 +34,8 @@ export function DocTimeline({
verbError,
}: {
composition: Composition;
+ /** File name of each media id, for labeling media clips. */
+ mediaNames: ReadonlyMap;
selectedClipId: string | null;
onSelectClip: (clipId: string | null) => void;
playheadSec: number;
@@ -156,6 +159,7 @@ export function DocTimeline({
@@ -205,10 +209,12 @@ export function DocTimeline({
function ClipBlock({
clip,
+ label,
selected,
onSelect,
}: {
clip: Clip;
+ label: string;
selected: boolean;
onSelect: (clipId: string | null) => void;
}) {
@@ -220,10 +226,10 @@ function ClipBlock({
className={`doc-tl-clip doc-tl-clip-${clip.kind}${selected ? ' selected' : ''}`}
style={{ left, width }}
onClick={() => onSelect(selected ? null : clip.id)}
- title={`${clipLabel(clip)} · ${clip.startSec.toFixed(2)}–${clipEndSec(clip).toFixed(2)}s`}
+ title={`${label} · ${clip.startSec.toFixed(2)}–${clipEndSec(clip).toFixed(2)}s`}
>
{clip.kind === 'media' ? : null}
- {clipLabel(clip)}
+ {label}{clipDuration(clip).toFixed(1)}s
);
diff --git a/src/ui/web/src/lib/composition.ts b/src/ui/web/src/lib/composition.ts
index fe0f2f3..9576d7a 100644
--- a/src/ui/web/src/lib/composition.ts
+++ b/src/ui/web/src/lib/composition.ts
@@ -1,4 +1,5 @@
-import type { Clip, Composition, Track } from '../types.js';
+import type { Clip, Composition, SessionEntry, Track } from '../types.js';
+import { shortName } from './playable-clips.js';
// Frontend mirror of the doc geometry helpers in src/timeline/composition.ts.
// The timeline view positions clips by their DOCUMENT extent (startSec +
@@ -23,9 +24,25 @@ export function compositionDuration(comp: Composition): number {
return end;
}
-/** Short, human-readable label for a clip on the timeline. */
-export function clipLabel(clip: Clip): string {
- if (clip.kind === 'media') return clip.mediaId;
+/** File name of each ingested media id, read from the session log's `ingest`
+ * entries (`{ mediaId, ref: { path } }`) — the same registry export resolves
+ * media through. */
+export function mediaNames(entries: SessionEntry[]): Map {
+ const names = new Map();
+ for (const entry of entries) {
+ if (entry.tool !== 'ingest') continue;
+ const { mediaId, ref } = entry.result as { mediaId?: unknown; ref?: { path?: unknown } };
+ if (typeof mediaId === 'string' && typeof ref?.path === 'string') {
+ names.set(mediaId, shortName(ref.path));
+ }
+ }
+ return names;
+}
+
+/** Short, human-readable label for a clip on the timeline. A media clip shows its
+ * file name, or its media id when the session log doesn't name it. */
+export function clipLabel(clip: Clip, names: ReadonlyMap): string {
+ if (clip.kind === 'media') return names.get(clip.mediaId) ?? clip.mediaId;
if (clip.kind === 'text') return `“${clip.text.slice(0, 20)}”`;
return `color · ${clip.color}`;
}
diff --git a/src/ui/web/src/lib/playable-clips.ts b/src/ui/web/src/lib/playable-clips.ts
index e34955b..a9452f5 100644
--- a/src/ui/web/src/lib/playable-clips.ts
+++ b/src/ui/web/src/lib/playable-clips.ts
@@ -26,7 +26,7 @@ function isVideoPath(path: string): boolean {
return VIDEO_EXT.has(ext);
}
-function shortName(path: string): string {
+export function shortName(path: string): string {
const base = path.split('/').pop() ?? path;
// Strip the 8-char random prefix (`xxxxxxxx-`) that we add to import
// filenames and tool outputs, so cards show "demo.mp4" instead of
diff --git a/src/ui/web/src/styles.css b/src/ui/web/src/styles.css
index 2c1767f..94d3213 100644
--- a/src/ui/web/src/styles.css
+++ b/src/ui/web/src/styles.css
@@ -186,6 +186,14 @@ body,
}
.op-list .op {
+ /* Each op is a