English · Português · Español

You ask. Your video gets rhythm.

A free, open-source video editing skill for Claude Code and Codex. Cut pauses and mistakes, add captions, fix the audio, reframe, and turn parts of your speech into motion scenes by asking in plain language. Transcription and rendering run on your computer.

Install with one request · How it works · Lab · Motion scenes · Guide · Star history

You don't download anything by hand. Open Claude Code or Codex in any folder and paste this request. The same request installs editonny the first time and updates it later: your agent clones the skill from GitHub, follows its setup procedure, verifies everything, and asks before anything outside the request.

Install or update the editonny skill for Codex and Claude Code from https://github.com/soumatheusgomes/editonny. Clone the latest version into a temporary folder; I won't download anything myself. Read skills/editonny/SKILL.md and follow its complete setup procedure. If editonny is already installed, compare versions, summarize what changes, and update it through its existing delivery method: the repository installer for a shared installation (it preserves my settings and backs up the previous copy) or the host's updater for a managed plugin. Prepare the compatible local tools, locked engine, pinned renderer and browser, default transcription model, local OCR for caption checks, and bundled media before the first edit. Verify with diagnostics and a synthetic sample, report anything pending, remove the temporary clone, and tell me when to restart my agent. Ask before paid services or sending my media.

When it finishes, restart your agent and call /editonny in Claude Code or $editonny in Codex. This is the same request the guide copies for you.

The agent prepares what is missing and reports pending downloads or failed checks before calling setup complete. Local transcription and rendering do not need an LLM API key; your agent subscription is separate. External generators are optional and require your authorization before costs or media transmission.

git clone https://github.com/soumatheusgomes/editonny.git
cd editonny
python3 install.py --target both
python3 ~/.local/share/editonny/scripts/editonny.py doctor
python3 ~/.local/share/editonny/scripts/editonny.py media status

editonny is a skill installed on your computer. You describe the result and point your agent at a video folder; the skill inspects the recording, chooses complete takes, measures cuts against the waveform, assembles a project, reviews a representative sample, and exports a checked MP4.

$editonny
Edit a 45-second vertical video from /path/to/footage.
Keep complete takes, clean pauses, breaths, and mistakes, and add clear captions.
Use visual scenes only where they explain the story.
Verify an 8–15 second sample before finishing the export.

1. Choose a goal in the guide, specify the footage folder, and copy the request (in the guide's language) to your agent.
2. The skill inspects the selected sources, proposes every editing setting, and waits for your confirmation, even with a detailed prompt. Defaults preserve the original image, geometry, and FPS; color filters and conversions are never automatic.
3. After acceptance, work stays in Downloads/editonny/date-title/: finished videos in exports/, editing files in project/. Review an 8–15 second sample; select user approval if you want the agent to wait at this later step too.
4. A supported render route publishes uniquely named MP4/subtitle files with a matching verification manifest. Unsupported color/timing paths block clearly; remote execution must identify an accessible destination.

Standard cleanup removes unnecessary pauses, audible breaths, mistakes, false starts, and redundant repetitions while preserving complete words, natural pacing, intentional pauses, and meaning. Narrow revisions stay within the requested scope. Original footage is preserved, and speech can stay in its original language.

Scenes come from the bundled catalog of 145 motion scenes and 79 original clips; projects receive only the clips they use. Sample numbers, offers, testimonials, and brands in scenes are illustrative and must be replaced with supplied facts. Never treat generated visuals as evidence. All banners in this README are illustrative animations of the workflow, not renders of customer footage.

The guide is the editonny website: it builds editing requests, browses the 145 motion scenes and 54 example requests, and explains installation in English, Brazilian Portuguese, or Spanish (picked from your browser; your choice and your brief stay saved in that browser). It never receives or uploads footage.

To run it locally from this repository (Node.js 22.13+ or 24+):

npm ci
python3 editonny.py guide

This starts the development server at http://localhost:4173 and opens it. Stop it with Ctrl+C; use --port to choose another port and --no-open to skip the browser. npm run dev does the same on port 3000.

New projects use project.json and English commands, fields, and scene IDs. This is a clean pre-release foundation; previous experimental project formats are unsupported.

npm ci --ignore-scripts
uv sync --locked --directory skills/editonny/engine
npm run build
npm run check
python3 editonny.py doctor
npm run test:engine
npm run test:browser
npm run test:preview
npm run test:scenes
npm run test:three
python3 scripts/smoke_engine.py

python3 scripts/package.py

If editonny helps your next video, give the project a star. Follow its progress, report a problem, or share an idea for a scene.

Star the project · Report an issue · Open star history

Live star history is provided by Star History and depends on that service. The badge above shows the real GitHub star count.

Created and maintained by Matheus Gomes.

• Instagram: @matheusgomes
• Email: eu@matheusgom.es
• GitHub: soumatheusgomes/editonny

First-party code and documentation use the MIT License. Third-party libraries, models, fonts, audio, and media retain their own licenses and attribution; MIT does not relicense those resources. Consult the third-party notices and the notices beside assets before redistribution.

Product · Architecture · Interface · Integrations · Development setup

YOU HAVE THE STORY. WE GIVE IT RHYTHM.
Back to top ↑