oh-my-opencode 4.7.3 → 4.7.5

package/packages/lsp-tools-mcp/package.json

@@ -0,0 +1,52 @@
+{
+	"name": "@code-yeongyu/lsp-tools-mcp",
+	"version": "0.1.0",
+	"description": "Standalone Language Server Protocol tools exposed as a stdio MCP server.",
+	"type": "module",
+	"packageManager": "npm@11.12.1",
+	"license": "MIT",
+	"homepage": "https://github.com/code-yeongyu/lsp-tools-mcp",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/code-yeongyu/lsp-tools-mcp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/code-yeongyu/lsp-tools-mcp/issues"
+	},
+	"keywords": [
+		"mcp",
+		"lsp",
+		"language-server-protocol",
+		"model-context-protocol",
+		"typescript",
+		"nodejs"
+	],
+	"bin": {
+		"omo-lsp": "./dist/cli.js"
+	},
+	"files": [
+		"dist",
+		"LICENSE",
+		"NOTICE",
+		"README.md",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"test": "vitest --run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"check": "tsc --noEmit && biome check . && npm run build"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.4.15",
+		"@types/node": "^25.7.0",
+		"typescript": "^6.0.3",
+		"vitest": "^4.1.5"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	}
+}

package/packages/omo-codex/plugin/README.md

@@ -9,5 +9,28 @@ Internally each component remains isolated under `components/`:
 - `components/lsp`
 - `components/ultrawork`
 - `components/ulw-loop`
+- `components/telemetry`
 
 The root plugin manifest exports one Codex plugin named `omo`, with aggregate hooks, skills, and the LSP MCP server.
+
+## Telemetry
+
+The bundled telemetry component emits the anonymous `omo_codex_daily_active` event at most once per UTC day per machine when the Codex `SessionStart` hook runs. It uses `sha256("omo-codex:" + hostname)` as the distinct ID, disables PostHog person profiles, and stores daily deduplication state in `$XDG_DATA_HOME/omo-codex/posthog-activity.json` or `~/.local/share/omo-codex/posthog-activity.json`.
+
+Captured properties are limited to product/runtime metadata, operating-system metadata, coarse machine shape, locale/timezone, shell/terminal hints, `source`, `reason`, and `day_utc`. It does not send prompt contents, chat transcripts, source files, repository contents, file paths, access tokens, API keys, raw hostnames, Git remotes, usernames, email addresses, or runtime error diagnostics.
+
+Opt out before launching Codex:
+
+```bash
+export OMO_CODEX_DISABLE_POSTHOG=1
+export OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0
+```
+
+Global opt-out flags also disable this telemetry:
+
+```bash
+export OMO_DISABLE_POSTHOG=1
+export OMO_SEND_ANONYMOUS_TELEMETRY=0
+```
+
+Detailed implementation notes live in `components/telemetry/README.md`; the root product disclosure lives in `docs/reference/codex-telemetry.md` in the source repository.

package/packages/omo-codex/plugin/components/rules/README.md

@@ -17,8 +17,6 @@ The runtime has no npm production dependencies, so a clean Codex marketplace cop
 
 Project-level sources:
 
-- `AGENTS.md`
-- `CLAUDE.md`
 - `CONTEXT.md`
 - `.omo/rules/**/*.md`
 - `.claude/rules/**/*.md`
@@ -58,6 +56,8 @@ It also enables:
 [features]
 plugins = true
 plugin_hooks = true
+multi_agent = true
+child_agents_md = true
 
 [plugins."omo@sisyphuslabs"]
 enabled = true

package/packages/omo-codex/plugin/components/rules/skills/rules/SKILL.md

@@ -14,10 +14,8 @@ Dynamic `PostToolUse` output is injected as additional context and is deduplicat
 
 Supported project sources:
 
-- `AGENTS.md`
-- `CLAUDE.md`
 - `CONTEXT.md`
-- `.sisyphus/rules/**/*.md`
+- `.omo/rules/**/*.md`
 - `.claude/rules/**/*.md`
 - `.cursor/rules/**/*.md`
 - `.github/instructions/**/*.md`
@@ -29,6 +27,6 @@ Supported environment knobs:
 - `CODEX_RULES_MODE=both|static|dynamic|off`
 - `CODEX_RULES_MAX_RULE_CHARS=<number>`
 - `CODEX_RULES_MAX_RESULT_CHARS=<number>`
