Code-first video & image, rendered natively on WebGPU.
showcases
okanasl38e74aa7d694
diff --git a/.gitignore b/.gitignoreindex bb1bdd91..54f51051 100644--- a/.gitignore+++ b/.gitignore@@ -49,8 +49,9 @@ assets/soundfonts/*.png*.jpg*.jpeg-# ...except the brand assets the README links to and the plugin icon+# ...except the brand assets and showcase stills the README links to, and the plugin icon!assets/brand/*.png+!assets/showcase/*.jpg!plugins/gitframes/assets/*.png# Vision Tracking Caches@@ -84,4 +85,7 @@ examples/**/output/packages/**/models/# Local agent workspace (Hermes plans, scratch probes)-.hermes/\ No newline at end of file+.hermes/++# Plugin ZIP for the OpenAI plugin directory (pnpm run pack:plugin)+gitframes-plugin.zipdiff --git a/README.md b/README.mdindex d52d06fe..28a9c565 100644--- a/README.md+++ b/README.md@@ -21,15 +21,37 @@ Renders directly on GPU hardware via Dawn / WebGPU / Metal / Vulkan in Node.js a</div>+### Made with gitframes++Every frame of these films is rendered by gitframes from TypeScript in [`examples/`](examples). Click a still to watch it on YouTube.++<table>+ <tr>+ <td width="33%" align="center">+ <a href="https://youtu.be/caJJ7ucwyQk"><img src="assets/showcase/gitframes-launch.jpg" alt="Gitframes launch film" width="100%"></a>+ <br><a href="https://youtu.be/caJJ7ucwyQk"><b>Gitframes launch</b></a>+ <br><sub><a href="examples/22_gitframes_launch"><code>22_gitframes_launch</code></a></sub>+ </td>+ <td width="33%" align="center">+ <a href="https://youtu.be/F-_gzQxGbho"><img src="assets/showcase/full-circle.jpg" alt="Full Circle film" width="100%"></a>+ <br><a href="https://youtu.be/F-_gzQxGbho"><b>Full Circle</b></a>+ <br><sub><a href="examples/21_full_circle"><code>21_full_circle</code></a></sub>+ </td>+ <td width="33%" align="center">+ <a href="https://youtu.be/HdFjXB4eKxc"><img src="assets/showcase/dancer.jpg" alt="Dancer showcase film" width="100%"></a>+ <br><a href="https://youtu.be/HdFjXB4eKxc"><b>Dancer showcase</b></a>+ <br><sub><a href="examples/19_gitframes_film"><code>19_gitframes_film</code></a></sub>+ </td>+ </tr>+</table>+> [!NOTE]> **Using an AI coding agent?** Install the gitframes skills straight from the marketplace.>> **Claude Code**> ```text-> /plugin marketplace add gatewai-dev/gitframes-> /plugin install gitframes@gitframes-plugins+> /plugin install gitframes> ```-> Run these in a `claude` terminal session (not the desktop app's Code tab), then restart or run `/reload-plugins`.>> **Codex**> ```bash@@ -530,7 +552,7 @@ console.log(`Video rendered successfully to: ${filePath}`);## Agent Skills & Plugins-Gitframes ships agent skills that teach Claude, Codex, and other coding agents how to write, render, and check compositions. The repository is a plugin marketplace (`gitframes-plugins`) with a single plugin (`gitframes`) that contains **only skills** — no MCP servers, hooks, or commands.+Gitframes ships agent skills that teach Claude, Codex, and other coding agents how to write, render, and check compositions. The plugin (`gitframes`) is listed in Anthropic's official plugin directory and contains **only skills** — no MCP servers, hooks, or commands. This repository is also a plugin marketplace (`gitframes-plugins`) for Codex and for installing straight from GitHub.| Skill | Use it for || --- | --- |@@ -548,37 +570,35 @@ The plugin is instructions only. It bundles no executables, MCP servers, hooks,### Claude Code```text-/plugin marketplace add gatewai-dev/gitframes-/plugin install gitframes@gitframes-plugins+/plugin install gitframes```Or from your shell:```bash-claude plugin marketplace add gatewai-dev/gitframes-claude plugin install gitframes@gitframes-plugins+claude plugin install gitframes@claude-plugins-official```-Adding the marketplace only registers the catalog; the `install` step is what enables the skills. Afterwards, restart Claude Code or run `/reload-plugins`. `/plugin` commands need an interactive `claude` terminal — they don't work in the desktop app's Code tab, so use the shell form there.+It installs from Anthropic's official marketplace, which Claude Code adds for you, so there is no marketplace step, and plugins from it update automatically. Afterwards, restart Claude Code or run `/reload-plugins`. `/plugin` commands need an interactive `claude` terminal; in the desktop app's Code tab, use the shell form or **+ > Plugins > Add plugin** and pick **Gitframes**.-Add `--scope project` to record the plugin in `.claude/settings.json` for the whole team. Update later with `/plugin marketplace update gitframes-plugins`.+Add `--scope project` to the shell form to record the plugin in `.claude/settings.json` for the whole team.**Enable it for everyone in your repo.** Commit this to `.claude/settings.json`; Claude Code prompts teammates to install it when they trust the folder:```json{- "extraKnownMarketplaces": {- "gitframes-plugins": {- "source": { "source": "github", "repo": "gatewai-dev/gitframes" }- }- },"enabledPlugins": {- "gitframes@gitframes-plugins": true+ "gitframes@claude-plugins-official": true}}```-**Claude desktop app (Code tab):** open plugin settings, add the marketplace `gatewai-dev/gitframes`, then install **Gitframes**.+**Straight from this repository** (tracks `main` instead of the directory release):++```text+/plugin marketplace add gatewai-dev/gitframes+/plugin install gitframes@gitframes-plugins+```### Codexdiff --git a/assets/showcase/dancer.jpg b/assets/showcase/dancer.jpgnew file mode 100644index 00000000..8d8bdebfBinary files /dev/null and b/assets/showcase/dancer.jpg differdiff --git a/assets/showcase/full-circle.jpg b/assets/showcase/full-circle.jpgnew file mode 100644index 00000000..e20306a7Binary files /dev/null and b/assets/showcase/full-circle.jpg differdiff --git a/assets/showcase/gitframes-launch.jpg b/assets/showcase/gitframes-launch.jpgnew file mode 100644index 00000000..ce42c9efBinary files /dev/null and b/assets/showcase/gitframes-launch.jpg differdiff --git a/examples/19_gitframes_film/src/film.ts b/examples/19_gitframes_film/src/film.tsindex 0ce5d548..5f6755dd 100644--- a/examples/19_gitframes_film/src/film.ts+++ b/examples/19_gitframes_film/src/film.ts@@ -1,7 +1,13 @@/*** The 30-second film, assembled. Scenes overlap where a transition carries one- * into the next; the score sets the grid (100 BPM, hits at 10.2 s, 19.8 s and- * 26.4 s — see theme.ts and shots.ts).+ * into the next; the score is the only audio and sets the grid (100 BPM):+ *+ * 0.0–10.2 open → film → grade (piano, strings)+ * 10.2–19.8 motion → code (the drop at 10.2)+ * 19.8–26.4 effects → track (second drop at 19.8)+ * 26.4–30.0 resolve (final chord at 26.4, rings out)+ *+ * Every clip is muted; only `score.mp3` reaches the mix.*/import { Composition, FilmGrain, Layer } from "gitframes";import { codeScene } from "./scenes/code.js";diff --git a/examples/19_gitframes_film/src/scenes/effects.ts b/examples/19_gitframes_film/src/scenes/effects.tsindex b05d6532..e3edad39 100644--- a/examples/19_gitframes_film/src/scenes/effects.ts+++ b/examples/19_gitframes_film/src/scenes/effects.ts@@ -1,10 +1,9 @@/**- * 19.8–26.4 s — The drop. The preview that just rendered is now the frame;- * then a cut every half-bar, each one a different GPU effect, a 2×2 wall of- * four passes over one clip, and two flash cuts into the title.+ * 19.8–23.4 s — The drop. The preview that just rendered is now the frame,+ * ember smoke blooms out of it, then a 2×2 wall of four passes over one clip+ * lands an eighth note at a time. Six beats, then Vision takes the rest of the bar.*/import {- Blur,ColorBalance,Curves,FilmGrain,@@ -12,14 +11,13 @@ import {HalftoneScreen,Layer,LayerAnimation,- Signal,Vignette,} from "gitframes";import { CODE_FROM, CODE_TO, DANCER_TRIM_SEC, EMBER_STOPS, HALFTONE, PREVIEW_CLIP_START } from "./code.js";-import { EASE_OUT, EMBER, FPS, H, INK, PAPER, SANS, W, asset, headline, keys, scene } from "../theme.js";+import { EASE_OUT, EMBER, FPS, H, INK, PAPER, SANS, W, asset, beats, headline, scene } from "../theme.js";export const EFFECTS_FROM = CODE_TO;-export const EFFECTS_TO = 792;+export const EFFECTS_TO = EFFECTS_FROM + beats(6);type Clip = ReturnType<typeof Layer.video>;@@ -102,39 +100,25 @@ function chip(id: string, name: string, from: number, to: number, at = { x: 96,}).animate(anim);}-/** Scene-local ramp for effect params (effects are clocked in source frames). */-function decay(from: number, to: number, trimSec: number, frames: number) {- const t0 = Math.round(trimSec * FPS);- return Signal.builder({- type: "custom",- fn: (ctx) => {- const p = Math.min(1, Math.max(0, (ctx.frame - t0) / frames));- return to + (from - to) * (1 - p) ** 2;- },- });-}-export function effectsScene() {// Continue the code preview exactly where it was when it hit full frame.const dancerIn = DANCER_TRIM_SEC + (CODE_TO - CODE_FROM - PREVIEW_CLIP_START) / FPS;- const A = shot("fx-a", 0, 56, [+ // One beat per idea: halftone (0..45), pure smoke (36..72), the wall (63..108).+ const A = shot("fx-a", 0, 45, [clip("fx-a-clip", "dancer.mp4", dancerIn).apply(new HalftoneScreen(HALFTONE)).apply(new GradientMap({ stops: EMBER_STOPS })),- headline({ id: "fx-title", text: "Transform it.", x: 96, y: 96, width: 1200, size: 124, color: INK, inAt: 4, outAt: 38 }),- ]).animate(LayerAnimation.create().fadeOut(46, 54, "power2.inOut"));+ headline({ id: "fx-title", text: "Transform it.", x: 96, y: 96, width: 1200, size: 124, color: INK, inAt: 4, outAt: 28 }),+ ]).animate(LayerAnimation.create().fadeOut(36, 44, "power2.inOut"));- // Continuous smoke layer: blooms over the spinning dancer (46..54),- // stands pure and voluminous for the gradient map showcase (54..81),- // and floats as glowing atmospheric tendrils over the salt flat desert (81..97).- const SMOKE_START = 46;- const SMOKE_END = 97;+ // Smoke blooms out of the fading dancer, stands alone for the gradient map,+ // then burns off as the wall drops in underneath it.+ const SMOKE_START = 36;+ const SMOKE_END = 72;const smokeDur = SMOKE_END - SMOKE_START;- const smokeFadeIn = 8;- const smokeFadeOutStart = 81 - SMOKE_START;const smokeAnim = LayerAnimation.create()- .fromTo("opacity", 0, 1, { start: 0, end: smokeFadeIn, ease: "power2.inOut" })- .fromTo("opacity", 1, 0, { start: smokeFadeOutStart, end: smokeDur, ease: "sine.out" })+ .fromTo("opacity", 0, 1, { start: 0, end: 8, ease: "power2.inOut" })+ .fromTo("opacity", 1, 0, { start: 27, end: smokeDur, ease: "sine.out" }).fromTo("scale", 1.14, 0.98, { start: 0, end: smokeDur, ease: "sine.out" });const B = Layer.box({@@ -154,21 +138,6 @@ export function effectsScene() {],}).animate(smokeAnim);- const C = shot("fx-c", 81, 108, [- warm(- clip("fx-c-clip", "frame.mp4", 1.2).apply(- new Blur({ blurType: "Zoom", centerX: 0.5, centerY: 0.46, strength: decay(100, 0, 1.2, 26) as never }),- ),- ).animate(keys("scale", [[0, 1.18], [27, 1.0, EASE_OUT]])),- ]);-- // Engraved line screen: ink rules on paper, no process colours.- const D = shot("fx-d", 108, 135, [- clip("fx-d-clip", "portrait.mp4", 0.6).apply(- new HalftoneScreen({ dotShape: "Line", frequency: 96, angle: 30, dotColor: INK, paperColor: PAPER, contrast: 1.25 }),- ),- ]);-// Four passes over one clip, tiled; each cell drops in on an eighth note.const GAP = 12;const cw = (W - GAP * 3) / 2;@@ -189,8 +158,8 @@ export function effectsScene() {];const E = shot("fx-e",- 135,- 180,+ 63,+ 108,cells.map(({ name, title, fx }, i) => {const x = GAP + (i % 2) * (cw + GAP);const y = GAP + Math.floor(i / 2) * (ch + GAP);@@ -214,9 +183,6 @@ export function effectsScene() {}),);- const F1 = shot("fx-f1", 180, 189, [warm(clip("fx-f1-clip", "ink.mp4", 5.2))]);- const F2 = shot("fx-f2", 189, 198, [warm(clip("fx-f2-clip", "portrait.mp4", 4.5))]);-return scene({id: "effects",from: EFFECTS_FROM,@@ -224,16 +190,10 @@ export function effectsScene() {background: INK,children: [A,- C,- D,E,- F1,- F2,B,- chip("fx-chip-a", "Halftone", 6, 52),- chip("fx-chip-b", "Gradient map", 56, 81),- chip("fx-chip-c", "Zoom blur · Curves", 83, 108),- chip("fx-chip-d", "Line screen", 110, 135),+ chip("fx-chip-a", "Halftone", 6, 40),+ chip("fx-chip-b", "Gradient map", 44, 66),],});}diff --git a/examples/19_gitframes_film/src/scenes/resolve.ts b/examples/19_gitframes_film/src/scenes/resolve.tsindex 45e734b1..9fcbc51d 100644--- a/examples/19_gitframes_film/src/scenes/resolve.ts+++ b/examples/19_gitframes_film/src/scenes/resolve.ts@@ -1,15 +1,19 @@/*** 26.4–30.0 s — Back to paper. The ember line from the first frame returns,- * the wordmark rises out of it on the final chord, the promise drops beneath.+ * the wordmark rises out of it on the final chord, the promise drops beneath,+ * and the plugin install lines settle at the foot of the frame.*/import { Layer, LayerAnimation } from "gitframes";import { TRACK_TO } from "./track.js";-import { EASE_IN_OUT, EMBER, INK, PAPER, SERIF_ITALIC, STONE, W, headline, keys, label, scene } from "../theme.js";+import { EASE_IN_OUT, EASE_OUT, EMBER, INK, MONO, PAPER, SERIF_ITALIC, STONE, W, headline, keys, scene } from "../theme.js";export const RESOLVE_FROM = TRACK_TO;export const RESOLVE_TO = RESOLVE_FROM + 108;const LINE_Y = 624;++/** Agent plugin installs: Claude Code (official directory, bare name), then Codex. */+const INSTALL = ["/plugin install gitframes", "codex plugin marketplace add gatewai-dev/gitframes"];const LINE_W = 760;export function resolveScene() {@@ -73,17 +77,23 @@ export function resolveScene() {inAt: 16,sweep: 16,}),- label({- id: "resolve-footer",- text: "Composite · Grade · Animate · Render",- x: 0,- y: 960,- width: W,- align: "center",- size: 20,- color: STONE,- inAt: 28,- }),+ ...INSTALL.map((text, i) =>+ Layer.text(text, {+ id: `resolve-install-${i}`,+ position: "absolute",+ x: 0,+ y: 912 + i * 44,+ width: W,+ align: "center",+ fontFamily: MONO,+ fontSize: 26,+ fill: i === 0 ? INK : STONE,+ }).animate(+ LayerAnimation.create()+ .fadeIn(28 + i * 6, 38 + i * 6, "power2.out")+ .fromTo("y", 924 + i * 44, 912 + i * 44, { start: 28 + i * 6, end: 44 + i * 6, ease: EASE_OUT }),+ ),+ ),],}).animate(keys("scale", [[0, 1.0], [len, 1.035, "sine.inOut"]], LayerAnimation.create().fadeOut(len - 20, len - 4, "power2.inOut")),diff --git a/examples/19_gitframes_film/src/scenes/track.ts b/examples/19_gitframes_film/src/scenes/track.tsindex 9f13e86f..b83d097a 100644--- a/examples/19_gitframes_film/src/scenes/track.ts+++ b/examples/19_gitframes_film/src/scenes/track.ts@@ -21,8 +21,10 @@ import {type TrackedObject,VisionBundle,} from "gitframes";+import { EFFECTS_TO } from "./effects.js";import {asset,+ beats,chapter,EASE_OUT,EMBER,@@ -37,8 +39,9 @@ import {W,} from "../theme.js";-export const TRACK_FROM = 792;-export const TRACK_TO = 936; // 8 beats @ 100 BPM (4.8 seconds)+/** 23.4–26.4 s: the back half of the drop, ending on the score's final chord. */+export const TRACK_FROM = EFFECTS_TO;+export const TRACK_TO = TRACK_FROM + beats(5);/** 2.39:1 anamorphic letterbox bars */const BAR = Math.round((H - W / 2.39) / 2);@@ -325,8 +328,8 @@ export function trackScene(options: TrackSceneOptions = {}) {children: [dancerFullSilhouette, smokePlume],}).animate(LayerAnimation.create()- .fadeIn(4, 18, "power2.out")- .fadeOut(len - 18, len - 6, "power2.in"),+ .fadeIn(0, 10, "power2.out")+ .fadeOut(len - 14, len - 4, "power2.in"),);// 5. Subtle studio horizon guide@@ -417,7 +420,7 @@ export function trackScene(options: TrackSceneOptions = {}) {width: 800,size: 112,color: PAPER,- inAt: 8,+ inAt: 4,outAt: len - 16,}),...chapter({@@ -425,19 +428,19 @@ export function trackScene(options: TrackSceneOptions = {}) {index: "05",name: "Vision",color: PAPER,- inAt: 16,+ inAt: 10,outAt: len - 12,y: H - BAR / 2 - 11,}),label({id: "track-caption",- text: "Neural Tracking · Full Smoke Silhouette Blend · 35mm Spatial Analysis",- x: W - 96 - 920,+ text: "Tracking · Segmentation · Mattes",+ x: W - 96 - 700,y: H - BAR / 2 - 11,- width: 920,+ width: 700,align: "end",color: SAND,- inAt: 22,+ inAt: 14,outAt: len - 12,}),],diff --git a/examples/19_gitframes_film/src/shots.ts b/examples/19_gitframes_film/src/shots.tsindex ce6d177b..2f5df44f 100644--- a/examples/19_gitframes_film/src/shots.ts+++ b/examples/19_gitframes_film/src/shots.ts@@ -61,7 +61,7 @@ const section = (name: string, ms: number, styles: string[], avoid: string[] = [/*** Section durations mirror the film's scene cuts (see timeline in film.ts), so- * musical changes land exactly on picture changes.+ * musical changes land exactly on picture changes. They sum to 30 s, the film's length.*/export const SCORE = {positive_global_styles: [@@ -87,12 +87,13 @@ export const SCORE = {"guitar solo",],sections: [- section("Open", 3000, ["solo felt piano", "three sparse notes", "intimate", "lots of silence", "soft room reverb"], ["drums", "bass"]),- section("Film", 5400, ["warm string pad and deep sub swell enter on the downbeat", "slow cinematic chords", "felt piano melody continues"], ["drums", "kick"]),- section("Grade", 5400, ["plucked synth ostinato in eighth notes", "soft shaker", "gently building tension", "short riser in the last bar"], ["kick"]),+ section("Open", 2200, ["solo felt piano", "three sparse notes", "intimate", "lots of silence", "soft room reverb"], ["drums", "bass"]),+ section("Film", 4400, ["warm string pad and deep sub swell enter on the downbeat", "slow cinematic chords", "felt piano melody continues"], ["drums", "kick"]),+ section("Grade", 3600, ["plucked synth ostinato in eighth notes", "soft shaker", "gently building tension", "short riser in the last bar"], ["kick"]),section("Motion", 4800, ["the drop: punchy kick and tight snare land on the first downbeat", "driving bass", "plucked arpeggio", "confident groove"]),- section("Effects", 4200, ["full groove continues", "extra percussion fills", "short rhythmic stabs", "energetic"]),- section("Code", 3600, ["sudden low-pass filtered breakdown", "ticking clock-like hi-hat", "muted pulse", "suspense"]),+ section("Code", 4800, ["low-pass filtered groove", "ticking clock-like hi-hat", "muted pulse", "suspense", "riser into the next drop"]),+ section("Effects", 3600, ["second drop: full groove returns on the downbeat", "extra percussion fills", "short rhythmic stabs", "energetic"]),+ section("Vision", 3000, ["full groove continues", "shimmering arpeggio on top", "builds into the final hit"]),section("Resolve", 3600, ["one huge warm major chord hit on the downbeat with piano and strings", "long natural reverb tail ringing out through the entire section"], ["abrupt ending", "drums"]),],};diff --git a/examples/19_gitframes_film/src/theme.ts b/examples/19_gitframes_film/src/theme.tsindex ae353103..48e00fb9 100644--- a/examples/19_gitframes_film/src/theme.ts+++ b/examples/19_gitframes_film/src/theme.ts@@ -14,7 +14,8 @@ export const asset = (file: string) => path.join(ASSETS, file);export const W = 1920;export const H = 1080;export const FPS = 30;-export const DURATION_FRAMES = 1044;+/** The score's length: 30 s. Picture and music end together. */+export const DURATION_FRAMES = 900;/** 100 BPM → one beat every 0.6 s = 18 frames. Every cut lands on this grid. */export const BEAT = 18;diff --git a/examples/21_full_circle/src/generate-assets.ts b/examples/21_full_circle/src/generate-assets.tsindex 3951e1e7..a6099096 100644--- a/examples/21_full_circle/src/generate-assets.ts+++ b/examples/21_full_circle/src/generate-assets.ts@@ -37,6 +37,8 @@ const FONTS: Record<string, string> = {"https://github.com/google/fonts/raw/main/ofl/inter/Inter%5Bopsz%2Cwght%5D.ttf","InstrumentSerif-Italic.ttf":"https://github.com/google/fonts/raw/main/ofl/instrumentserif/InstrumentSerif-Italic.ttf",+ "JetBrainsMono.ttf":+ "https://github.com/google/fonts/raw/main/ofl/jetbrainsmono/JetBrainsMono%5Bwght%5D.ttf",};/** z-image wants multiples of 16; h3 keeps the still's aspect. */diff --git a/examples/21_full_circle/src/scenes/finale.ts b/examples/21_full_circle/src/scenes/finale.tsindex 42134da0..287b893c 100644--- a/examples/21_full_circle/src/scenes/finale.ts+++ b/examples/21_full_circle/src/scenes/finale.ts@@ -1,26 +1,39 @@/*** bar 17 – end — The moon. The title rises beneath it, the name orbits the- * moon one last time, the credit settles, and the picture and score fade out- * together.+ * moon one last time, the credit settles, the plugin install lines land at the+ * foot of the frame, and the picture and score fade out together.*/-import { LayerAnimation } from "gitframes";+import { Layer, LayerAnimation } from "gitframes";import { EDIT, ringAt } from "../edit.js";import { bar, DROP, DURATION } from "../grid.js";import {+ BONE,caption,DISPLAY,+ EASE_OUT,+ H,INK,line,+ MARGIN,+ MONO,orbit,plane,STONE,scene,+ W,} from "../theme.js";export const FADE = 24;const TITLE = 132;const TITLE_Y = 630;+/** Agent plugin installs: Claude Code (official directory, bare name), then Codex. */+const INSTALL = [+ "/plugin install gitframes",+ "codex plugin marketplace add gatewai-dev/gitframes",+];+const INSTALL_Y = H - MARGIN - 22;+export function finaleScene() {const from = bar(DROP + 6);const to = DURATION;@@ -57,6 +70,32 @@ export function finaleScene() {inAt: 30,color: STONE,}),+ // Either side of the lone figure, on the caption margin, so neither line crosses him.+ ...INSTALL.map((text, i) =>+ Layer.text(text, {+ id: `finale-install-${i}`,+ position: "absolute",+ x: i === 0 ? MARGIN : W / 2 + 80,+ y: INSTALL_Y,+ width: W / 2 - 80 - MARGIN,+ align: i === 0 ? "start" : "end",+ fontFamily: MONO,+ fontSize: 22,+ fill: BONE,+ }).animate(+ LayerAnimation.create()+ .fromTo("opacity", 0, 0.8, {+ start: 42 + i * 6,+ end: 52 + i * 6,+ ease: "power2.out",+ })+ .fromTo("y", INSTALL_Y + 12, INSTALL_Y, {+ start: 42 + i * 6,+ end: 58 + i * 6,+ ease: EASE_OUT,+ }),+ ),+ ),plane("finale-black", INK).animate(LayerAnimation.create().fromTo("opacity", 0, 1, {start: len - FADE,diff --git a/examples/21_full_circle/src/theme.ts b/examples/21_full_circle/src/theme.tsindex 871624f8..b991df99 100644--- a/examples/21_full_circle/src/theme.ts+++ b/examples/21_full_circle/src/theme.ts@@ -25,6 +25,7 @@ export const EMBER = "#6E3B12";export const DISPLAY = "Syne";export const SERIF = "Instrument Serif Italic";export const SANS = "Inter";+export const MONO = "JetBrains Mono";export async function registerFonts(): Promise<void> {await FontManager.register({ family: DISPLAY, source: font("Syne.ttf") });@@ -33,6 +34,7 @@ export async function registerFonts(): Promise<void> {source: font("InstrumentSerif-Italic.ttf"),});await FontManager.register({ family: SANS, source: font("Inter.ttf") });+ await FontManager.register({ family: MONO, source: font("JetBrainsMono.ttf") });}export const EASE_OUT = "expo.out";diff --git a/examples/22_gitframes_launch/src/scenes/outro.ts b/examples/22_gitframes_launch/src/scenes/outro.tsindex 21906b04..82ed4fcc 100644--- a/examples/22_gitframes_launch/src/scenes/outro.ts+++ b/examples/22_gitframes_launch/src/scenes/outro.ts@@ -1,7 +1,8 @@/*** The end. On "Gitframes." the logo and the name, extruded in 3D, whips in under an* orbiting camera; "Motion, compiled." builds word by word beneath it, and- * on the final hit the install line lands, held through the ring-out.+ * on the final hit the install line lands with the Claude Code and Codex plugin+ * installs beneath it, held through the ring-out.*/import { CameraAnimation, Layer, Layer3D, LayerAnimation } from "gitframes";import { BEAT, bar } from "../grid.js";@@ -19,6 +20,7 @@ import {label,logoMark,MONO,+ MUTED,plane,SNAP,scene,@@ -28,6 +30,12 @@ import {} from "../theme.js";import { CH, DURATION } from "../timeline.js";+/** Agent plugin installs: Claude Code (official directory, bare name), then Codex. */+const PLUGIN_INSTALL = [+ "/plugin install gitframes",+ "codex plugin marketplace add gatewai-dev/gitframes",+];+const CX = W / 2;const CY = H / 2;@@ -146,10 +154,32 @@ function lockup() {ease: EASE_OUT,}),),+ ...PLUGIN_INSTALL.map((text, i) =>+ Layer.text(text, {+ id: `final-plugin-${i}`,+ position: "absolute",+ x: 0,+ y: CY + 400 + i * 38,+ width: W,+ align: "center",+ fontFamily: MONO,+ fontSize: 24,+ fontWeight: 500,+ fill: i === 0 ? FG : MUTED,+ }).animate(+ LayerAnimation.create()+ .fadeIn(hit + 8 + i * 4, hit + 16 + i * 4)+ .fromTo("y", CY + 412 + i * 38, CY + 400 + i * 38, {+ start: hit + 8 + i * 4,+ end: hit + 22 + i * 4,+ ease: EASE_OUT,+ }),+ ),+ ),label({id: "final-url",text: "WebGPU motion engine",- y: H - 90,+ y: 52,inAt: hit + 16,color: FG,size: 20,diff --git a/package.json b/package.jsonindex f3c4fb90..359579ed 100644--- a/package.json+++ b/package.json@@ -13,6 +13,7 @@"changeset": "changeset","version:packages": "changeset version && node scripts/sync-plugin-version.mjs","sync:plugin-version": "node scripts/sync-plugin-version.mjs",+ "pack:plugin": "rm -f gitframes-plugin.zip && cd plugins/gitframes && zip -qrX ../../gitframes-plugin.zip . -x '*.DS_Store'","release:local": "turbo run build && pnpm -r publish --access public --no-git-checks","release:local:dry-run": "turbo run build && pnpm -r publish --dry-run --access public --no-git-checks","release:gitframes": "turbo run build && pnpm --filter gitframes publish --access public --no-git-checks",diff --git a/plugins/gitframes/plugin.json b/plugins/gitframes/plugin.jsonindex a33a273d..f2644cec 100644--- a/plugins/gitframes/plugin.json+++ b/plugins/gitframes/plugin.json@@ -4,10 +4,49 @@"version": "1.3.2","description": "Author, render and verify video compositions with the gitframes WebGPU SDK.","author": {- "name": "Gitframes"+ "name": "Gitframes",+ "url": "https://github.com/gatewai-dev"},"homepage": "https://github.com/gatewai-dev/gitframes","repository": "https://github.com/gatewai-dev/gitframes","license": "Apache-2.0",- "keywords": ["gitframes", "webgpu", "video", "composition", "motion-graphics"]+ "keywords": [+ "gitframes",+ "webgpu",+ "video",+ "composition",+ "motion-graphics"+ ],+ "extensions": {+ "com.openai": {+ "interface": {+ "displayName": "Gitframes",+ "shortDescription": "Code-first video on WebGPU",+ "longDescription": "Gitframes teaches your coding agent to make videos with code. The skills cover setting up a project with the gitframes npm package, building compositions (layout, typography, keyframed animation, 3D scenes, audio), applying effects and color grading, on-device vision such as subject cutouts and tracking, and rendering: single frames, contact sheets, and MP4 export with built-in QA. Everything renders natively on WebGPU in Node.js, without a browser or desktop creative suite.\n\nIntended for developers and agents producing motion graphics, product videos, and programmatic films. Limitations: the plugin contains skills only; rendering needs Node.js 22 or later and a WebGPU-capable GPU (Metal or Vulkan), and the vision features download open model weights from Hugging Face on first use. gitframes is in beta, so APIs may change.",+ "developerName": "Gitframes",+ "category": "Design",+ "capabilities": [+ "Set up a gitframes project",+ "Compose and animate video",+ "Apply effects and color grading",+ "Render frames, grids, and MP4"+ ],+ "websiteURL": "https://github.com/gatewai-dev/gitframes",+ "supportURL": "https://github.com/gatewai-dev/gitframes/issues",+ "defaultPrompt": [+ "Set up gitframes in this project and render a 3-second title card.",+ "Add film grain and a vignette to my gitframes composition.",+ "Render a frame grid of my intro so I can check the motion."+ ],+ "brandColor": "#3B82F6",+ "brandColorDark": "#7DD3FC",+ "composerIcon": "./assets/logo.png",+ "logo": "./assets/logo.png"+ },+ "onboardingSkill": "./skills/gitframes/SKILL.md",+ "publication": {+ "release_notes": "Adds the gitframes onboarding skill for setting up a project and a first verified render, and fixes the frame-grid example in gitframes-render."+ }+ }+ }}