Vision, purpose, tenets, roadmap and status
workingRune is Anomaly's agent-built Rust GPU UI framework meant to feel like SwiftUI at 120 Hz on every platform, proven by recreating OpenCode Desktop. Its desktop and web runtime works and moves very fast, but the plan's render-thread/command-channel core, its own shells/IME, CI gates and several perf targets are missing, and PLAN, the crate README and the site have drifted from the code.
Summary (729 words)
Rune is a Rust UI framework that owns its renderer (one instanced uber-quad pass with 14 instance kinds), its text rasterisation (Parley shaping plus a port of CoreGraphics' glyph pipeline, calibrated against CoreText), its Taffy-based layout integration and its analytic-spring animation. It targets SwiftUI-on-ProMotion feel (120 Hz, interruptible springs, nothing pops) on macOS, Windows, Linux, the web and iOS, and it is written and checked by agents through headless rendering (--snap/--tree/--script/--trace). It exists because Anomaly's own surfaces were rebuilt three times in ten days on GPUI, Metal and SwiftUI. GPUI redraws whole windows, animates through main-thread view re-renders and has no layer compositing. Slint means a DSL and GPL/commercial licensing. SwiftUI is Apple-only. Flutter's web engine is a fork and its iOS text feels off. The users are Anomaly's own products: the flagship test is recreating OpenCode Desktop (an Electron/Chromium app) and beating it, the first real screen is Hex's Settings on three desktops, then Kit's Mac surfaces, the private iOS client by embedding, and Android last. The core ships no brand; OpenCode's theme is generated from @opencode/ui's Storybook and lives in themes/opencode.
Against PLAN's milestones: M0.5 (settings smoke test) is done. M1 (theming, kit gallery, docs site, playground, motion traces) is mostly done, but there is no inspector socket and no CI goldens. M2 (Hex Settings) is partial: Hex consumes Rune and AccessKit landed 2026-11-04, but there are no own shells or native IME. M3 (OpenCode Desktop) is started and active: parity fixes land daily and real-transcript perf studies exist, with the app outside the repo. M4 has its infrastructure (overlays, system materials, launcher example). M5 (web) is substantially built: the public anoma.ly/rune page is itself a Rune wasm app with a DOM mirror and static --html export. M6 has started on the embedding path (LayerHost on a CAMetalLayer, Metal backend on iOS) without UITextInput or split mode. M7 has not started. Spikes: S1 and S5 are done, S3 has a probe, S2 is answered by research/26 but PLAN still lists it open, S1b is unmet (the productised hot reload takes about 8 s save-to-GPU, against a 989 ms spike and a 300 ms goal), and S4 has not started.
The biggest gap is architectural. PLAN §3's "one boundary that matters", a serializable command channel between the app side and a render thread, does not exist. Animation runs on the main thread at frame time. Views still never re-run for animation, but the claim that a busy app can't stall motion is false. That also blocks split-process iPhone dev and channel replay. Instead, research 32-38 measured that missed frames come from rebuilding too much, not from Taffy or Parley, and optimised the main-thread path. Real-app frames are now mostly under 8.3 ms, with one known miss in a long-card scroll. Research 34 put Rune's own Metal backend in as the macOS default (2026-10-31), and research 35 kept wgpu on Vulkan and DX12. Text input still goes through winit's IME, and TextEdit stores a String, so the plan's own shells, the rope and the 100 MB file target were never attempted.
Tenets: the feel and motion rules hold strongly (motion audit, motion_gate, pixel snapping). Observability holds via CLI and files rather than a socket. The no-DSL rule holds, but the API is not small: 1,783 pub fns in core and 415 on El. The data-oriented rule slips, with 121 RefCell and 173 Rc in core. The fast-plus-reference rule is partial: rune-ref covers 7 of 14 kinds, springs have an RK4 oracle, and rune-taffy has a parity test.
Of the named risks, text quality is retired on macOS, while text input stays open. The OpenCode-look risk is worked actively but not quantified. Scope materialised as breadth: about 290 kLOC, 14 crates, Mermaid, GI lighting and video. Accessibility is largely retired on desktop.
Velocity: 1,630 commits in 17 days of public history (it starts with a 52 kLOC import on 2026-10-22). That is about 96 a day, peaking at 252, then slowing to 1,045, 485 and 100 per week as work moves to squash-merged PRs (up to #190). There are 476 changelog bullets plus 205 unfolded fragments. There is no CI for core tests: only site/www deploy and cargo test -p rune-www. The crate README's "Measured" and "Differences from PLAN.md" sections date from 2026-10-23, PLAN.md was last edited 2026-10-30, and the internal site repeats at least ten claims the code contradicts.
Why this maturity: Real apps (Hex, an OpenCode Desktop recreation, chat, notes, a task board) run on it on three desktops and the web, with 3,054 tests and measured perf work. But it is pre-release with no core CI, no render thread or command channel, IME still on winit, hot reload at about 8 s, several PLAN perf targets missed or unmeasured, and docs that lag the code by up to two weeks.
Issues, most severe first
www.yml:84 runs only cargo test -p rune-www; PLAN.md:428-429, 503-504crates/rune/README.md:2817-2818; PLAN.md:100-134; site/src/content.tsx:59-63; no channel code in crates/rune/srccrates/rune/README.md:2805-2821 (unchanged since 2026-10-23); site/src/content.tsx:204-208, 311, 335-337, 371; site/src/pages.tsx:111, 119-124, 197-205; PLAN.md:552crates/rune/src/window.rs:11,20; crates/rune/src/edit.rs:46-48; research/27-long-note-editing.md:6-9; PLAN.md:32, 211-218; WEB.md:256-258crates/rune/README.md:2679-2687, 2797-2799; PLAN.md:291-2985 more verified issues
crates/rune/README.md:645, 688, 2805; PLAN.md:505-520lib.rs export lines, about eleven overlapping scroll requests on Txcrates/rune/README.md:126-133, 369; CHANGELOG.md scroll_center entrypub fn lines, including ones in crate-private modules, so it overstates the exported API. The 296 lib.rs lines are right (28 pub mod + 268 pub use). '415 on El' is wrong: 415 is every pub fn in el.rs + el/**, including 61 on Tx. The impl El blocks hold 313. Tx has 14 scroll_* methods plus keep_on_screen, not about eleven.crates/rune-ref/src/shader.rs:167-251; crates/rune/src/render.rs:24-68PLAN.md:83-84; rg counts (el.rs 27 Rc, memo.rs 19)pack.rs; CHANGELOG header promises per-entry revs (2 of 476 have them); 205 unfolded fragmentsCHANGELOG.md:3-4; ls changelog/unreleasedpack.rs: both are 368 lines and 14 lines differ (the KIND_* constants are pub(crate) in one, private in the other). It came in with 2d92d377. The 205 fragments are right (plus a README). But 4 of 476 bullets carry a rev, not 2.Strengths
- A clear, well-argued vision with research notes behind each decision (35 notes, 9,355 lines), and decisions that follow measured evidence (Metal owned only after research/34; Taffy/Parley kept after research/32/37)
- Feel tenet carried into code: analytic springs with an RK4 oracle, per-edge layout motion, presence, reduced motion, pixel snapping that eases in, and a motion audit with about 15 finding kinds plus an in-test motion_gate
- Real consumers drive the work (Hex, an OpenCode Desktop recreation, chat, notes, a task board), with paired-median real-app perf studies (research/33, 37, 38) that cut team-chat resize p50 from 17.6 to 2.79 ms and eliminated over-budget frames in most interactions
- Idle cost met: a settings window went from 77 presents/20 s to 0; a resting window handles input about 0.3 ms after the event
- Web target is real enough to run the public homepage as a Rune app with a semantic DOM mirror and static HTML first paint
- AccessKit on all three desktops with a lazy tree and diffed updates; the a11y tree doubles as the automation surface
- Structure discipline enforced by scripts with zero exceptions on file size and folder shape; 3,054 tests
- Very high velocity: 1,630 commits in 17 days, 680+ app-visible changes logged
Key concepts
- Flagship test: Recreate OpenCode Desktop (Chromium/Electron) in Rune and beat it on look and feel across three desktops against real server data (
PLAN.md:573-581); lives outside the repo, shown in demo/opencode - Tenets: Feel is the product; animation never through app code; everything observable; one way to do things; native behaviour, one look; owned not wrapped; optimise for perf/correctness/change speed over readability (
PLAN.md:69-98) - Command channel / render thread: PLAN's central architecture: a serializable app-to-render-thread protocol enabling busy-app-proof animation, split-process iPhone dev and replay. Not implemented; animation runs on the main thread
- Unbranded theming: rune::Theme as data, rune-kit Kit token schema, OpenCode theme generated from @opencode/ui Storybook via
themes/opencode/tools/theme.mjs - Fast path plus reference path: Tenet 7: each hard subsystem has a CPU oracle; realised as rune-ref (7 of 14 kinds), the spring RK4 test and the rune-taffy parity test
- Agent-native verification: Every app renders headless (--snap/--tree/--script/--video/--html), motion audit and motion_gate, AccessKit tree as the agent tree; no inspector socket
- Measure-then-own: Dependencies replaced only on measurement: own Metal (research/34), keep wgpu on Vulkan/DX12 (research/35), keep Taffy/Parley (research/32, 37)
- Milestones M0-M7: Spikes; smoke test; theming/gallery/site; Hex Settings; OpenCode Desktop; Kit Mac surfaces; Web; iOS; Android
Opportunities
Run cargo check --workspace --all-targets and cargo test -p rune -p rune-kit --features rune-kit/markdown on Linux with lavapipe (VK_ICD_FILENAMES already documented), plus
scripts/file-size.sh and the alloc testsMark S2 done, record the Metal decision in PLAN §4.2, rewrite 'Differences from
PLAN.md' and 'Measured', fix the site's stale principles and statuses; agents read these firstEither build the app-to-render command channel starting with live values, scroll offsets, drags and Scene tracks, or retire the wording and extend the GPU-evaluated springs spike (
gpu/springs.rs) so transform/opacity motion survives a blocked main thread at one uniform write per frameImplement NSTextInputClient/TSF directly and a composite multi-paragraph TextLayout (research/32) or rope so typing reshapes one paragraph; this unblocks M2/M3 composers and fields
Gate instances, allocations, glyphs and layout nodes per scene (PLAN tenet 7), with the motion-audit gate as a hard failure
Add CPU oracles for images, segments/triangles (icons, Mermaid), layers and backdrop blur
Commit per-story similarity/off numbers from
scripts/kit-diff.py so risk 2 (matching OpenCode's look) is tracked quantitativelyBring the web --html first-paint idea to native (a cached first frame per appearance/size) to close the 300 ms vs 150/50 ms launch gap
Numbers, key files, roadmap and the verifier's additions
Numbers
- Public history
- 1,630 commits, 2026-10-22 to 2026-11-07 (17 days), starting from a 52,432-line import
- Commits per week
- 1,045 (Oct 22-28), 485 (Oct 29-Nov 4), 100 (Nov 5-7)
- Peak day
- 252 commits (2026-10-23)
- Line churn
- +420k/-126k (Oct 22-31), +63k/-12k (Nov 1-7)
- Authors
- 10; top author 1,472 of 1,630 commits
- PR-numbered commits
- 56, up to #190
- Changelog
- 476 bullets in
CHANGELOG.md## dev plus 205 unreleased fragments - Rust lines
- about 289,640 total; crates/rune 176,200 in 780 files; rune-kit 40,152; rune-mermaid 13,283
- Tests
- 3,054 #[test] (rune 2,147, rune-kit 450, rune-mermaid 138, rune-motion 93)
- Crates
- 14 in crates/ plus themes/opencode; 29 examples
- Public API
- 1,783 pub fn in crates/rune/src; 415 on El; 296 pub use/mod lines in
lib.rs - Research notes
- 35 files, 9,355 lines
PLAN.mdedits- 9 commits, last 2026-10-30
- Launch (Mac, from open)
- about 300 ms content on screen (target p50 150 ms)
Key files
PLAN.md Direction: short version and layer table (L6-43), why (L45-67), tenets (L69-98), architecture (L100-134), hot reload (L279-329), agent tooling (L331-362), guarantees (L364-396), design language (L474-498), perf targets (L500-521), risks (L523-542), milestones (L544-589), Anomaly fit (L591-599), open questions (L601-609), web status (L611-617)README.md Public pitch: native GPU Rust UI for macOS/Windows/Linux/web, headless agent loop, pin dev revs, no PRs, MITAGENTS.md Repo rules: dev is fast-forward-only, changelog fragments, file-size/folder-shape caps, literal-built types, perf rules, public-repo hygienecrates/rune/README.md Main doc and feature inventory; 'What exists' (L8-298), Launching fast with measured launch numbers (L643-717), Accessibility (L2259-2299), Live Rust editing (L2664-2799, about 8 s save-to-GPU), stale 'Measured' (L2801-2810) and 'Differences from PLAN.md' (L2812-2821)WEB.md Web target: winit canvas, async GPU, sliding textarea, web_document mode with DOM mirror, --html static export; explicitly defers PLAN's own-shell switch (L253-259)site/src/content.tsx Internal site's principles, layers, decisions, milestones (statuses L464-550) and risks; has several stale claims (L59-63, L204-208, L311, L335-337, L371)site/README.md Site hosting (anoma.ly/team/rune behind Cloudflare Access); says PLAN.md is the source of truthwww/app/src/sections.rs Public homepage, itself a Rune wasm app; the current public pitch including OpenCode as the test and five platformsCHANGELOG.md 476 app-visible changes under one '## dev' section; the header claims per-entry revs, but only 2 have themchangelog/unreleased/ 205 unfolded fragments since 2026-10-29; shows recent direction (Metal default, iOS embed, AccessKit, web document, Windows chrome, OpenCode parity)Roadmap items
- Next per PLAN/site: finish M2 (Hex Settings on Mac, Windows, Linux with own shells and native text input), then M3 (OpenCode Desktop main screens side by side and clearly better)
- Code trajectory this week: Windows chrome (popup menus, custom titlebar, dark menus, shared textures), OpenCode/@opencode/ui parity (form controls, Markdown CSS, scroll bars, file icons), web document pages and static export, accessibility polish
- Unscheduled in plan but implied: S1b fast patch to 300 ms, S4 split mode, inspector socket, live literals, CI gates, pre-rendered first frame, 1M-row and 100 MB workloads
- M5 follow-ups named in PLAN §13: real-device Safari keyboard, WebGL fallback, EditContext
- M6: iOS shell and UITextInput beyond the existing LayerHost embedding; M7 Android
Found by the verifier
www/app/Cargo.toml:17; crates/rune-kit/Cargo.toml:9; crates/rune/Cargo.toml:8; .github/workflows/www.yml:40,84WEB.md and PLAN say it does notWEB.md says 'It has no WebGL fallback', and PLAN §13 lists it as follow-up work. The notes repeat this stale claim in the M5 row. This is code ahead of its docs, the reverse of the drift the notes catalogue.crates/rune/Cargo.toml:13-14; crates/rune/src/platform/web.rs:238-270; git 61f46dce (2026-10-29); WEB.md:230; PLAN.md:616research/26-system-material-sync.md:25-31,40-60crates/rune/README.md:645,705-712; PLAN.md:502,507