---
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` | `codex exec --sandbox workspace-write` |
| Claude Code | `claude --print` | `claude --permission-mode acceptEdits` |
| opencode | `opencode run` | `opencode run --dangerously-skip-permissions` |
| Cursor Agent | `cursor agent --print` | `cursor agent --force` |
| Devin | `devin --print` | `devin --permission-mode dangerous` |
| Trae | `trae-cli run` isolado | `trae-cli run --working-dir <root>` |
| Antigravity | `agy --prompt` | `agy --dangerously-skip-permissions` |
Provider sem adapter de escrita deve falhar antes de executar o client.
## Ambientes não interativos
Se o terminal não for TTY ou `TERM=dumb`, use os subcomandos:
```bash
sdd idea "..."
sdd prd "..."
sdd techspec "..."
```