| name | tui-ux |
| description | Use when implementing or reviewing the Bubble Tea TUI, command palette, diff viewer, composer, approvals, session list, theme system, status line, local browser UI, or Tauri/SvelteKit desktop mode. |
TUI UX
Make agent state visible and actions reviewable.
Steps
- Identify the user workflow.
- Keep keyboard flow fast.
- Show mode, model, permissions, sandbox, and context usage.
- Preview risky actions and diffs.
- Stream tool events without log spam.
- Keep visual style polished but code-focused.
Avoid
- Decorative output that hides code or diffs.
- Modal flows that block reading important context.
- Long status messages in narrow panes.