# opencode-ralph-loop-cli
> "Um único comando gera a estrutura completa do plugin OpenCode Ralph Loop — determinístico, auditável, sem dependências em tempo de execução."
## Documentação
- [README](README.md)
- [Como Usar](docs/HOW_TO_USE.md)
- [Cookbook](docs/COOKBOOK.md)
- [Integrações](INTEGRATIONS.md)
- [Guia Cross-Platform](docs/CROSS_PLATFORM.md)
- [Guia para Agentes de IA](docs/AGENTS.md)
- [Contribuindo](CONTRIBUTING.md)
- [Segurança](SECURITY.md)
- [Código de Conduta](CODE_OF_CONDUCT.md)
- [Histórico de Mudanças](CHANGELOG.md)
## Referência de Comandos
| Comando | Finalidade | Flags Principais |
|---------|-----------|-----------------|
| init | Gerar estrutura .opencode/ | --path, --force, --dry-run, --plugin-version |
| check | Detectar desvio de templates | --path, --strict, --exit-zero, --output |
| list | Listar templates embutidos com hashes | --output |
| doctor | Verificar dependências do ambiente | --output |
| uninstall | Remover arquivos rastreados | --path, --dry-run, --force, --keep-state |
| completions | Gerar completions de shell | shell (bash/zsh/fish/powershell/elvish) |
## Variáveis de Ambiente
| Variável | Descrição | Padrão |
|---|---|---|
| `OPENCODE_RALPH_LOOP_CLI_OUTPUT` | Formato de saída padrão | `text` |
| `OPENCODE_RALPH_LOOP_CLI_FORCE` | Ativar modo force | não definido |
| `OPENCODE_RALPH_LOOP_CLI_PLUGIN_VERSION` | Sobrescrever versão do plugin | `1.4.7` |
| `OPENCODE_RALPH_LOOP_CLI_CONFIG` | Caminho para arquivo de config alternativo | padrão XDG |
| `NO_COLOR` | Desativar cores ANSI (padrão da comunidade) | não definido |
| `RUST_LOG` | Filtro de log de rastreamento para diagnósticos detalhados | não definido |
## Códigos de Saída
| Código | Name | Significado |
|--------|------|-------------|
| 0 | success | Operação concluída com sucesso |
| 1 | generic-error | Erro em tempo de execução |
| 2 | usage-error | Argumento CLI inválido |
| 3 | conflict | Conflito de arquivo sem --force |
| 4 | io-error | Erro de I/O ou permissão negada |
| 5 | drift-strict | Desvio detectado no modo --strict |
| 6 | manifest-error | Manifesto ausente ou corrompido |
| 7 | config-error | Erro ao interpretar arquivo de configuração |
| 130 | sigint | Interrompido por SIGINT |
## Opcional
- [Cookbook](docs/COOKBOOK.md) — 15 receitas práticas
- [Skill para Agente de IA (EN)](skill/opencode-ralph-loop-cli-en/SKILL.md)
- [Skill para Agente de IA (PT)](skill/opencode-ralph-loop-cli-pt/SKILL.md)
- [Integrações](INTEGRATIONS.md)
Versão em inglês: [llms.txt](llms.txt)