Skip to main content
This page will cover the Textual terminal UI you get from a bare ziro on a TTY. It documents the streaming transcript (reasoning deltas collapse to a thought for Ns line, tool calls render inline, and the final answer commits as Markdown) alongside the side pane (todos, active tools, active plugins), the status footer with its context meter that reveals at 50% of the usable input budget and shades toward the compaction trigger, the theme system (ziro by default, plus carbon, nord, and gruvbox), and the two human-in-the-loop modals: the approval modal for gated tool calls and the question modal for ask_user_question. It also covers the instant-shell behaviour, where the UI paints before the engine is built and queues anything you type in the meantime.
This page is in progress. For the command surface it drives, see slash commands; for launch flags, see the CLI reference.

Slash commands

Keyboard equivalents and the mid-turn popup rules.

Permissions

What raises the approval modal.