Every spec, in the open.
How Yui works, written down. Start with Yui Lines, the screen language. These pages are built from the same files as the repo, so they never drift.
Values
What makes a screen feel like Yui: eight rules every agent, brief and page is held to.
Yui Lines
The screen language: one short line per element, every preset and its options.
Channel guide
What every agent on the Yui channel is told, and the eval that scores it.
Reactions
Hold a message and react. What each of the six tells your agent to do.
Benchmark
Yui Lines against JSON, token by token, on ten real screens.
Agents
How an agent gets into Yui: pairing codes, the host API, names and colors, and sharing agents with the people you invite.
Agent controls (draft)
The drawer's Agent tab (the Controls areas under About): your agent's personality, memory, skills and schedules, changed straight on its host with no chat turn. Secrets never leave the host.
Talk about this (draft)
Bring one of your agent's settings into the chat, talk it over, and apply the agent's before and after with one tap, through the same Controls path.
Restyle Yui (draft)
Ask any agent to make Yui feel like autumn: a preview beside the look you have, one tap to apply, one to undo, and the contrast guard in between.
Release timeline
Where the next version stands, live from the board: the cards in the release, the ship steps and what is on main since the last build.
Speed budget (draft)
What fast means for Yui in milliseconds: typing, sending, a message landing, swipes, launch, hangs, hitches and memory, and how the phone reports them.
Relay
How messages travel between your machine and the app, and how push works.
Group threads (draft)
Several of your agents in one conversation: who answers, how a handoff shows, the loop guard, and how a group is stored.
Chats (draft)
Several chats with one agent, listed in the drawer: New chat, titles, rename and delete, and what the agent remembers across them.
Agent home (draft)
Every agent's home: its own shortcuts, what is waiting on you, and starter screens a swipe away, set with Yui Lines words that already exist.
Adapters
Every agent framework Yui plans to reach, Hermes first, and in what order.
Hosting
Where Yui's hosted connector runs (Cloudflare, beside the Supabase relay), what it costs, and why.
OpenClaw
Your OpenClaw agent in Yui: install the channel plugin, pair, and what the agent is told.
Webhook bridge
Any agent that answers an HTTP POST, in Yui: what each turn sends and what to answer.
A2A bridge
Add any A2A agent (ADK, LangGraph, CrewAI) by its Agent Card: how turns, tasks and restarts map.
AG-UI bridge
Add any AG-UI agent (Agent Framework, CopilotKit, Mastra) by its URL: screens as a tool the agent calls, the tap as its result.
Model bridge
A model you run yourself (Ollama, LM Studio, vLLM) in Yui: what it is sent each turn, and how restarts work.
Browser (draft)
Yui in a browser tab: Sign in with Apple, the same relay and renderer, and what each preset does there. Open for contributors.
macOS (draft)
Yui for macOS: a native Mac app on the same account, the drawer as a sidebar, a keyboard map, and what each preset does there. Open for contributors.
Telegram
Yui Lines in Telegram: questions as buttons, the rest in a Mini App, taps back as the phone's line.
MCP server
Any MCP client (Claude Code, Cursor, n8n) puts a screen on your phone and reads the taps back.
Flows
Saved series of screens written in Mermaid: steps on the nodes, conditions on the edges, one event at the end.
Onboarding
The first run: Yui asks three quick questions on full screens and suggests your first agents. A saved flow you can run in the playground.
The model on the phone (draft)
Apple's on-device model in Yui: reply chips under a screen, the right agent in a group, a push line that says something, and a draft screen offline. Nothing leaves the phone.
Key vault (draft)
Your fal, Replicate, OpenRouter, Anthropic and OpenAI keys in the iPhone's Keychain. Agents ask to use one, get a handle, never the key, and spend inside a cap you set.
Widgets and Siri (draft)
Saved screens on the home screen and the lock screen, kept current by pushed patches, with buttons that tap back, and Siri, Shortcuts and the Action button.
Native Yui (draft)
Every person gets their own Yui at sign-in, plus a starter crew: where it runs, the profile format, GLM 5.2 on OpenRouter, 100 free turns a month, then your own key.
Hermes for everyone (draft)
Tier 2: a real Hermes of your own in a sandbox that sleeps when idle, on Beam first, paired with no code.
Starter agent (superseded)
An agent that answers on first launch, no computer needed: where it runs, which model, what it may do, the safety caps and what it costs at 100 to 10,000 people.
Connectors
Log in to your tools once: Google Calendar, Gmail and HubSpot through their own MCP servers. What each allows, in plain words, and who holds the sign-in.
Agent tables
Data an agent keeps on your phone: a workout log, macros, a small CRM. Three words, and the rows never leave the phone.
Encrypted sync (draft)
Whether v1 needs tables on two devices (no), and the design for when it does: end to end encrypted, off by default, paired by QR, no new account.
Meal photo to macros
Snap a meal, get a macro estimate that says how sure it is, fix the portion, and save it to your meals table. Two replies, no new words.
Music tools (draft)
A musician's best friend: a looper, drum pads, an easy keyboard, chord buttons, a tuner and a metronome, one line each, on one sound engine.
Games (draft)
Draft: how an agent could describe a whole new game in lines, a board kit with rule words, not code.
Ledger (draft)
The private ledger behind use to earn: facts about use and contributions back to day one, never what anyone said, and how it switches on.
Preset flywheel
How custom screens agents keep sending become presets: the shape log, the weekly report and the checklist.
Admin console (scope)
Who runs Yui from the top: five roles, what each controls, why it lives in the app, and what admins can never see.