Solução de problemas

Causa: o servidor do LLM não está respondendo em provider.base_url.

Solução: inicie o Ollama com ollama serve e confira se o modelo existe com ollama list. Com provider remoto, confira base_url e api_key (um HTTP 401/403 no doctor indica chave inválida).

Causas possíveis:

• macOS: falta a permissão de Acessibilidade (veja como conceder).
• Linux X11: xdotool não instalado (sudo apt install xdotool).
• Wayland: não há captura automática; aperte CtrlC antes do atalho.
• App lento: a captura espera até 400 ms pela área de transferência. Apps muito lentos para responder ao “Copiar” simulado podem resultar em “nenhum texto selecionado”. Tente de novo ou cole o texto no campo.

A colagem automática não está disponível: sem permissão de Acessibilidade (macOS), sem xdotool (X11) ou no Wayland. Use Copiar e cole manualmente.

Outro app pode estar usando a combinação: o modal mostra um aviso nesse caso. Troque hotkey no config.yaml e use Recarregar configuração. No Wayland, configure um atalho do sistema.

Se ele não era texto (imagem, arquivos), a captura não consegue restaurá-lo. Veja Privacidade.

As teclas simuladas usam keycodes ANSI. Em layouts que não são ANSI, a tecla física pode não corresponder a ⌘C/⌘V.

Causa: o macOS guarda o ícone do app em cache, inclusive na lista de Acessibilidade.

Solução: em Ajustes do Sistema → Privacidade e Segurança → Acessibilidade, remova o Kraa com ”−” e adicione de novo (isso também renova a permissão, necessária a cada versão). Se o ícone antigo continuar no Dock ou no Finder, rode killall Dock.

O app de destino provavelmente roda como administrador. Por causa do UIPI a colagem é bloqueada: use Copiar.

Instale as dependências de runtime: sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0.

O config.yaml tem YAML inválido ou falhou na validação. A mensagem indica o campo. Corrija e use Recarregar configuração.

O texto passou de max_input_chars (padrão: 20000). Aumente o valor no config.yaml ou envie um trecho menor.