---
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

| Provider/client | Geração | Escrita no workspace |
|---|---|---|
| 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 "..."
```
