The docs map for this workspace. Start with the root README for the overview and install; come here when you need depth on a specific topic.
| Page | When you need it |
|---|---|
| architecture.md | Hooks, token lifecycle per flow, cache layout, sync scheduler, logging |
| well-known.md | .well-known/opencode distribution — auth login, placeholder-key pattern, where config & tokens live |
| github-actions.md | CI without stored secrets — IdP setup, reusable workflow, matrix, fork-PR limits |
| kubernetes.md | CronJob / Job / Deployment with projected SA tokens, multi-provider pods, RBAC |
| local-development.md | Sandbox setup, re-export trick, forcing re-auth, dev-only subject token |
| Page | When you need it |
|---|---|
| models-info.md | Composition with any auth scheme, the OpenRouter→OpenCode field mapping, caching, failure modes |
| Page | When you need it |
|---|---|
| ratelimit.md | Reading Envoy x-ratelimit-* headers, throttle/backoff state machine, tiers & scope, the timeout caveat |
| Page | When you need it |
|---|---|
| browser.md | Topology, wire protocol, the 33-tool reference, executors, named groups, multi-client routing, store publishing |
../plans/multi-client-routing.md |
The auto-elect broker design (multiple browsers + agents) |
| Page | What it covers |
|---|---|
| security.md | Consolidated security model across all plugins — token cache, the browser bridge, blast radius, reducing it |
| troubleshooting.md | Symptom-keyed fixes across every plugin |
| adr/ | Architecture Decision Records — load-bearing, non-obvious decisions and why (e.g. why the browser bridge uses ws, not Bun.serve or socket.io) |
| Page | What it covers |
|---|---|
| ../README.md | Overview, install, stacking the plugins, workspace layout |
| ../GETTING_STARTED.md | End-to-end setup against a local OpenCode install |
| ../CONTRIBUTING.md | Bootstrap, the pre-push gate, conventions, package layout, releasing |
| ../CLAUDE.md | The live architectural map (canonical for hook behavior & composition contracts) |
| ../plans/prd.md | Product requirements & phased roadmap |