anomalyco / anomalyco/opencode

docs: contributing and config docs out of sync with code

Open
#41,547 0 comments 0 reactions 1 assignee View on GitHub

@jlongster is already working on this.

Since Aug 10, 2026.

Dominant language
TypeScript
Stars
209k
Forks
27.5k
PR merge metrics
PR metrics pending

Description

Description

Two documentation pages are out of sync with the current codebase:

  1. CONTRIBUTING.md still points the TUI code at packages/opencode/src/cli/cmd/tui/, but the TUI now lives in packages/tui (SolidJS + opentui). The old path no longer exists.

  2. config.mdx documents project config as only opencode.json in the project root, but the code now also loads opencode.jsonc and config files placed inside .opencode/ directories (see ConfigPaths.files / ConfigPaths.directories and the .opencode directory walk in src/config/config.ts). The config lookup description in the Per project section is also outdated.

Expected
  • CONTRIBUTING.md references packages/tui for the TUI code.
  • config.mdx documents opencode.json / opencode.jsonc in the project root or .opencode/, and an accurate lookup walk.
OpenCode version

dev

Operating System

Linux

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.