Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

docs(examples): add OpenCode provider setup example (#1021)

Felix-Ayushba2db082e140
diff --git a/docs/agent/OPENCODE.md b/docs/agent/OPENCODE.md
index ff35ab710..22ae3aa06 100644
--- a/docs/agent/OPENCODE.md
+++ b/docs/agent/OPENCODE.md
@@ -115,3 +115,7 @@ The provider enforces several safety measures:
- [OpenCode GitHub](https://github.com/anomalyco/opencode)
- [OpenCode Docs](https://opencode.ai/docs)
- [OpenCode Download](https://opencode.ai/download)
+
+## Example walkthrough
+
+Short smoke path: [examples/opencode/](../../examples/opencode/).
diff --git a/examples/README.md b/examples/README.md
index ee2fc0c32..ab4375feb 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -9,6 +9,7 @@ self-contained README under `examples/<name>/`.
|---------|----------------|
| [codex/](codex/) | Codex CLI setup: `repowise init --codex`, smoke checks, local plugin install |
| [health-coverage/](health-coverage/) | Code health, coverage ingest, and impacted-tests (no LLM key) |
+| [opencode/](opencode/) | OpenCode as the LLM provider for wiki generation |
## Conventions
diff --git a/examples/opencode/README.md b/examples/opencode/README.md
new file mode 100644
index 000000000..0c80cd3c7
--- /dev/null
+++ b/examples/opencode/README.md
@@ -0,0 +1,77 @@
+# OpenCode Example
+
+Use OpenCode as the LLM provider for Repowise wiki generation. OpenCode
+handles its own auth and model selection; Repowise does not store OpenCode
+API keys.
+
+Unlike Codex, there is no `repowise init --opencode` editor-integration flag
+today — this example covers the **provider** path documented in
+[docs/agent/OPENCODE.md](../../docs/agent/OPENCODE.md).
+
+## Prerequisites
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+opencode # first run: configure provider + auth
+opencode --version
+```
+
+Confirm Repowise sees the provider name:
+
+```bash
+repowise init --help | grep opencode
+```
+
+## Setup
+
+Index with OpenCode as the page-generation provider:
+
+```bash
+cd /path/to/your-repo
+repowise init --provider opencode --yes
+```
+
+Fast smoke without LLM wiki generation (index + graph/git/health only):
+
+```bash
+repowise init --index-only --yes
+```
+
+Then upgrade pages later with OpenCode:
+
+```bash
+repowise generate --provider opencode
+# or:
+REPOWISE_PROVIDER=opencode repowise update
+```
+
+Optional model selection (bare slug or `opencode/` prefix):
+
+```bash
+repowise init --provider opencode --model opencode/default --yes
+opencode models # list models OpenCode knows about
+```
+
+## Smoke Checks
+
+```bash
+opencode --version
+opencode models
+repowise status
+```
+
+Expected: OpenCode CLI responds, and `repowise status` shows an indexed repo
+after `init` completes.
+
+## What This Does Not Set Up
+
+OpenCode has no Repowise project-file / hooks / plugin integration yet
+(see the comparison table in [OPENCODE.md](../../docs/agent/OPENCODE.md)).
+For MCP + hooks + skills in an agent CLI, use the [Codex example](../codex/)
+instead.
+
+## Related docs
+
+- [OpenCode integration](../../docs/agent/OPENCODE.md)
+- [Codex example](../codex/) (editor + MCP + plugin path)
+- [CLI reference](../../docs/reference/CLI_REFERENCE.md)