Skip to content
postscarcityaiPublic

About

Yui in the browser: the same threads and screens in a tab, live on the relay.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Yui in the browser

Meet Yui, a generative user interface. Your agent draws the screen instead of replying in walls of text: a timer, a form, a quick choice. You chat like normal, and when a button or a timer would work better than text, the agent puts one on the screen. Your taps go straight back to it.

This repo is Yui on Browser. It is new and mostly empty on purpose: it is the place to push when you build it, you or your agent.

No first pull request is open for this repo yet: see below.

What goes here

The web renderer the playground already uses, live on the relay. The spec is yuigui.com/developers/browser.

The first pull request (YUI-109, the thread offline at /web) is built in the hub, where the playground renderers live. The live app, from step 2 of the browser plan on (sign in, the outbox, push), is built here.

The contract

Every Yui, on every platform, keeps the same few promises. That is what makes it one app:

  1. It speaks Yui Lines. The agent sends one short line per screen, like timer 40/20x8 Tabata. The grammar is spec/YL.md, and your parser passes the shared conformance vectors.
  2. A tap sends the same line everywhere. The event a tap makes here is byte for byte the line the iPhone and the playground send. An agent cannot tell which device you used.
  3. Nothing breaks. A preset this device cannot draw shows "Open on your iPhone" instead.
  4. No brain of its own. Yui brings no model. Agents talk through the relay (spec/RELAY.md), and every client reads the same threads.
  5. No keys in the code. You never need ours, and we never ask for yours.

The vectors

conformance/ holds a copy of the hub's Yui Lines conformance vectors (spec/conformance/*.json in yuigui). Your parser must pass them. scripts/sync-vectors.sh refreshes the copy from a hub checkout, or from GitHub when there is none. Never edit the copies by hand; vectors change in the hub.

Run it

Node 20 or newer.

npm ci && npm test
npm run build

Every Yui

Platform Repo Built with
iPhone and iPad yui SwiftUI. The app on TestFlight today, the Hermes plugin, the backend
Mac yui-macos SwiftUI for macOS, native
Apple Watch yui-watch SwiftUI for watchOS
Apple Vision Pro yui-visionos SwiftUI for visionOS
Apple TV yui-tvos SwiftUI for tvOS
Android phones and tablets yui-android Kotlin and Jetpack Compose
Wear OS yui-wearos Kotlin and Compose for Wear OS
Windows and Linux yui-desktop Tauri 2 and the web renderer
Omarchy yui-omarchy Rust in the terminal, in your Omarchy theme
Browser yui-web (this repo) The web renderer, live on the relay
Spec, parsers, site yuigui Yui Lines, the conformance vectors, yuigui.com

The board with every card: yuigui.com/board. The roadmap: yuigui.com/roadmap.

Contributing

Humans and agents are both welcome. Agents, read AGENTS.md and CONTRIBUTING-AGENTS.md first. People: yuigui.com/contribute. Want this platform to do something no card covers? Write a short spec in the hub: copy docs/specs/TEMPLATE.md there and open a pull request.

License

Apache-2.0. Copyright 2026 PostScarcity AI.

About

Yui in the browser: the same threads and screens in a tab, live on the relay.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages