Align docs and config with OpenCode-first branding

chenbo · chenbo · commit 4afe017c7a59 · 2026-06-19T22:56:30.000+08:00
diff --git a/README.en.md b/README.en.md
@@ -91,12 +91,12 @@ The README main path intentionally recommends only `opencode-plusplus`. Batch Ha
 
 ## What It Solves
 
-- Agents guess entry files and modules because repository context is incomplete.
-- Agents over-edit generated files, lockfiles, CI, migrations, or unrelated modules.
-- Agents hallucinate APIs, commands, config keys, environment variables, or project conventions.
-- Agents claim tests passed without reliable exit-code, timestamp, or working-tree-hash evidence.
-- Agents make changes whose downstream impact is invisible during review.
-- Agents reintroduce historical bugs or keep repairing without a clear stop condition.
+- OpenCode guesses entry files and modules because repository context is incomplete.
+- OpenCode over-edits generated files, lockfiles, CI, migrations, or unrelated modules.
+- OpenCode hallucinates APIs, commands, config keys, environment variables, or project conventions.
+- OpenCode claims tests passed without reliable exit-code, timestamp, or working-tree-hash evidence.
+- OpenCode makes changes whose downstream impact is invisible during review.
+- OpenCode reintroduces historical bugs or keeps repairing without a clear stop condition.
 
 ## Current Maturity
 
diff --git a/README.md b/README.md
@@ -90,12 +90,12 @@ opencode-plusplus --pure   # 纯 OpenCode，不启用 OpenCode++
 
 ## 解决什么问题
 
-- Agent 不知道该读哪些文件，靠猜入口和模块。
-- Agent 修改范围失控，误改 generated、lockfile、CI、migration 或无关模块。
-- Agent 生成不存在的 API、命令、配置、环境变量或项目约定。
-- Agent 声称测试通过，但没有可信的 exit code / timestamp / working tree hash 证据。
-- Agent 改完影响范围不可见，review 风险难判断。
-- Agent 重复引入历史 bug，repair loop 不知道何时停止。
+- OpenCode 不知道该读哪些文件，靠猜入口和模块。
+- OpenCode 修改范围失控，误改 generated、lockfile、CI、migration 或无关模块。
+- OpenCode 生成不存在的 API、命令、配置、环境变量或项目约定。
+- OpenCode 声称测试通过，但没有可信的 exit code / timestamp / working tree hash 证据。
+- OpenCode 改完影响范围不可见，review 风险难判断。
+- OpenCode 重复引入历史 bug，repair loop 不知道何时停止。
 
 ## 当前能力成熟度
 
diff --git a/docs/agents-md.md b/docs/agents-md.md
@@ -60,7 +60,7 @@ If those headings are not found, the tool falls back to moving the whole legacy
 You do not have to run the CLI by hand. You can ask a coding agent to use [whut09/OpenCode-plusplus](https://github.com/whut09/opencode-plusplus) against another repository:
 
 ```txt
-Use https://github.com/whut09/opencode-plusplus to generate AGENTS.md and a .agent-context package for the xxx project. Inspect the target repository first, then install or clone the tool if needed. Force LLM summaries: create or update opencode-plusplus.local.yml in the target repo, do not commit that file, and prefer the model API configuration available in the current AI tool environment or the key/baseUrl/model I provide; if configuration is missing, ask me first. Then run opencode-plusplus build <target-repo> --target codex --llm, run opencode-plusplus validate <target-repo>, and summarize the generated files plus whether LLM summary mode succeeded.
+Use https://github.com/whut09/opencode-plusplus to generate AGENTS.md and a .agent-context package for the xxx project. Inspect the target repository first, then install or clone the tool if needed. Force LLM summaries: create or update opencode-plusplus.local.yml in the target repo, do not commit that file, and prefer the model API configuration available in the current AI tool environment or the key/baseUrl/model I provide; if configuration is missing, ask me first. Then run opencode-plusplus build <target-repo> --target opencode --llm, run opencode-plusplus validate <target-repo>, and summarize the generated files plus whether LLM summary mode succeeded.
 ```
 
 Replace `xxx project` with a local path, GitHub repository, or workspace name. This works especially well in Codex because Codex can run commands in the workspace and then read the generated `AGENTS.md` before making later edits.
@@ -78,7 +78,7 @@ Codex supports `AGENTS.md` directly. According to the Codex documentation, Codex
 Recommended usage:
 
 ```bash
-opencode-plusplus build . --target codex
+opencode-plusplus build . --target opencode
 codex "Summarize the current repository instructions."
 ```
 
diff --git a/docs/agents-md.zh-CN.md b/docs/agents-md.zh-CN.md
@@ -63,7 +63,7 @@ Generated context is split into L0-L3 so agents do not load the full `.agent-con
 你不一定要手动运行 CLI，也可以直接让编程 Agent 使用 [whut09/OpenCode-plusplus](https://github.com/whut09/opencode-plusplus) 去处理另一个仓库：
 
 ```txt
-使用 https://github.com/whut09/opencode-plusplus 对 xxx 项目生成 AGENTS.md 和 .agent-context 上下文包。请先检查目标仓库结构，再按需安装或克隆该工具。请强制启用 LLM 摘要：在目标仓库创建或更新 opencode-plusplus.local.yml，不要提交该文件，优先使用当前 AI 工具环境里可用的模型 API 配置或我提供的 key/baseUrl/model；如果缺少配置，请先问我。然后运行 opencode-plusplus build <目标仓库> --target codex --llm，再运行 opencode-plusplus validate <目标仓库>，最后说明生成了哪些文件和 LLM 摘要模式是否成功。
+使用 https://github.com/whut09/opencode-plusplus 对 xxx 项目生成 AGENTS.md 和 .agent-context 上下文包。请先检查目标仓库结构，再按需安装或克隆该工具。请强制启用 LLM 摘要：在目标仓库创建或更新 opencode-plusplus.local.yml，不要提交该文件，优先使用当前 AI 工具环境里可用的模型 API 配置或我提供的 key/baseUrl/model；如果缺少配置，请先问我。然后运行 opencode-plusplus build <目标仓库> --target opencode --llm，再运行 opencode-plusplus validate <目标仓库>，最后说明生成了哪些文件和 LLM 摘要模式是否成功。
 ```
 
 把 `xxx 项目` 替换成本地路径、GitHub 仓库或当前工作区名称即可。这种方式在 Codex 里尤其自然，因为 Codex 可以在工作区运行命令，并在后续修改代码前读取生成的 `AGENTS.md`。
@@ -81,7 +81,7 @@ Codex 原生支持 `AGENTS.md`。根据 Codex 文档，Codex 会在开始工作
 推荐用法：
 
 ```bash
-opencode-plusplus build . --target codex
+opencode-plusplus build . --target opencode
 codex "Summarize the current repository instructions."
 ```
 
diff --git a/docs/concepts/loop-engineering.zh-CN.md b/docs/concepts/loop-engineering.zh-CN.md
@@ -92,6 +92,7 @@ direct lexical hits
   tests.md
   verify.md
   impact.md
+  prompt.opencode.md
   prompt.codex.md
   prompt.claude.md
   prompt.cursor.md
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -98,7 +98,7 @@ Read the generated run directory:
   tests.md
   impact.md
   verify.md
-  prompt.codex.md
+  prompt.opencode.md
 ```
 
 ## Advanced: Verify After Edits
@@ -127,8 +127,6 @@ opencode-plusplus oc repair
 .opencode/commands/opencode-plusplus.md
 .opencode/commands/opencode-plusplus-verify.md
 .opencode/agents/opencode-plusplus.md
-.opencode/commands/opencode-plusplus.md
-.opencode/commands/opencode-plusplus-verify.md
 ```
 
 Use `orchestrate --executor-command` when you need a custom executor command.
diff --git a/docs/integrations/opencode-sidecar.md b/docs/integrations/opencode-sidecar.md
@@ -75,8 +75,6 @@ The generated OpenCode plugin listens for:
 .opencode/commands/opencode-plusplus.md
 .opencode/commands/opencode-plusplus-verify.md
 .opencode/agents/opencode-plusplus.md
-.opencode/commands/opencode-plusplus.md
-.opencode/commands/opencode-plusplus-verify.md
 .agent-context/sidecar/latest.json
 .agent-context/sidecar/latest.md
 .agent-context/sidecar/policy.md
diff --git a/docs/reference/config.md b/docs/reference/config.md
@@ -17,7 +17,7 @@ Do not commit `opencode-plusplus.local.yml`.
 ## Example
 
 ```yaml
-target: codex
+target: opencode
 tokenBudget: 100000
 
 include:
@@ -42,8 +42,8 @@ llm:
   model: "xx"
 
 rag:
-  enabled: true
-  chunkTokenLimit: 1200
+  provider: lightrag
+  chunkTokenLimit: 900
 ```
 
 ## LLM Credentials
diff --git a/opencode-plusplus.config.example.yml b/opencode-plusplus.config.example.yml
@@ -1,4 +1,4 @@
-target: codex
+target: opencode
 tokenBudget: 60000
 
 include:
diff --git a/src/benchmarks/agent-benchmark.ts b/src/benchmarks/agent-benchmark.ts
@@ -438,7 +438,7 @@ async function promptForMode(repo: string, task: BenchmarkTaskDefinition, mode:
     `Task: ${task.task}`,
     "",
     `Use the task context pack at ${path.relative(repo, run.dir).replaceAll("\\", "/")}.`,
-    "Read plan.md, edit-boundary.md, pack.md, tests.md, impact.md, and prompt.codex.md before editing.",
+    "Read plan.md, edit-boundary.md, pack.md, tests.md, impact.md, and prompt.opencode.md before editing.",
     "Keep changes inside the boundary and run required verification."
   ].join("\n");
 }
diff --git a/src/cli/index.ts b/src/cli/index.ts
@@ -252,7 +252,7 @@ program
 program
   .command("build")
   .argument("[repo]", "repository path", ".")
-  .option("-t, --target <target>", "agent target: codex, claude, cursor, all", parseTarget)
+  .option("-t, --target <target>", "agent target: opencode, codex, claude, cursor, all", parseTarget)
   .option("-b, --token-budget <tokens>", "target token budget", parseInteger)
   .option("--tokenizer <tokenizer>", "tokenizer: chars-approx, cl100k_base, o200k_base", parseTokenizerMode)
   .option("--model <model>", "model name used to infer tokenizer, for example gpt-4.1")
@@ -1392,7 +1392,7 @@ function parseCodeBackend(value: string): CodeIntelligenceBackend {
 }
 
 function parseTarget(value: string): AgentTarget {
-  if (value === "codex" || value === "claude" || value === "cursor" || value === "all") {
+  if (value === "opencode" || value === "codex" || value === "claude" || value === "cursor" || value === "all") {
     return value;
   }
 
diff --git a/src/config/defaults.ts b/src/config/defaults.ts
@@ -1,4 +1,4 @@
-import type { CodeAgentPlusplusConfig } from "../core/types.js";
+import type { OpenCodePlusplusConfig } from "../core/types.js";
 
 export const DEFAULT_EXCLUDES = [
   ".git/**",
@@ -21,8 +21,8 @@ export const DEFAULT_EXCLUDES = [
   "*.map"
 ];
 
-export const DEFAULT_CONFIG: CodeAgentPlusplusConfig = {
-  target: "codex",
+export const DEFAULT_CONFIG: OpenCodePlusplusConfig = {
+  target: "opencode",
   tokenBudget: 60000,
   include: ["**/*"],
   exclude: DEFAULT_EXCLUDES,
diff --git a/src/config/load-config.ts b/src/config/load-config.ts
@@ -2,19 +2,19 @@ import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import yaml from "js-yaml";
 import { DEFAULT_CONFIG } from "./defaults.js";
-import type { AgentTarget, AgentsMode, AgentsSection, CodeAgentPlusplusConfig, TokenizerMode } from "../core/types.js";
+import type { AgentTarget, AgentsMode, AgentsSection, OpenCodePlusplusConfig, TokenizerMode } from "../core/types.js";
 
 const CONFIG_FILES = ["opencode-plusplus.config.yml", "opencode-plusplus.config.yaml", "opencode-plusplus.config.json"];
 
 const LOCAL_CONFIG_FILES = ["opencode-plusplus.local.yml", "opencode-plusplus.local.yaml", "opencode-plusplus.local.json"];
 
-export function loadConfig(repoRoot: string, overrides: Partial<CodeAgentPlusplusConfig> = {}): CodeAgentPlusplusConfig {
+export function loadConfig(repoRoot: string, overrides: Partial<OpenCodePlusplusConfig> = {}): OpenCodePlusplusConfig {
   const configPath = CONFIG_FILES.map((file) => path.join(repoRoot, file)).find(existsSync);
   const localConfigPath = LOCAL_CONFIG_FILES.map((file) => path.join(repoRoot, file)).find(existsSync);
   const fileConfig = configPath ? readConfigFile(configPath) : {};
   const localConfig = localConfigPath ? readConfigFile(localConfigPath) : {};
 
-  const config: CodeAgentPlusplusConfig = {
+  const config: OpenCodePlusplusConfig = {
     ...DEFAULT_CONFIG,
     ...fileConfig,
     ...localConfig,
@@ -60,7 +60,7 @@ export function loadConfig(repoRoot: string, overrides: Partial<CodeAgentPlusplu
   return config;
 }
 
-function readConfigFile(configPath: string): Partial<CodeAgentPlusplusConfig> {
+function readConfigFile(configPath: string): Partial<OpenCodePlusplusConfig> {
   const raw = readFileSync(configPath, "utf8");
   try {
     const parsed = configPath.endsWith(".json") ? (JSON.parse(raw) as Record<string, unknown>) : (yaml.load(raw) as Record<string, unknown>);
@@ -71,7 +71,7 @@ function readConfigFile(configPath: string): Partial<CodeAgentPlusplusConfig> {
   }
 }
 
-function normalizeConfig(input: Record<string, unknown> | null | undefined): Partial<CodeAgentPlusplusConfig> {
+function normalizeConfig(input: Record<string, unknown> | null | undefined): Partial<OpenCodePlusplusConfig> {
   if (!input) {
     return {};
   }
@@ -82,17 +82,17 @@ function normalizeConfig(input: Record<string, unknown> | null | undefined): Par
     tokenBudget: typeof input.tokenBudget === "number" ? input.tokenBudget : undefined,
     include: toStringArray(input.include),
     exclude: toStringArray(input.exclude),
-    llm: typeof input.llm === "object" && input.llm ? (input.llm as CodeAgentPlusplusConfig["llm"]) : undefined,
-    rag: typeof input.rag === "object" && input.rag ? (input.rag as CodeAgentPlusplusConfig["rag"]) : undefined,
+    llm: typeof input.llm === "object" && input.llm ? (input.llm as OpenCodePlusplusConfig["llm"]) : undefined,
+    rag: typeof input.rag === "object" && input.rag ? (input.rag as OpenCodePlusplusConfig["rag"]) : undefined,
     tokenizer: typeof input.tokenizer === "object" && input.tokenizer ? normalizeTokenizerConfig(input.tokenizer as Record<string, unknown>) : undefined,
     agents: typeof input.agents === "object" && input.agents ? normalizeAgentsConfig(input.agents as Record<string, unknown>) : undefined,
-    outputs: typeof input.outputs === "object" && input.outputs ? (input.outputs as CodeAgentPlusplusConfig["outputs"]) : undefined
-  }) as Partial<CodeAgentPlusplusConfig>;
+    outputs: typeof input.outputs === "object" && input.outputs ? (input.outputs as OpenCodePlusplusConfig["outputs"]) : undefined
+  }) as Partial<OpenCodePlusplusConfig>;
 }
 
-export function validateConfig(config: CodeAgentPlusplusConfig): void {
-  if (!["codex", "claude", "cursor", "all"].includes(config.target)) {
-    throw new Error(`Invalid target "${config.target}". Expected one of: codex, claude, cursor, all.`);
+export function validateConfig(config: OpenCodePlusplusConfig): void {
+  if (!["opencode", "codex", "claude", "cursor", "all"].includes(config.target)) {
+    throw new Error(`Invalid target "${config.target}". Expected one of: opencode, codex, claude, cursor, all.`);
   }
   if (!Number.isFinite(config.tokenBudget) || config.tokenBudget <= 0) {
     throw new Error("tokenBudget must be a positive number.");
@@ -143,8 +143,8 @@ function validateRawConfig(input: Record<string, unknown> | null | undefined, so
   if (!input || typeof input !== "object" || Array.isArray(input)) {
     throw new Error("config root must be an object.");
   }
-  if (input.target !== undefined && (typeof input.target !== "string" || !["codex", "claude", "cursor", "all"].includes(input.target))) {
-    throw new Error(`Invalid target "${String(input.target)}". Expected one of: codex, claude, cursor, all.`);
+  if (input.target !== undefined && (typeof input.target !== "string" || !["opencode", "codex", "claude", "cursor", "all"].includes(input.target))) {
+    throw new Error(`Invalid target "${String(input.target)}". Expected one of: opencode, codex, claude, cursor, all.`);
   }
   if (input.tokenBudget !== undefined && (typeof input.tokenBudget !== "number" || input.tokenBudget <= 0)) {
     throw new Error("tokenBudget must be a positive number.");
@@ -208,14 +208,14 @@ function validateRawConfig(input: Record<string, unknown> | null | undefined, so
   void source;
 }
 
-function normalizeTokenizerConfig(input: Record<string, unknown>): Partial<CodeAgentPlusplusConfig["tokenizer"]> {
+function normalizeTokenizerConfig(input: Record<string, unknown>): Partial<OpenCodePlusplusConfig["tokenizer"]> {
   return stripUndefined({
     mode: typeof input.mode === "string" ? (input.mode as TokenizerMode) : undefined,
     model: typeof input.model === "string" ? input.model : undefined
   });
 }
 
-function normalizeAgentsConfig(input: Record<string, unknown>): Partial<CodeAgentPlusplusConfig["agents"]> {
+function normalizeAgentsConfig(input: Record<string, unknown>): Partial<OpenCodePlusplusConfig["agents"]> {
   return stripUndefined({
     mode: typeof input.mode === "string" ? (input.mode as AgentsMode) : undefined,
     maxTokens: typeof input.maxTokens === "number" ? input.maxTokens : undefined,
diff --git a/src/config/starter-config.ts b/src/config/starter-config.ts
@@ -1,5 +1,5 @@
 export function starterConfig(): string {
-  return `target: codex
+  return `target: opencode
 tokenBudget: 60000
 
 include:
diff --git a/src/core/cache.ts b/src/core/cache.ts
@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import type { CacheStats, DependencyGraph, IndexedFile, CodeAgentPlusplusConfig, RepoFile, RepoScan, TokenizerConfig } from "./types.js";
+import type { CacheStats, DependencyGraph, IndexedFile, OpenCodePlusplusConfig, RepoFile, RepoScan, TokenizerConfig } from "./types.js";
 import type { TokenCountCache } from "./token-estimator.js";
 
 const CACHE_VERSION = 1;
@@ -63,7 +63,7 @@ export class ContextCache implements TokenCountCache {
   private graphCache: GraphCacheFile;
   private tokenizerCache: TokenizerCacheFile;
 
-  private constructor(root: string, config: CodeAgentPlusplusConfig) {
+  private constructor(root: string, config: OpenCodePlusplusConfig) {
     this.root = root;
     this.configFingerprint = hashText(stableStringify(config));
     this.stats = createCacheStats(true);
@@ -83,7 +83,7 @@ export class ContextCache implements TokenCountCache {
     this.tokenizerCache = readJson(this.tokenizerCachePath, { version: CACHE_VERSION, entries: {} });
   }
 
-  static open(root: string, config: CodeAgentPlusplusConfig, options: ContextCacheOptions = {}): ContextCache | null {
+  static open(root: string, config: OpenCodePlusplusConfig, options: ContextCacheOptions = {}): ContextCache | null {
     if (options.enabled === false) return null;
     const absoluteRoot = path.resolve(root);
     if (!shouldPersistCache(absoluteRoot)) return null;
diff --git a/src/core/context-builder.ts b/src/core/context-builder.ts
@@ -1,5 +1,5 @@
 import { loadConfig } from "../config/load-config.js";
-import type { AgentTarget, ContextPackage, CodeAgentPlusplusConfig } from "./types.js";
+import type { AgentTarget, ContextPackage, OpenCodePlusplusConfig } from "./types.js";
 import { scanRepository } from "./scanner.js";
 import { indexRepository } from "./indexer.js";
 import { ContextCache, createCacheStats } from "./cache.js";
@@ -14,13 +14,13 @@ export interface BuildOptions {
   target?: AgentTarget;
   tokenBudget?: number;
   llm?: boolean;
-  tokenizer?: CodeAgentPlusplusConfig["tokenizer"]["mode"];
+  tokenizer?: OpenCodePlusplusConfig["tokenizer"]["mode"];
   model?: string;
   cache?: boolean;
 }
 
 export async function buildContextPackage(repoRoot: string, options: BuildOptions = {}): Promise<ContextPackage> {
-  const overrides: Partial<CodeAgentPlusplusConfig> = {};
+  const overrides: Partial<OpenCodePlusplusConfig> = {};
   if (options.target) overrides.target = options.target;
   if (options.tokenBudget) overrides.tokenBudget = options.tokenBudget;
   if (options.model) {
diff --git a/src/core/scanner.ts b/src/core/scanner.ts
@@ -2,7 +2,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import path from "node:path";
 import fg from "fast-glob";
 import ignore from "ignore";
-import type { CodeAgentPlusplusConfig, RepoFile, RepoScan } from "./types.js";
+import type { OpenCodePlusplusConfig, RepoFile, RepoScan } from "./types.js";
 import { classifyFile, isGeneratedPath, isTestPath } from "./file-classifier.js";
 import { languageForExtension } from "./language.js";
 import { estimateTokens } from "./token-estimator.js";
@@ -27,7 +27,7 @@ const BINARY_EXTENSIONS = new Set([
   ".dll"
 ]);
 
-export async function scanRepository(root: string, config: CodeAgentPlusplusConfig): Promise<RepoScan> {
+export async function scanRepository(root: string, config: OpenCodePlusplusConfig): Promise<RepoScan> {
   const absoluteRoot = path.resolve(root);
   const gitignore = loadGitignore(absoluteRoot);
   const entries = await fg(config.include, {
diff --git a/src/core/summarizer.ts b/src/core/summarizer.ts
diff --git a/src/core/types.ts b/src/core/types.ts
diff --git a/src/harness/control-plane/orchestrator.ts b/src/harness/control-plane/orchestrator.ts
diff --git a/src/outputs/task-run.ts b/src/outputs/task-run.ts
diff --git a/test/config.test.ts b/test/config.test.ts
diff --git a/test/task-harness.test.ts b/test/task-harness.test.ts

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-target: codex`
	`1`	`+target: opencode`
`2`	`2`	`tokenBudget: 60000`
`3`	`3`
`4`	`4`	`include:`
Original file line number	Diff line number	Diff line change
`@@ -438,7 +438,7 @@ async function promptForMode(repo: string, task: BenchmarkTaskDefinition, mode:`
`438`	`438`	`Task: ${task.task}`,
`439`	`439`	`"",`
`440`	`440`	`Use the task context pack at ${path.relative(repo, run.dir).replaceAll("\\", "/")}.`,
`441`		`- "Read plan.md, edit-boundary.md, pack.md, tests.md, impact.md, and prompt.codex.md before editing.",`
	`441`	`+ "Read plan.md, edit-boundary.md, pack.md, tests.md, impact.md, and prompt.opencode.md before editing.",`
`442`	`442`	`"Keep changes inside the boundary and run required verification."`
`443`	`443`	`].join("\n");`
`444`	`444`	`}`