Skip to content

Interface

The TUI is v1.x polish, not part of the acceptance slice (see Orientation). The two documents here are the v1 contract if it ships:

  1. Specification — the vocabulary, glyphs, wireframes, keymaps, toasts, mouse behavior, fallbacks, and the [ui] configuration surface.
  2. Storyboard — one developer's end-to-end story (porting an iOS app to Android, with a docs repo and a marketing-site fix along the way) that exercises every branching, merging, and abandoning pattern the rest of the book commits to.

The specification is the rulebook; the storyboard is the movie. When they disagree, the specification wins, and the storyboard has the bug.

The storyboard invents nothing: no new commands, flags, output strings, glyphs, or screen elements. Every beat in it traces back to Threads, Cascade, Publishing, Commands, spec.md, or Invariants. If a beat seems to need behavior the rest of the book does not authorize, that is a bug to report — not permission to extend the interface.

docs/reference · built with VitePress