# opencode-ralph-loop-cli
> "One command scaffolds the complete OpenCode Ralph Loop plugin setup — deterministic, auditable, zero runtime dependencies."
## Documentation
- [README](README.md)
- [How to Use](docs/HOW_TO_USE.md)
- [Cookbook](docs/COOKBOOK.md)
- [Integrations](INTEGRATIONS.md)
- [Cross-Platform Guide](docs/CROSS_PLATFORM.md)
- [AI Agent Guide](docs/AGENTS.md)
- [Contributing](CONTRIBUTING.md)
- [Security](SECURITY.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](CHANGELOG.md)
## Commands Reference
| Command | Purpose | Key Flags |
|---------|---------|-----------|
| init | Scaffold .opencode/ structure | --path, --force, --dry-run, --plugin-version |
| check | Detect template drift | --path, --strict, --exit-zero, --output |
| list | List embedded templates with hashes | --output |
| doctor | Verify environment dependencies | --output |
| uninstall | Remove tracked files | --path, --dry-run, --force, --keep-state |
| completions | Generate shell completions | shell (bash/zsh/fish/powershell/elvish) |
## Environment Variables
| Variable | Description | Default |
|---|---|---|
| `OPENCODE_RALPH_LOOP_CLI_OUTPUT` | Default output format | `text` |
| `OPENCODE_RALPH_LOOP_CLI_FORCE` | Enable force mode | unset |
| `OPENCODE_RALPH_LOOP_CLI_PLUGIN_VERSION` | Override plugin version | `1.4.7` |
| `OPENCODE_RALPH_LOOP_CLI_CONFIG` | Path to alternative config file | XDG default |
| `NO_COLOR` | Disable ANSI colors (community standard) | unset |
| `RUST_LOG` | Tracing log filter for verbose diagnostics | unset |
## Exit Codes
| Code | Name | Meaning |
|------|------|---------|
| 0 | success | Operation completed successfully |
| 1 | generic-error | Runtime error |
| 2 | usage-error | Invalid CLI argument |
| 3 | conflict | File conflict without --force |
| 4 | io-error | I/O error or permission denied |
| 5 | drift-strict | Drift detected in --strict mode |
| 6 | manifest-error | Manifest missing or corrupted |
| 7 | config-error | Config file parse error |
| 130 | sigint | Interrupted by SIGINT |
## Optional
- [Cookbook](docs/COOKBOOK.md) — 15 practical recipes
- [AI Agent Skill (EN)](skill/opencode-ralph-loop-cli-en/SKILL.md)
- [AI Agent Skill (PT)](skill/opencode-ralph-loop-cli-pt/SKILL.md)
- [Integrations](INTEGRATIONS.md)
Portuguese version: [llms.pt-BR.txt](llms.pt-BR.txt)