<div align="center">

# AIMO

Artificial Intelligence in Motion. A video editor for videos made with code.

<a href="https://x.com/uxKero"><img alt="Made by @uxKero" src="assets/badges/made-by.svg"></a> <a href="LICENSE"><img alt="MIT license" src="assets/badges/license.svg"></a> <a href=".claude-plugin/plugin.json"><img alt="Claude Code plugin" src="assets/badges/claude-code.svg"></a> <a href="AGENTS.md"><img alt="51 MCP tools" src="assets/badges/mcp.svg"></a>

<br><br>

<img src="assets/cover.png" alt="AIMO with the example video open: the video in the middle, a text selected with its style panel on the right, and the sound tracks below" width="100%">

</div>

<br>

Videos made with code look great until you want to change one thing. The title is a little big, a sound comes in late, the ball should be orange, and every fix means finding the right line or asking the model again. AIMO opens those videos like a timeline. Click anything on the video and you get the code that draws it, a text you can retype, a color you can pick, a sound you can move. Claude sits in the same window, sees the frame you are looking at and changes what you point at. Everything runs on your computer.

## What is inside

- **Click to code.** Every element on the video leads to the line that draws it. Numbers, colors and texts change with a drag.
- **Texts on the video.** Retype any text and change its font, weight, size, color and alignment in place.
- **Claude in the editor.** Ask for a change, attach screenshots, videos, folders or file paths. It sees the same frame you do.
- **Notes on frames.** Mark a point, a zone or a range and leave it for Claude.
- **Sound by track.** One lane per track, mute and solo, free sounds and music with the credits written for you.
- **Images.** Generated through OpenRouter or Vercel AI Gateway with your own key.
- **Export.** MP4, WebM, GIF, PNG or a single frame, with presets for every platform and up to 60 real fps.
- **Agents.** 51 MCP tools cover everything the interface does, for Claude Code, Codex, Cursor or any MCP client.
- **OpusCut included,** the skill that directs these videos so no two look alike.

## Edit on the video

Select a text and a toolbar opens right on the frame. The panel on the side changes the same text, and both stay in sync.

<img src="assets/live-edit.png" alt="The word Hello selected on the video with a floating toolbar for weight, size, color and alignment, and the typography panel on the right" width="100%">

## From pixel to code

Click any shape and the inspector shows where it comes from, call by call. The values in each line are knobs: drag a number, pick a color, retype a string.

<img src="assets/inspector.png" alt="A circle selected on the video and the inspector listing the functions that draw it, with their numbers highlighted" width="100%">

The code view draws each function as a card with what it paints, when it shows and the values you can change, so you can edit a video without reading code.

<img src="assets/code.png" alt="The code view: cards for drawWorld and sceneHello, each with a preview, its time range and its values" width="100%">

## Claude, with the editor in view

Claude works inside the project, with tools for every part of the editor. It shows what it is doing, how long it has been working and asks with option cards when a decision is yours. One request is one undo step.

<img src="assets/claude.png" alt="The Claude panel after asking to make the ball orange and bigger, with the orange ball on the video" width="100%">

## Sound

Right click a sound to listen to it, change its volume, move it, rename it, swap it for a free one or ask Claude about it. The same works on a whole track.

<img src="assets/sound-menu.png" alt="The context menu of a sound on the effects track: listen, view its code, volume, move, ask Claude, replace with a free sound, rename, remove" width="100%">

Free sound effects and music come connected, with no account or key. Listen before adding, and the credit line goes to `CREDITS.md` on its own.

<img src="assets/music.png" alt="The free sounds window on Music, with cinematic, ambient and electronic tracks ready to play" width="100%">

## Export

Original size or a preset for YouTube, Reels, TikTok, X and 37 more. Choose the format, size, frames per second, quality, a range and the sound.

<img src="assets/export.png" alt="The export window with platform presets, format, size, frames per second, quality, range and sound" width="100%">

## Connections

Free sounds are on from the start. Image generation takes your own OpenRouter or Vercel AI Gateway key, stored only on your computer.

<img src="assets/connections.png" alt="The connections window: free sounds connected, OpenRouter, Vercel AI Gateway and Tripo" width="100%">

## Install

You need [Node.js 20+](https://nodejs.org), [Python 3.10+](https://www.python.org/downloads/), [ffmpeg](https://ffmpeg.org) and [Claude Code](https://claude.com/claude-code) signed in with your account. Nothing to install with npm: the server, the MCP server and the interface come built.

As a Claude Code plugin:

```
/plugin marketplace add uxKero/aimo
/plugin install aimo@kero
```

Then run `/aimo`, or `/aimo path/to/video`.

On its own:

```bash
git clone https://github.com/uxKero/aimo.git
node aimo/server/aimo-server.js
```

and open http://127.0.0.1:4870.

The first time, a welcome checks Claude, Python and ffmpeg, installs the Python packages with one button and opens an example video with a short tour.

<img src="assets/welcome.png" alt="The welcome window on its last step: example video, new video or open a folder" width="100%">

| Agent | Connect |
|:--|:--|
| Claude Code | the plugin above, or `claude mcp add aimo -- node /path/to/aimo/server/aimo-mcp.js` |
| Codex | `[mcp_servers.aimo]` in `~/.codex/config.toml`, see [AGENTS.md](AGENTS.md) |
| Cursor and others | `{ "mcpServers": { "aimo": { "command": "node", "args": ["/path/to/aimo/server/aimo-mcp.js"] } } }` |

## How Claude connects

AIMO runs the `claude` command on your computer, signed in with your own account, the same way you use it in a terminal. It never sees or stores a Claude key. If you are not signed in yet, run `claude auth login` once.

## Develop

```bash
npm install
npm run dev     # live reload from the sources
npm run build   # builds ui/dist, server/aimo-server.js and server/aimo-mcp.js
```

Tested on Windows. macOS and Linux should work and are not tested yet.

<br>

<div align="center">

Made by [@uxKero](https://x.com/uxKero) under the [MIT License](LICENSE).

</div>