> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ziro-agent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Terminal UI

> The Textual front end: streaming transcript, side pane, status footer, themes, and modals.

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.

<Note>
  This page is in progress. For the command surface it drives, see
  [slash commands](/interfaces/commands); for launch flags, see the
  [CLI reference](/reference/cli).
</Note>

<Columns cols={2}>
  <Card title="Slash commands" icon="terminal" href="/interfaces/commands">
    Keyboard equivalents and the mid-turn popup rules.
  </Card>

  <Card title="Permissions" icon="shield" href="/guides/permissions">
    What raises the approval modal.
  </Card>
</Columns>