Começando

Primeiros passos

Do zero à primeira melhoria de texto em cerca de cinco minutos.

Instale e inicie o Ollama

Baixe em ollama.com/download e baixe o modelo padrão:
```
ollama pull llama3.2
ollama serve
```
Instale o Kraa

Com Node.js 18+:
```
npm i -g @gustavofsilva/kraa && kraa start
```
Sem Node, use o script de instalação. O ícone aparece na bandeja do sistema.
Confira se está tudo certo
```
kraa doctor
```
O diagnóstico verifica o binário, a configuração, a conexão com o LLM e, no Linux, o xdotool e a sessão (X11/Wayland).
Selecione um texto e aperte o atalho

Em qualquer app, selecione um texto e aperte ⌘⇧Y no macOS ou CtrlShiftY no Windows e Linux. O modal abre com o texto capturado.
Escolha uma ação

Navegue com as setas e aperte Enter, ou digite o que deseja na busca: se nenhuma ação combinar, o texto vira uma instrução livre. O resultado aparece em stream.
Substitua ou copie

⌘/CtrlEnter cola o resultado no lugar da seleção original. ⌘/CtrlShiftC só copia. Esc fecha e cancela o stream.

macOS: permissão de Acessibilidade

Na primeira execução o macOS pede a permissão de Acessibilidade para simular ⌘C e ⌘V. Sem ela, só “Copiar” funciona. Veja macOS.

Sem seleção

Se nada estiver selecionado, o modal abre vazio e editável: cole ou digite no campo Texto a melhorar e escolha uma ação normalmente.