sdd-layer 0.15.3

Spec-Driven Development CLI and agent harness
---
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` | 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 "..."
```