# nexu-io/openmotion

> openmotion is an open-source video studio that recreates a reference video with your own brand kit and copy, so you can make motion videos for YouTube, YouTube Shorts, Instagram Reels and TikTok. You use it from a local AI agent such as Claude Code or Codex, which builds, edits and renders the videos through the openmotion Studio and MCP server. The project is a full-stack agentic video studio written mainly in TypeScript.

Source: https://github.com/nexu-io/openmotion
Indexed: commit 1d5a158 on 2026-11-22 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Library
- Language: TypeScript
- Stars: 14,975 at index time
- License: Apache-2.0
- Code health: 8.3/10, Good
- Last commit: 2026-11-21
- Contributors: 53

## Install

From the README: https://github.com/nexu-io/openmotion#install-from-chatgpt-marketplace

Clone the openmotion repository.
    git clone https://github.com/nexu-io/openmotion.git

Move into the openmotion folder.
    cd openmotion

Install the dependencies in the source checkout.
    npm ci

Build the Studio.
    npm run build:studio

Start the local service, then open the studioUrl or previewUrl it prints and choose Template library.
    npm start

## How it works

The local AI agent is the entry point: the plugin's .mcp.json launches the root mcp.ts file, which provides the MCP server the agent calls. The library directory holds the template catalog in library/templates/catalog/, and openmotion_list_templates returns a searchable local index of those templates. The studio directory is the largest module and contains the editable Studio where a video is arranged, revised and previewed. The gateway directory calls model providers, detects local agents and signs users in, with each workspace keeping its own keys and sessions. The scripts directory packages openmotion for npm and fetches and verifies its native video tools, while packages holds the shared visual kit that Studio screens draw from. The output is an MP4 export, which is verified before a final preview is shown.

- integrations/dsh/plugin/src/index.ts: entry point
- integrations/dsh/start.ts: entry point
- mcp-ui/template-recommendations/app.ts: entry point
- packages/design-system/index.js: entry point
- packages/design-system/workbench/server.js: entry point
Modules: studio, library, tests, shared, scripts, gateway, packages, root. 9,716 files, 498,424 lines, 37,892 symbols.

## Code health

- Score: 8.3/10 (Good)
- Trend: 8.6 on 2026-11-20, 8.3 on 2026-11-22
- Rank: #50 of 4,000+ indexed repos
- Hotspots: studio/src/motion/TemplateLibraryDialog.tsx, studio/src/motion/WorkspaceFrame.tsx, studio/src/motion/ExploreStudios.tsx, gateway/service.ts, gateway/account.ts
- Lowest file: shared/generation-options.ts
- Dead code: 57 findings

## Maintenance

- Last commit 2026-11-21, first commit 2026-05-11, 600 commits
- 53 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/nexu-io/openmotion/security

## More

- Page: https://repowise.dev/repo/nexu-io/openmotion
- Ask this codebase: https://repowise.dev/repo/nexu-io/openmotion/chat
- Docs: https://repowise.dev/repo/nexu-io/openmotion/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/nexu-io/openmotion
