ryu-timeline

Timeline for Ryu — a CapCut-style scrubber over Shadow's captured screen/input/window/audio lanes with keyframe preview, a Dayflow work journal, and jump-to-moment focus.

The public home of ryu-timeline. Source, builds, and releases live here — binaries for every platform are attached to each release.

This tree is generated from the Ryu monorepo, so commits pushed here directly are replaced on the next sync. Pull requests are welcome — open them here and they are ported into the monorepo, then flow back out. Ryu as a whole: https://github.com/amajorai/ryu

Source & build

This is the source of record for the app UI. It imports Ryu's private @ryu/ui design system, so it does not build standalone outside the monorepo — it builds inside the amajorai/ryu monorepo workspace. The shipped bundle below is the built artifact: a prebuilt single-file companion bundle is included at dist/timeline.ui.html — the runnable UI Ryu loads for this app.

License

Apache-2.0 — see LICENSE.

---

@ryu/timeline — Timeline

The activity replay timeline: a CapCut-style scrubber over Shadow's captured screen/input/window/audio/AX/clipboard/git lanes, with a keyframe preview player, a Dayflow work journal, and jump-to-moment focus. A read-only view over what Shadow already captured locally.

Parts

• ui/ — companion (@ryu/timeline-app). A sandboxed full-page Companion (Path B, ui_format: "html"), built to one self-contained dist/index.html via vite-plugin-singlefile, consuming @ryu/ui (tree-shaken into the bundle). No backend crate of its own — it reads Shadow's local /timeline + /journal + /frame endpoints through the bridge, every call over window.ryu.

Manifest (manifest.json)

• id @ryu/timeline · one companion runnable (Timeline, icon timeline).
• Grant: timeline:read — the read-only bridge capability the companion drives Shadow's timeline/journal/frame surface through.
• No sidecar: the data lives in the already-running Shadow capture service.

Surface

Registers as the Timeline companion in the desktop app store / launcher. Read-only: scrub lanes, preview keyframes, browse the Dayflow journal, jump to a moment.

Swap seam

The companion binds to the timeline:read capability, not to Shadow directly — any capture backend that serves the same timeline/journal/frame contract behind that grant can back the view without touching the UI.