Documentação / Referência

Perguntas frequentes

Respostas curtas para as dúvidas mais comuns sobre o Yuli, a IA, a segurança e o custo.

Geral

O Yuli é gratuito?

Sim. O IDE é baixado gratuitamente e não pede conta. A IA é paga por você: com a assinatura que você já tem (Claude Code, Kiro, Codex ou Antigravity) ou com a API key do seu provedor.

O que significa YULI?

Yield Unified Local Intelligent Framework for Orchestrated Generation & Execution. Veja O que é o Yuli.

Em quais sistemas ele funciona?

Windows, macOS e Linux, em 64 bits. Veja Instalar o Yuli.

Ele está pronto?

O Yuli está em Beta. Funciona para trabalho real, mas pode ter erros. Relate-os em Ajuda → Relatar um problema….

Para quais linguagens ele serve?

Tem realce de sintaxe para dezenas de linguagens e servidores de linguagem para Java, TypeScript, JavaScript, CSS, Python e Rust. Seu ponto mais forte é Java (incluindo sistemas legados com Ant, Eclipse, Struts e JSP) e o front-end web. Veja Editor e linguagens.

A IA

Preciso de uma API key?

Não. Por padrão, o Yuli trabalha com sua assinatura do Claude Code, Kiro, Codex ou Antigravity. A API key só é necessária no Modo Platform. Veja Conectar uma IA.

Posso usar um modelo local?

Sim. No Modo Platform, o provedor Local aceita servidores compatíveis com a API da OpenAI: Ollama, LM Studio, vLLM ou llama.cpp. Veja Modelos e provedores.

O Yuli modifica o Claude Code ou usa minha conta?

Não. O Yuli abre o claude que você instalou, com opções documentadas. Você mesmo faz login, com o fluxo oficial. O Yuli nunca toca nas suas credenciais.

O agente pode quebrar meu projeto?

Cada alteração passa pela janela Alterações da IA antes de chegar ao disco e deixa um ponto de controle. Você pode desfazer uma tarefa inteira com Ctrl+Alt+Shift+Z. Veja Revisar alterações.

O agente pode fazer push ou apagar minha branch?

Não sem que você peça. Git, CI e DevOps ficam bloqueados, exceto mediante pedido explícito, e mesmo assim cada ação pede aprovação. Criar branches exige um pedido próprio. No modo autônomo, git push não está disponível.

Em que idioma ele responde?

No idioma em que você escreve.

Por que o agente não termina até que tudo esteja verde?

É o critério de conclusão: se o turno alterou código, ele deve compilar, passar nos testes, iniciar e passar pela fase de Medição. Assim você não recebe trabalho pela metade apresentado como concluído.

Segurança e privacidade

Meu código sai do meu computador?

Só o que a IA que você escolheu lê, em direção a esse provedor. Antes de sair, os segredos são substituídos por um marcador. Com um modelo local, nada sai da sua rede. Veja Segurança.

O Yuli lê meus arquivos .env?

Não. Nem o agente do Yuli nem Claude Code, Kiro, Codex ou Antigravity podem ler .env, chaves privadas, certificados ou credenciais. Veja Segredos e privacidade.

Onde minhas API keys são guardadas?

No chaveiro do sistema operacional. Nunca no projeto.

O agente pode apagar dados do meu banco de dados?

Só se você der Superpermissões a essa conexão, com essa classe de instrução marcada, e aprovar cada instrução. Por padrão, ele só pode consultar. Veja Banco de dados seguro.

O Yuli envia telemetria?

O relatório de problemas só é enviado se você escolher, e nunca inclui seu código nem suas conversas. As métricas dos agentes são calculadas localmente.

Projeto e equipe

O Yuli altera meu repositório?

Por padrão, ele não escreve a configuração dos agentes dentro do projeto. O que ele guarda em .ai/ se divide entre o que é compartilhado com a equipe (contrato, memória, regras) e o que é local, que ele exclui do Git com .git/info/exclude. Ele nunca edita seu .gitignore. Veja A pasta .ai.

Posso impor regras de qualidade a toda a equipe?

Sim, com o contrato de qualidade em .ai/contract.json e o gate nos hooks do Git e na CI. Valem igualmente para pessoas e agentes.

Os commits dizem que foram escritos por uma IA?

Não. O Yuli nunca adiciona Co-Authored-By de uma IA nem “Generated with”. O autor é sempre a pessoa responsável.

Posso usar o Yuli com Cursor, Copilot ou Gemini CLI?

Eles não rodam dentro do Yuli, mas você pode exportar para eles as mesmas regras do projeto a partir da Central de Governança. Veja Kiro, Codex e Antigravity.