-- `CODEX_RULES_ENABLED_SOURCES=AGENTS.md,.sisyphus/rules`
+- `CODEX_RULES_ENABLED_SOURCES=CONTEXT.md,.omo/rules`
 
 The legacy `PI_RULES_*` variables are accepted as fallbacks for users migrating from `pi-rules`.

package/packages/omo-codex/plugin/components/rules/src/config.ts

@@ -77,7 +77,7 @@ function parseEnabledSources(value: string | undefined, disableBundledRules: boo
 		sources.push(source);
 	}
 	const enabledSources = disableBundledRules ? sources.filter((source) => source !== "plugin-bundled") : sources;
-	return enabledSources.length > 0 || sources.length > 0 ? enabledSources : "auto";
+	return enabledSources;
 }
 
 function sourcesWithoutBundledRules(): RuleSource[] {
@@ -91,15 +91,11 @@ function toRuleSource(value: string): RuleSource | null {
 		case ".cursor/rules":
 		case ".github/instructions":
 		case ".github/copilot-instructions.md":
-		case "AGENTS.md":
-		case "CLAUDE.md":
 		case "CONTEXT.md":
 		case "plugin-bundled":
 		case "~/.omo/rules":
 		case "~/.opencode/rules":
 		case "~/.claude/rules":
-		case "~/.config/opencode/AGENTS.md":
-		case "~/.claude/CLAUDE.md":
 			return value;
 		default:
 			return null;

package/packages/omo-codex/plugin/components/rules/src/rules/constants.ts

@@ -30,8 +30,6 @@ export const PROJECT_RULE_SUBDIRS: ReadonlyArray<readonly [string, string]> = [
  */
 export const PROJECT_SINGLE_FILES: readonly string[] = [
 	".github/copilot-instructions.md",
-	"AGENTS.md",
-	"CLAUDE.md",
 	"CONTEXT.md",
 ];
 
@@ -43,7 +41,7 @@ export const USER_HOME_RULE_SUBDIRS: readonly string[] = [".omo/rules", ".openco
 /**
  * User-home single-file rules. The first one to exist wins per "first-match" semantics.
  */
-export const USER_HOME_SINGLE_FILES: readonly string[] = [".config/opencode/AGENTS.md", ".claude/CLAUDE.md"];
+export const USER_HOME_SINGLE_FILES: readonly string[] = [];
 
 /**
  * Bundled plugin rule directory relative to the rules component root.
@@ -64,14 +62,10 @@ export const SOURCE_PRIORITY: ReadonlyMap<RuleSource, number> = new Map([
 	[".cursor/rules", 2],
 	[".github/instructions", 3],
 	[".github/copilot-instructions.md", 4],
-	["AGENTS.md", 5],
-	["CLAUDE.md", 6],
 	["CONTEXT.md", 7],
 	["~/.omo/rules", 100],
 	["~/.opencode/rules", 101],
 	["~/.claude/rules", 102],
-	["~/.config/opencode/AGENTS.md", 103],
-	["~/.claude/CLAUDE.md", 104],
 	["plugin-bundled", 200],
 ]);
 

package/packages/omo-codex/plugin/components/rules/src/rules/finder-sources.ts

@@ -17,8 +17,6 @@ export function toProjectRuleSource(parentDirectory: string, subDirectory: strin
 export function toProjectSingleFileSource(ruleFile: string): RuleSource {
 	switch (ruleFile) {
 		case ".github/copilot-instructions.md":
-		case "AGENTS.md":
-		case "CLAUDE.md":
 		case "CONTEXT.md":
 			return ruleFile;
 		default:
@@ -41,9 +39,6 @@ export function toUserHomeRuleSource(ruleSubdir: string): RuleSource {
 export function toUserHomeSingleFileSource(ruleFile: string): RuleSource {
 	const source = `~/${ruleFile}`;
 	switch (source) {
-		case "~/.config/opencode/AGENTS.md":
-		case "~/.claude/CLAUDE.md":
-			return source;
 		default:
 			throw new UnsupportedRuleSourceError(`Unsupported user-home single-file source: ${source}`);
 	}

package/packages/omo-codex/plugin/components/rules/src/rules/sources.ts

@@ -1,11 +1,7 @@
 import { SOURCE_PRIORITY } from "./constants.js";
-import type { PiRulesConfig, RuleSource } from "./types.js";
+import type { PiRulesConfig } from "./types.js";
 
-export const DEFAULT_AUTO_DISABLED_SOURCES: readonly RuleSource[] = [
-	"AGENTS.md",
-	"~/.claude/rules",
-	"~/.claude/CLAUDE.md",
-];
+export const DEFAULT_AUTO_DISABLED_SOURCES: readonly string[] = ["AGENTS.md", "~/.claude/rules", "~/.claude/CLAUDE.md"];
 
 export function disabledSourcesFromConfig(config: PiRulesConfig): ReadonlySet<string> | undefined {
 	if (config.enabledSources === "auto") {

package/packages/omo-codex/plugin/components/rules/src/rules/types.ts

@@ -51,7 +51,7 @@ export interface RuleCandidate {
 	distance: number;
 	isGlobal: boolean;
 	/**
-	 * True when this candidate is a SINGLE-FILE rule like AGENTS.md or
+	 * True when this candidate is a SINGLE-FILE rule like
 	 * `.github/copilot-instructions.md` (frontmatter optional, applies always).
 	 */
 	isSingleFile: boolean;
@@ -81,15 +81,11 @@ export type RuleSource =
 	| ".cursor/rules"
 	| ".github/instructions"
 	| ".github/copilot-instructions.md"
-	| "AGENTS.md"
-	| "CLAUDE.md"
 	| "CONTEXT.md"
 	| "plugin-bundled"
 	| "~/.omo/rules"
 	| "~/.opencode/rules"
-	| "~/.claude/rules"
-	| "~/.config/opencode/AGENTS.md"
-	| "~/.claude/CLAUDE.md";
+	| "~/.claude/rules";
 
 /**
  * Why a candidate matched the target file. Surfaced in the injection block so

package/packages/omo-codex/plugin/components/rules/test/agent-doc-sources.test.ts

@@ -0,0 +1,119 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+
+import {
+	type CodexPostToolUseInput,
+	type CodexSessionStartInput,
+	runPostToolUseHook,
+	runSessionStartHook,
+} from "../src/codex-hook.js";
+
+const REMOVED_AGENT_DOC_SOURCE_LISTS = ["AGENTS.md", "CLAUDE.md", "AGENTS.md,CLAUDE.md"] as const;
+
+const tempDirectories: string[] = [];
+
+type AgentDocProject = {
+	readonly pluginData: string;
+	readonly root: string;
+	readonly nestedSourceFile: string;
+};
+
+afterEach(() => {
+	for (const directory of tempDirectories.splice(0)) {
+		rmSync(directory, { recursive: true, force: true });
+	}
+});
+
+function makeAgentDocProject(): AgentDocProject {
+	const root = mkdtempSync(path.join(tmpdir(), "codex-rules-agent-docs-"));
+	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-agent-docs-data-"));
+	tempDirectories.push(root, pluginData);
+
+	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
+	writeFileSync(path.join(root, "AGENTS.md"), "Root AGENTS.md must remain Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Root CLAUDE.md must stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), "Context source must not leak through removed-only allowlists.");
+
+	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
+	writeFileSync(
+		path.join(root, ".omo", "rules", "typescript.md"),
+		[
+			"---",
+			"description: TypeScript",
+			'globs: ["**/*.ts"]',
+			"---",
+			"",
+			"Dynamic .omo/rules context must not leak through removed-only allowlists.",
+		].join("\n"),
+	);
+
+	const nestedDirectory = path.join(root, "child", "src");
+	mkdirSync(nestedDirectory, { recursive: true });
+	writeFileSync(path.join(root, "child", "AGENTS.md"), "Child AGENTS.md must remain Codex-native.");
+	const nestedSourceFile = path.join(nestedDirectory, "app.ts");
+	writeFileSync(nestedSourceFile, "export const app = true;\n");
+
+	return { root, pluginData, nestedSourceFile };
+}
+
+function sessionStartInput(root: string): CodexSessionStartInput {
+	return {
+		session_id: "session-1",
+		transcript_path: null,
+		cwd: root,
+		hook_event_name: "SessionStart",
+		model: "gpt-5.5",
+		permission_mode: "default",
+		source: "startup",
+	};
+}
+
+function postToolUseInput(root: string, filePath: string): CodexPostToolUseInput {
+	return {
+		session_id: "session-1",
+		turn_id: "turn-1",
+		transcript_path: null,
+		cwd: root,
+		hook_event_name: "PostToolUse",
+		model: "gpt-5.5",
+		permission_mode: "default",
+		tool_name: "mcp__filesystem__read_file",
+		tool_input: { path: filePath },
+		tool_response: { text: "file contents" },
+		tool_use_id: "call-1",
+	};
+}
+
+describe("agent doc sources", () => {
+	for (const sourceList of REMOVED_AGENT_DOC_SOURCE_LISTS) {
+		it(`#given ${sourceList} removed-only source allowlist #when SessionStart runs #then it emits no OMO rules context`, async () => {
+			// given
+			const { root, pluginData } = makeAgentDocProject();
+
+			// when
+			const output = await runSessionStartHook(sessionStartInput(root), {
+				pluginDataRoot: pluginData,
+				env: { CODEX_RULES_ENABLED_SOURCES: sourceList },
+			});
+
+			// then
+			expect(output).toBe("");
+		});
+	}
+
+	it("#given nested AGENTS.md and removed-only source allowlist #when PostToolUse targets a child file #then it emits no dynamic OMO rules context", async () => {
+		// given
+		const { root, pluginData, nestedSourceFile } = makeAgentDocProject();
+
+		// when
+		const output = await runPostToolUseHook(postToolUseInput(root, nestedSourceFile), {
+			pluginDataRoot: pluginData,
+			env: { CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,CLAUDE.md" },
+		});
+
+		// then
+		expect(output).toBe("");
+	});
+});

package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-budget.test.ts

@@ -13,7 +13,7 @@ import {
 
 const tempDirectories: string[] = [];
 const PROJECT_RULES_ENV = {
-	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
 	CODEX_RULES_MAX_RESULT_CHARS: "50000",
 	CODEX_RULES_MAX_RULE_CHARS: "30000",
 };
@@ -56,7 +56,9 @@ function makeOversizedProject(): { root: string; pluginData: string } {
 	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-post-compact-budget-data-"));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), `Project rule\n${"A".repeat(30_000)}`);
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), `Project rule\n${"A".repeat(30_000)}`);
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),

package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-dedup.test.ts

@@ -15,7 +15,7 @@ import {
 
 const tempDirectories: string[] = [];
 const PROJECT_ONLY_ENV = {
-	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
 };
 
 afterEach(() => {
@@ -145,7 +145,9 @@ function makeTempProject(): { root: string; pluginData: string } {
 	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-compact-dedup-data-"));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), "Always wear safety goggles when refactoring.");
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), "Always wear safety goggles when refactoring.");
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),

package/packages/omo-codex/plugin/components/rules/test/codex-hook.test.ts

@@ -55,9 +55,17 @@ function runHookCli(input: string, subcommand = "post-tool-use", env: NodeJS.Pro
 
 const tempDirectories: string[] = [];
 const PROJECT_ONLY_ENV = {
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
+};
+
+const AGENTS_AND_RULES_ENV = {
 	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
 };
 
+const CLAUDE_AND_RULES_ENV = {
+	CODEX_RULES_ENABLED_SOURCES: "CLAUDE.md,.omo/rules",
+};
+
 const RULES_ONLY_ENV = {
 	CODEX_RULES_ENABLED_SOURCES: ".omo/rules",
 };
@@ -73,7 +81,9 @@ function makeTempProject(): { root: string; pluginData: string } {
 	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-data-"));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), "Always wear safety goggles when refactoring.");
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), "Always wear safety goggles when refactoring.");
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),
@@ -223,7 +233,36 @@ describe("codex rules hooks", () => {
 		// then
 		const parsed = parseHookOutput(output);
 		expect(parsed.hookSpecificOutput?.additionalContext).toContain("## Project Instructions");
-		expect(parsed.hookSpecificOutput?.additionalContext).not.toContain("Always wear safety goggles");
+		expect(parsed.hookSpecificOutput?.additionalContext).not.toContain("Project AGENTS.md should stay Codex-native.");
+		expect(parsed.hookSpecificOutput?.additionalContext).not.toContain("Project CLAUDE.md should stay outside rules hook context.");
+	});
+
+	it("#given project AGENTS.md #when SessionStart runs #then rules hook leaves AGENTS.md to Codex native handling", async () => {
+		// given
+		const { root, pluginData } = makeTempProject();
+
+		// when
+		const output = await runSessionStartHook(sessionStartInput(root), {
+			pluginDataRoot: pluginData,
+			env: AGENTS_AND_RULES_ENV,
+		});
+
+		// then
+		expect(output).toBe("");
+	});
+
+	it("#given project CLAUDE.md #when SessionStart runs #then rules hook leaves CLAUDE.md out of context", async () => {
+		// given
+		const { root, pluginData } = makeTempProject();
+
+		// when
+		const output = await runSessionStartHook(sessionStartInput(root), {
+			pluginDataRoot: pluginData,
+			env: CLAUDE_AND_RULES_ENV,
+		});
+
+		// then
+		expect(output).toBe("");
 	});
 
 	it("#given static context already injected #when UserPromptSubmit runs #then it emits no duplicate context", async () => {

package/packages/omo-codex/plugin/components/rules/test/config.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from "vitest";
+
+import { configFromEnvironment } from "../src/config.js";
+
+const REMOVED_AGENT_DOC_SOURCE_LISTS = ["AGENTS.md", "CLAUDE.md", "AGENTS.md,CLAUDE.md"] as const;
+
+describe("rules config", () => {
+	for (const sourceList of REMOVED_AGENT_DOC_SOURCE_LISTS) {
+		it(`#given removed agent-doc source ${sourceList} #when parsing enabled sources #then preserves the explicit empty allowlist`, () => {
+			// given
+			const env = {
+				CODEX_RULES_ENABLED_SOURCES: sourceList,
+			} satisfies NodeJS.ProcessEnv;
+
+			// when
+			const config = configFromEnvironment(env);
+
+			// then
+			expect(config.enabledSources).toEqual([]);
+		});
+	}
+});

package/packages/omo-codex/plugin/components/rules/test/engine.test.ts

@@ -216,7 +216,7 @@ describe("rule engine default source selection", () => {
 		expect(capturedDisabledSources?.has("CLAUDE.md")).toBe(false);
 	});
 
-	it("#given Codex-native and Claude-home sources are explicitly enabled #when loading static rules #then they are not disabled", () => {
+	it("#given removed agent-doc sources and a real source are requested #when loading static rules #then only real sources are enabled", () => {
 		// given
 		let capturedDisabledSources: ReadonlySet<string> | undefined;
 		const deps = {

package/packages/omo-codex/plugin/components/rules/test/finder.test.ts

@@ -24,6 +24,7 @@ function makeProject(): { projectRoot: string; homeRoot: string; targetPath: str
 	mkdirSync(join(homeRoot, ".config", "opencode"), { recursive: true });
 	writeFileSync(join(projectRoot, "package.json"), JSON.stringify({ name: "fixture" }));
 	writeFileSync(join(projectRoot, "AGENTS.md"), "Project rule\n");
+	writeFileSync(join(projectRoot, "CLAUDE.md"), "Claude rule\n");
 	writeFileSync(join(projectRoot, "src", ".omo", "rules", "local.md"), "Local rule\n");
 	writeFileSync(join(projectRoot, ".omo", "rules", "root.md"), "Root rule\n");
 	writeFileSync(join(homeRoot, ".opencode", "rules", "global.md"), "Global rule\n");
@@ -54,9 +55,7 @@ describe("findRuleCandidates", () => {
 		expect(candidates.map(candidateSummary)).toEqual([
 			".omo/rules:0:src/.omo/rules/local.md",
 			".omo/rules:1:.omo/rules/root.md",
-			"AGENTS.md:1:AGENTS.md",
 			"~/.opencode/rules:9999:.opencode/rules/global.md",
-			"~/.config/opencode/AGENTS.md:9999:.config/opencode/AGENTS.md",
 		]);
 	});
 
@@ -73,10 +72,7 @@ describe("findRuleCandidates", () => {
 		});
 
 		// then
-		expect(candidates.map(candidateSummary)).toEqual([
-			"AGENTS.md:1:AGENTS.md",
-			"~/.config/opencode/AGENTS.md:9999:.config/opencode/AGENTS.md",
-		]);
+		expect(candidates.map(candidateSummary)).toEqual([]);
 	});
 
 	it("#given skip user home #when finding candidates #then only project rules are returned", () => {
@@ -96,7 +92,6 @@ describe("findRuleCandidates", () => {
 		expect(candidates.map(candidateSummary)).toEqual([
 			".omo/rules:0:src/.omo/rules/local.md",
 			".omo/rules:1:.omo/rules/root.md",
-			"AGENTS.md:1:AGENTS.md",
 		]);
 	});
 });

package/packages/omo-codex/plugin/components/rules/test/formatter.test.ts

@@ -12,8 +12,8 @@ describe("rules formatter hook context", () => {
 	it("#given multiline dynamic rules #when formatting PostToolUse context #then labels and bodies render on separate lines", () => {
 		// given
 		const rule = loadedRule({
-			path: "/repo/packages/AGENTS.md",
-			relativePath: "packages/AGENTS.md",
+			path: "/repo/packages/CONTEXT.md",
+			relativePath: "packages/CONTEXT.md",
 			body: ["# packages", "", "## OVERVIEW", "23 sibling packages.", "", "## CONVENTIONS", "Use npm."].join("\n"),
 		});
 
@@ -29,7 +29,7 @@ describe("rules formatter hook context", () => {
 			[
 				"Additional project instructions matched for packages/omo-codex/plugin/components/ulw-loop/src/paths.ts:",
 				"",
-				"Instructions from: /repo/packages/AGENTS.md",
+				"Instructions from: /repo/packages/CONTEXT.md",
 				"",
 				"# packages",
 				"",
@@ -45,8 +45,8 @@ describe("rules formatter hook context", () => {
 	it("#given static rules #when formatting SessionStart context #then it avoids leading blank lines", () => {
 		// given
 		const rule = loadedRule({
-			path: "/repo/AGENTS.md",
-			relativePath: "AGENTS.md",
+			path: "/repo/CONTEXT.md",
+			relativePath: "CONTEXT.md",
 			body: "Keep generated hook context readable.",
 		});
 
@@ -58,7 +58,7 @@ describe("rules formatter hook context", () => {
 			[
 				"## Project Instructions",
 				"",
-				"Instructions from: /repo/AGENTS.md",
+				"Instructions from: /repo/CONTEXT.md",
 				"",
 				"Keep generated hook context readable.",
 			].join("\n"),
@@ -82,13 +82,13 @@ describe("rules formatter hook context", () => {
 	it("#given duplicate static rules with different line endings #when formatting context #then it renders one copy", () => {
 		// given
 		const lfRule = loadedRule({
-			path: "/repo/AGENTS.md",
-			relativePath: "AGENTS.md",
+			path: "/repo/CONTEXT.md",
+			relativePath: "CONTEXT.md",
 			body: "Shared rule\nKeep one copy.",
 		});
 		const crlfRule = loadedRule({
-			path: "/repo/packages/AGENTS.md",
-			relativePath: "packages/AGENTS.md",
+			path: "/repo/packages/CONTEXT.md",
+			relativePath: "packages/CONTEXT.md",
 			body: "Shared rule\r\nKeep one copy.",
 		});
 
@@ -97,7 +97,7 @@ describe("rules formatter hook context", () => {
 
 		// then
 		expect(occurrenceCount(block, "Shared rule\nKeep one copy.")).toBe(1);
-		expect(block).not.toContain("/repo/packages/AGENTS.md");
+		expect(block).not.toContain("/repo/packages/CONTEXT.md");
 	});
 
 	it("#given multiple oversized rules #when formatting under a tight result budget #then every rule receives a fair truncated share with a read-full guide", () => {
@@ -145,9 +145,9 @@ function loadedRule(input: {
 	readonly source?: RuleSource;
 	readonly matchReason?: MatchReason;
 }): LoadedRule {
-	const path = input.path ?? "/repo/AGENTS.md";
-	const relativePath = input.relativePath ?? "AGENTS.md";
-	const source = input.source ?? "AGENTS.md";
+	const path = input.path ?? "/repo/CONTEXT.md";
+	const relativePath = input.relativePath ?? "CONTEXT.md";
+	const source = input.source ?? "CONTEXT.md";
 	return {
 		path,
 		realPath: path,

package/packages/omo-codex/plugin/components/rules/test/post-compact-test-fixture.ts

@@ -5,7 +5,7 @@ import path from "node:path";
 import type { CodexPostCompactInput, CodexSessionStartInput, CodexUserPromptSubmitInput } from "../src/codex-hook.js";
 
 export const PROJECT_RULES_ENV = {
-	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
 	CODEX_RULES_MAX_RESULT_CHARS: "50000",
 	CODEX_RULES_MAX_RULE_CHARS: "30000",
 };
@@ -30,7 +30,9 @@ export function makeOversizedProject(prefix = "budget"): { root: string; pluginD
 	const pluginData = mkdtempSync(path.join(tmpdir(), `codex-rules-post-compact-${prefix}-data-`));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), `Project rule\n${"A".repeat(30_000)}`);
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), `Project rule\n${"A".repeat(30_000)}`);
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),