Skip to content

Code-first video & image, rendered natively on WebGPU.

showcases

okanasl38e74aa7d694
diff --git a/.gitignore b/.gitignore
index 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.zip
diff --git a/README.md b/README.md
index 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
+```
### Codex
diff --git a/assets/showcase/dancer.jpg b/assets/showcase/dancer.jpg
new file mode 100644
index 00000000..8d8bdebf
Binary files /dev/null and b/assets/showcase/dancer.jpg differ
diff --git a/assets/showcase/full-circle.jpg b/assets/showcase/full-circle.jpg
new file mode 100644
index 00000000..e20306a7
Binary files /dev/null and b/assets/showcase/full-circle.jpg differ
diff --git a/assets/showcase/gitframes-launch.jpg b/assets/showcase/gitframes-launch.jpg
new file mode 100644
index 00000000..ce42c9ef
Binary files /dev/null and b/assets/showcase/gitframes-launch.jpg differ
diff --git a/examples/19_gitframes_film/src/film.ts b/examples/19_gitframes_film/src/film.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.json
index 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.json
index 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."
+ }
+ }
+ }
}