# Changelog
`oxframe-cli` is released together with the oxframe SDK crates under the
same version (see the SDK's
[CHANGELOG](https://github.com/oxygenframe/oxframe-sdk/blob/main/CHANGELOG.md)).
## 0.20.5 — 2026-10-22
- Creates projects on oxframe 0.20.5 (a new example, no API changes).
## 0.20.4 — 2026-10-22
- `oxframe dev`: after a rebuild while the video plays, the picture and the
sound go on together from the same frame (the editor started the sound
from the beginning over a still picture). Editor 0.1.6.
- `install.sh` finds the latest release without the GitHub API, which CI
runners hit the rate limit of.
## 0.20.3 — 2026-10-22
- Creates projects on oxframe 0.20.3: `oxframe check` no longer reports
text in nested layouts, text written on word by word or a moving sea as
mistakes.
## 0.20.2 — 2026-10-22
- Creates projects on oxframe 0.20.2: long text wraps inside title and end
cards, and centered text stays inside its box.
## 0.20.1 — 2026-10-22
- `oxframe mcp` can be listed in the official MCP Registry: `server.json`
and the `mcp-name:` line in this README.
- Creates projects on oxframe 0.20.1.
## 0.20.0 — 2026-10-21
- `oxframe render --jobs 4` passes the number of parallel segments to the
project; by default the project uses one per core, at most eight.
- Creates projects on oxframe 0.20.0.
## 0.19.0 — 2026-10-21
- Creates projects on oxframe 0.19.0.
- The agent cheat sheet covers 3D: `Scene3d`, meshes and materials,
`View3d`, the camera and lights, and 2D labels on 3D points; a reference
prompt in `evals/` puts a model in a diagram.
## 0.18.0 — 2026-10-21
- `oxframe present` opens the project as a presentation: full screen,
stopping at every `slide_break` and scene end; arrows, space, page keys
and clickers move between stops, N opens the speaker notes with a timer.
- `oxframe render --slides talk.pdf` writes one PDF page per stop.
- `oxframe render --subtitles out.srt` is passed to the project; before,
the CLI rejected the flag that the docs described.
- Creates projects on oxframe 0.18.0; the agent cheat sheet covers
presentations, and a reference prompt in `evals/` makes a talk.
## 0.17.0 — 2026-10-21
- Creates projects on oxframe 0.17.0.
- The agent cheat sheet covers `Matrix`, vectors and `apply_matrix` on
axes, and `Table` with animated rows.
- Reference prompts in `evals/`: matrix multiplication step by step and
a table that sorts itself.
## 0.16.0 — 2026-10-21
- Creates projects on oxframe 0.16.0.
- The agent cheat sheet covers icons: `icon!("lucide:server")`, the three
sets, `color()` and `stroke_width()`, and icons in `FlowDiagram`.
- Reference prompts for icons in `evals/`: an architecture diagram and a
row of brand logos.
## 0.15.0 — 2026-10-21
- Creates projects on oxframe 0.15.0.
- The agent cheat sheet covers `Video`: playing, pausing, seeking and
slowing down a clip, and the `video` feature it needs.
## 0.14.0 — 2026-10-21
- Creates projects on oxframe 0.14.0.
- `oxframe init --template node my-node` makes a library crate with a node
of your own (`#[derive(Node)]` plus `Draw`), a demo scene in
`examples/demo.rs` and a reference test.
- The agent cheat sheet covers nodes of your own.
## 0.13.0 — 2026-10-21
- Creates projects on oxframe 0.13.0.
- The agent cheat sheet covers charts: `Axes`, `axes.plot`, `point_on`,
`to_fn`, `bars`, `line_series`, `scatter` and `NumberLine`.
- Reference prompts for charts in `evals/`: a function that morphs and a
number line, and the benchmark and line prompts now expect the chart API.
## 0.12.2 — 2026-10-21
- Creates projects on oxframe 0.12.1.
- `list_components` in `oxframe mcp` showed calls that do not compile:
`BulletList::new().item(..)`, `CodeExplainer::caption`,
`FlowDiagram::node`, `Callout::new("text").point_at(..)` and arguments to
`enter`. It now shows the real API, each line checked against the SDK.
## 0.12.1 — 2026-10-21
Still creates projects on oxframe 0.12.0.
- `oxframe mcp` has `render_graph`: the render passes at one time, as
`oxframe inspect --graph` gives them but without the node tree. An agent
sees that `lens_drops` or `ripple` runs, or why a shader is skipped.
- The agent cheat sheet has a preset catalog (waves, particles, lens drops,
ripple, the water wipe, `Custom`) and says to make events signal changes,
not formulas of `ox.time`.
- Five reference prompts for shaders in `evals/`, from a sea under a title
to the whole ocean scene.
## 0.12.0 — 2026-10-21
- Creates projects on oxframe 0.12.0.
- The agent cheat sheet covers `shaders::lens_drops()`, `.wetness()`,
`Node::effect`, `shaders::ripple()`, `Transition::shader` and
`shaders::water_wipe()`, and when `check` reports `input_cycle`.
## 0.11.0 — 2026-10-21
- Creates projects on oxframe 0.11.0.
- The agent cheat sheet covers `shaders::waves()`, `.amp()`, `Shader::source`
and `Shader::file`.
## 0.10.0 — 2026-10-21
- Creates projects on oxframe 0.10.0.
- The agent cheat sheet covers `voice("one two").start()`, `.at_word()`,
`Project::tts`, `TtsProvider` and `oxframe render --subtitles out.srt`.
## 0.9.0 — 2026-10-21
- Creates projects on oxframe 0.9.0.
- The agent cheat sheet covers `sound`, `Audio::track`, `.play()`, `.trim()`,
`.priority()` and `.duck_under_voice()`.
## 0.8.0 — 2026-10-21
- Creates projects on oxframe 0.8.0.
- `oxframe inspect --graph` adds render passes to the scene JSON: a vector
pass, then a composite for each layer. Without the flag the JSON is unchanged.
## 0.6.0 — 2026-10-21
- Creates projects on oxframe 0.6.0.
- The agent cheat sheet and instructions describe scene transitions:
`transition(Transition::slide(Dir::Left)).await`, the other built-ins,
and a custom blend.
## 0.5.0 — 2026-10-20
- Creates projects on oxframe 0.5.0.
- The agent cheat sheet describes code diffs: `code().to(next, secs)` slides
tokens, and `insert`, `remove`, `replace` and `.flash()` edit one spot.
- The cheat sheet describes `Svg`: a file becomes groups, paths and images,
`find("id")` picks one element, `paths()` lists the contours.
## 0.4.0 — 2026-10-20
- Creates projects on oxframe 0.4.0.
- The agent files explain the `Camera` and that `.to(..)` takes theme tokens
and `&str` directly (no `.into()`).
- The new-project template no longer writes `.to("…".into(), …)`. In an
existing project, `oxframe upgrade` to 0.4.0 needs the same edit: drop the
`.into()` inside `.to(..)`.
## 0.3.0 — 2026-10-20
- Creates projects on oxframe 0.3.0 (`oxframe upgrade` moves existing ones).
- The agent files teach the new style: `stagger`, `all` over collections,
`any`, `repeat`, the node helpers (`fade_in`, `pop_in`, `slide_in`,
`draw_on`) and the `;`-in-a-closure fix. No `Box::pin` or `BoxFuture`.
## 0.2.6 — 2026-10-20
The first published release after 0.2.1: it also contains everything listed
under 0.2.2–0.2.5 below, which were not published separately.
### Added
- `oxframe mcp`, an MCP server on stdin and stdout. Tools: `check`,
`storyboard`, `render_frame`, `inspect`, `list_components`, `docs_search`
and `render`. Newline-delimited JSON-RPC, and `Content-Length` frames.
- `--json` on every command. One object on stdout. A compile error carries
the compiler text and a hint for the mistakes agents make most often: a
forgotten `.await`, a type mismatch, a method on the wrong value, a missing
type, a builder never passed to `add`, a name outside the prelude, the
wrong number of arguments, a builder used after `add`, `all` without its
tuple, and a text tween given an `&str`.
- Agent files link `llms.txt` and `llms-full.txt` for the project's docs series.
- Creates projects on oxframe 0.2.6 (`oxframe upgrade` moves existing ones).
## 0.2.5 — 2026-10-20
### Added
- Agent files list the explainer components (`TitleCard`, `BulletList`,
`CodeExplainer`, `FlowDiagram`, `Callout`, `LowerThird`, `EndCard`,
`ChapterMarker`) with a one-line example each.
- Creates projects on oxframe 0.2.5 (`oxframe upgrade` moves existing ones).
## 0.2.4 — 2026-10-20
### Added
- `oxframe render --aspect 16:9|9:16|1:1|all`. `all` writes one file per format
the project declares with `Project::aspects`.
- `oxframe check` lints each of those formats. Extra storyboards are
`storyboard-9x16.png` and `storyboard-1x1.png`.
- Creates projects on oxframe 0.2.4 (`oxframe upgrade` moves existing ones).
- Agent files describe `next_to`, `to_edge`, `pct` and aspects.
## 0.2.3 — 2026-10-20
### Added
- `[theme]` in `oxframe.toml` (`name`, `accent`) overrides the theme compiled
into the project for `dev`, `render`, `check`, `inspect` and `snapshot`.
- Creates projects on oxframe 0.2.3 (`oxframe upgrade` moves existing ones).
- Agent files mention theme tokens.
## 0.2.2 — 2026-10-20
### Added
- `oxframe check` now also lints the picture: it writes `out/check/storyboard.png`
and `report.json` (rule, severity, time, node, `file:line`, hint) and exits 1
when any issue is an error. `--frames` saves the storyboard cells at full size.
Thresholds are `[check]` in `oxframe.toml`.
- `oxframe inspect --at <seconds>` prints the scene tree at that time as JSON.
- Agent files (`AGENTS.md`, the Claude skill) tell the agent to run `oxframe check`
and read the storyboard after every visual change, and to name nodes with `.name()`.
- Creates projects on oxframe 0.2.2 (`oxframe upgrade` moves existing ones).
## 0.2.1 — 2026-10-20
- Creates projects on oxframe 0.2.1 (`oxframe upgrade` moves existing ones).
- `AGENTS.md` and the Claude Code skill link the docs and the docs.rs API
reference of the exact oxframe version the project is pinned to.
- README: development-status notice.
## 0.1.1 — 2026-10-20
- `oxframe dev` keeps the editor token per project
(`target/oxframe/dev-token`), so an open tab reconnects after a restart.
- A stale or missing token closes the editor connection with code 4401; the
editor says "Link expired" instead of reconnecting forever.
## 0.1.0 — 2026-10-19
First release: `init`, `dev` (editor with hot reload), `render`, `snapshot`,
`check`, `agents`, `upgrade`, and a daily update hint.