---
title: TUI
description: Arquitetura do cockpit terminal `sdd tui`.
context: Componentes, eventos, runner, persistência e provider selection.
---

# TUI

O TUI vive em `src/tui/` e oferece uma experiência interativa sobre os mesmos comandos determinísticos.

## Módulos

| Módulo | Uso |
|---|---|
| `app.rs` | Estado da aplicação |
| `ui.rs` | Renderização |
| `event.rs` | Mapeamento de input |
| `runner.rs` | Execução de stages |
| `execution.rs` | Execução task-by-task |
| `orchestration.rs` | Lista e seleção de orquestrações |
| `stage.rs` | Definições de stage |
| `persist.rs` | Persistência local |
| `theme.rs`, `palette.rs` | Tema e cores |
| `components/` | Banner, status bar, modal, input, gauge e trace |

## Eventos

O runner emite eventos incrementais:

- `Trace`;
- `Context`;
- `Usage`;
- `Finished`.

Esses eventos alimentam a timeline, usage/custo, contexto e persistência final.

## Fallback

Quando o ambiente não tem TTY, `sdd tui` falha com orientação para usar subcomandos individuais.
