---
title: Usar TUI
description: Como operar o cockpit terminal do SDD.
context: Uso do `sdd tui`, provider selection, eventos e fallback.
---
# Usar TUI
O TUI é a experiência terminal para conduzir stages, escolher provider/model/effort e acompanhar eventos incrementais.
```bash
sdd tui
```
## Fluxo básico
1. Abra o TUI no root do projeto.
2. Escolha provider, modelo inicial e effort.
3. Selecione a orquestração ou crie uma nova.
4. Gere ou regenere artefatos.
5. Verifique trace, contexto, usage e resultado.
6. Saia do TUI e valide com `sdd eval`/`sdd quality`.
## Adapters diretos
| Codex | `codex exec --json` | Permitida nesta versão |
| Claude Code | `claude --print` | Bloqueada sem adapter explícito |
| opencode | `opencode run` | Bloqueada sem adapter explícito |
| Cursor Agent | `cursor agent --print` | Bloqueada sem adapter explícito |
| Devin | `devin --print` | Bloqueada sem adapter explícito |
| Trae | `trae-cli run` isolado | Bloqueada sem adapter explícito |
| Antigravity | `agy --prompt` | Bloqueada sem adapter explícito |
Provider sem adapter de escrita deve falhar antes de mutar arquivos.
## Ambientes não interativos
Se o terminal não for TTY ou `TERM=dumb`, use os subcomandos:
```bash
sdd idea "..."
sdd prd "..."
sdd techspec "..."
```