Vecmo

Vecmo

ブラウザーで動作するベクターモーションエディターです。依存関係のないランタイムコードをエクスポートできます。

• モーションを動画ではなくコードとしてエクスポートします。型定義付きの自己完結型 JS ランタイム .d.ts であり、レンダリング済みのクリップではありません。
• エージェントネイティブです。型付きのシーン／モーションドキュメント、ヘッドレスおよびライブのコマンド操作に使える vmactl、そしてエージェントがプロジェクトを読み込んで編集できる 26 個の MCP ツールを備えています。
• GPU Look Graph エフェクト（グレイン、ハーフトーン、リソグラフ、CRT、VHS、レンズ）は、DaVinci Resolve Studio 18+ 向けの .dctl ファイルにエクスポートされます。

クイックスタート

bun install && bun run dev

/ を開くとエディターが表示されます。すべてブラウザー内で動作し、ローカルファーストです。このビルドではサーバーと通信しません。

チェック：bun run check。ビルド：bun run build。このリポジトリにはテストスイートは含まれていません（CONTRIBUTING.md を参照してください）。

お試しください

1. bun run dev を実行し、/?ref=hello-motion を開きます。
2. エクスポート → Motion / Code → EMBED（「Motion Artifact」、自己完結型の埋め込み可能な成果物）を選択します。
3. ダウンロードを解凍すると、hello-motion.runtime.js、その .d.ts、マニフェスト、デモ用 HTML ページが含まれています。

その他のリファレンスシーンは /?ref=<slug> で確認できます。全リストは src/features/reference-scenes/model/registry.ts を参照してください。

GUI を使わずにヘッドレスで実行する場合：bun run export:motion-artifact -- --ref hello-motion --out ./out を実行すると、同じ 4 つのファイルが書き出されます（決定論的です。--commands plan.json は先にエージェント編集プランを適用し、--dump-documents は MCP ツール向けにシーン／モーションの生 JSON を出力します）。

利用例

vecmo-example — https://vecmo-example.pages.dev で公開中 — は、実行時にエクスポート済みファイルのみをインポートする、無関係な Vite サイトです（Vecmo ソースも SDK も使いません）。ヒーローとしての WebGL Look Graph 作品、スクロール駆動の seekProgress、パレットの再テーマ設定、実測サイズの段階的比較（gzip で 49.8 KB／118 KB／198 KB）、Lighthouse のデスクトップ 0.98／モバイル 0.91、リークがないことを確認するマウント／破棄プローブ、そして実際の MCP 編集から CLI 再エクスポートまでのループを備えています。

エクスポートサイズ（gzip -9 で測定）

シーン	プロファイル	サイズ
hello-motion	EMBED（Motion Artifact）	48.2 KB
エフェクトを多用したリファレンスシーン（グレイン、マスク、モーション文法）	EMBED（Motion Artifact）	115–152 KB

再現するには、bun run export:motion-artifact -- --ref <slug> --out ./out を実行します（生バイト数／gzip 後のバイト数とティアを出力します）。または、bun run dev → /?ref=<slug> → エクスポート → EMBED の順に操作し、ZIP 内の <slug>.runtime.js を gzip 圧縮します。

その他のエクスポート先：WebGL プレーヤー、PDF、WebM、SVG、DCTL（DaVinci Resolve のルックエクスポート）。

MCP

リポジトリの .mcp.json を Claude Code または Cursor に追加すると、bun run mcp:agent（scripts/vma-agent-mcp.ts）が起動します。これは型付きのシーン／モーションドキュメントを扱う 26 個のツールを公開する、ローカル stdio サーバーです。たとえば、observe_document、apply_scene_commands、export_artboard などを利用できます。ヘッドレスまたはスクリプトで操作する場合は、MCP クライアントを使わずに bun run vmactl から同じコマンドエンベロープを直接実行できます。コマンドの全リファレンスは docs/agent-command-catalog.md、ローカルリレー（bun run agent:bridge）経由のライブ編集については docs/live-mcp-agent-runbook.md を参照してください。

範囲

このリポジトリが提供するのはエディターです。ブラウザー内で完全に動作し、ここからサーバーと通信することはありません。vecmo.dev のホスト型サービス（アカウント、クラウドプロジェクト、課金）は別個の非公開バックエンドであり、ここには含まれません。

アーキテクチャ

責務レイヤー（app -> pages -> widgets -> features -> entities -> shared）については docs/architecture.md から、各サブシステムの配置場所については docs/codemap.md から確認してください。

貢献

CONTRIBUTING.md を参照してください。

ライセンス

エディターは AGPL-3.0-only です。開発者レイヤー（エージェント／CLI ツールキット、ランタイムのプレーヤー制御／マニフェストコード、および packages/editor-kernel）は MIT です。正確なファイル一覧については REUSE.toml をご覧ください。エクスポートするすべてのもの（ランタイム JS、WebGL プレーヤー、それらの .d.ts ファイル、シーン／モーション／バックアップ文書）には、AGPL §7 による追加許可（Vecmo Runtime Output Exception）が適用されるため、エクスポートした成果物をプロプライエタリなサイトに埋め込んでも、それらについて何かを還元する必要はありません。詳細については、LICENSING.md をご覧ください。