holycodex 0.8.1 → 0.8.2-dev.29763019035.1

package/THIRD-PARTY-NOTICES.md

@@ -9,5 +9,3 @@ The caveman communication concept is adapted from [juliusbrussee/caveman](https:
 HolyCodex agent routing and orchestration instructions adapt bounded-role, task-ownership, non-overlapping-write, session-reuse, and verification-planning concepts from [alvinunreal/oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim) at commit `7bc7b56856ee693812d87d68615757d4d1c2e218`, principally `src/agents/{orchestrator,explorer,librarian,fixer}.ts`, `src/skills/verification-planning/SKILL.md`, and `docs/background-orchestration.md`. OpenCode runtime APIs, hooks, council, ACP, companion, and background-session mechanics were not copied. Upstream material is MIT licensed; its license is preserved in `packages/plugin/plugin/LICENSE-OH-MY-OPENCODE-SLIM-MIT.txt`.
 
 The bundled LSP runtime at `packages/plugin/plugin/runtime/lsp.js` is derived from `code-yeongyu/oh-my-openagent`'s `lsp-tools-mcp`. Copyright (c) 2026 Yeongyu Kim; used under the MIT License preserved at `packages/plugin/plugin/runtime/LICENSE-LSP-MIT.txt`.
-
-The `codexslimedit` package and HolyCodex integration adapt compact-read and line-range edit behavior from [ASidorenkoCode/openslimedit](https://github.com/ASidorenkoCode/openslimedit) at commit `d5014929d6f66729b887df74a65ed6d22c3b522b`. Copyright (c) 2026 Artur; used under the MIT License preserved in both published packages. OpenCode hook APIs and token-saving claims were not copied.

package/dist/cli.js

@@ -1,8 +1,8 @@
 import process$1 from "node:process";
-import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { access, copyFile, cp, lstat, mkdir, readFile, readdir, readlink, rename, rm, stat, writeFile } from "node:fs/promises";
 import { homedir, tmpdir } from "node:os";
 import { dirname, join } from "node:path";
+import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { Buffer } from "node:buffer";
 import { pluginRoot } from "@holycodex/plugin";
@@ -3924,170 +3924,8 @@ function superRefine(fn, params) {
 	return /* @__PURE__ */ _superRefine(fn, params);
 }
 //#endregion
-//#region packages/mcp-stdio-core/src/process.ts
-var TRUNCATED_MARKER = "\n... diagnostic output truncated ...\n";
-var defaultManagedProcessRuntime = {
-	terminationGraceMs: 2e3,
-	kill: killProcessTree
-};
-/** Runs managed process. */
-async function runManagedProcess(input, runtime = defaultManagedProcessRuntime) {
-	return await new Promise((resolve) => {
-		const child = spawn(input.command, [...input.args], {
-			...input.cwd === void 0 ? {} : { cwd: input.cwd },
-			...input.env === void 0 ? {} : { env: input.env },
-			stdio: [
-				"pipe",
-				"pipe",
-				"pipe"
-			],
-			windowsHide: true,
-			detached: input.platform !== "win32"
-		});
-		let stdout = {
-			head: "",
-			tail: "",
-			truncated: false
-		};
-		let stderr = {
-			head: "",
-			tail: "",
-			truncated: false
-		};
-		let timedOut = false;
-		let matched = false;
-		let settled = false;
-		let forceKillTimeout;
-		const finish = (exitCode, error) => {
-			if (settled) return;
-			settled = true;
-			clearTimeout(timeout);
-			if (forceKillTimeout !== void 0) clearTimeout(forceKillTimeout);
-			resolve({
-				exitCode,
-				stdout: outputText(stdout),
-				stderr: outputText(stderr),
-				timedOut,
-				matched,
-				outputTruncated: stdout.truncated || stderr.truncated,
-				...error === void 0 ? {} : { error }
-			});
-		};
-		const terminate = () => {
-			if (forceKillTimeout !== void 0) return;
-			runtime.kill(child, input.platform, "SIGTERM");
-			forceKillTimeout = setTimeout(() => {
-				runtime.kill(child, input.platform, "SIGKILL");
-			}, runtime.terminationGraceMs);
-			forceKillTimeout.unref();
-		};
-		const inspectMatch = () => {
-			if (matched || input.matchOutput === void 0) return;
-			if (input.matchOutput(`${outputText(stdout)}\n${outputText(stderr)}`)) {
-				matched = true;
-				terminate();
-			}
-		};
-		child.stdout.on("data", (chunk) => {
-			stdout = appendOutput(stdout, chunk.toString(), input.maxOutputChars);
-			inspectMatch();
-		});
-		child.stderr.on("data", (chunk) => {
-			stderr = appendOutput(stderr, chunk.toString(), input.maxOutputChars);
-			inspectMatch();
-		});
-		child.once("error", (error) => finish(null, error.message));
-		child.once("close", (code) => finish(code));
-		const timeout = setTimeout(() => {
-			timedOut = true;
-			terminate();
-		}, input.timeoutMs);
-		timeout.unref();
-		if (input.stdin === void 0) child.stdin.end();
-		else child.stdin.end(input.stdin);
-	});
-}
-/** Terminates process tree. */
-function killProcessTree(child, platform, signal = "SIGTERM", runTaskkill = (command, args) => spawnSync(command, [...args], {
-	stdio: "ignore",
-	windowsHide: true
-})) {
-	if (platform === "win32" && child.pid !== void 0) {
-		const result = runTaskkill("taskkill", [
-			"/pid",
-			String(child.pid),
-			"/f",
-			"/t"
-		]);
-		if (result.error === void 0 && result.status === 0) return;
-	}
-	if (platform !== "win32" && child.pid !== void 0) try {
-		process.kill(-child.pid, signal);
-		return;
-	} catch {}
-	try {
-		child.kill(signal);
-	} catch {}
-}
-function appendOutput(state, chunk, limit) {
-	const safeLimit = Math.max(1, limit);
-	const headLimit = Math.ceil(safeLimit / 2);
-	const tailLimit = Math.floor(safeLimit / 2);
-	if (!state.truncated && state.head.length + chunk.length <= safeLimit) return {
-		...state,
-		head: state.head + chunk
-	};
-	const combined = state.truncated ? chunk : state.head + chunk;
-	return {
-		head: state.truncated ? state.head : combined.slice(0, headLimit),
-		tail: `${state.tail}${combined.slice(state.truncated ? 0 : headLimit)}`.slice(-tailLimit),
-		truncated: true
-	};
-}
-function outputText(state) {
-	return state.truncated ? `${state.head}${TRUNCATED_MARKER}${state.tail}` : state.head;
-}
-//#endregion
-//#region packages/cli/src/package-runner.ts
-var PACKAGE_INSTALL_TIMEOUT_MS = 12e4;
-var PACKAGE_INSTALL_OUTPUT_LIMIT = 4e3;
-/** Detects whether Bun or npm invoked HolyCodex. */
-function detectPackageRunner(env = process.env) {
-	const executable = (env.npm_execpath ?? "").split(/[\\/]/).at(-1)?.toLowerCase().replace(/\.exe$/, "");
-	const userAgent = env.npm_config_user_agent?.trim().split(/[\s/]/, 1)[0]?.toLowerCase();
-	return executable === "bun" || userAgent === "bun" ? "bun" : "npm";
-}
-/** Builds the runner-specific codexslimedit invocation. */
-function codexSlimEditInvocation(input) {
-	const args = [input.packageVersion.includes("-dev.") ? "codexslimedit@dev" : "codexslimedit@latest", ...input.includeVersion ? ["--version"] : []];
-	return input.packageRunner === "bun" ? {
-		command: "bunx",
-		args
-	} : {
-		command: input.platform === "win32" ? "npx.cmd" : "npx",
-		args: ["--yes", ...args]
-	};
-}
-/** Pre-resolves codexslimedit through the invoking package runner. */
-async function installCodexSlimEdit(input, env = process.env) {
-	if (env.NODE_ENV === "test" && env.HOLYCODEX_TEST_SKIP_PACKAGE_RESOLUTION === "1") return;
-	const invocation = codexSlimEditInvocation({
-		...input,
-		includeVersion: true
-	});
-	const result = await runManagedProcess({
-		...invocation,
-		platform: input.platform,
-		timeoutMs: PACKAGE_INSTALL_TIMEOUT_MS,
-		maxOutputChars: PACKAGE_INSTALL_OUTPUT_LIMIT
-	});
-	if (result.exitCode === 0 && !result.timedOut) return;
-	const detail = result.error ?? (result.stderr.trim() || result.stdout.trim() || "unknown package error");
-	throw new Error(`Could not install codexslimedit with ${invocation.command}: ${detail}. Check package registry and network access, then retry HolyCodex installation.`);
-}
-//#endregion
 //#region packages/cli/src/catalog.ts
-var VERSION = "0.8.1";
+var VERSION = "0.8.2-dev.29763019035.1";
 var SKILLS = [
 	"ast-grep",
 	"caveman",
@@ -4161,7 +3999,12 @@ var RoutingPresetSchema = strictObject({
 		worker: ModelRouteSchema
 	}),
 	usage: strictObject({
-		maxThreads: union([literal(1), literal(2)]),
+		maxSubagents: union([
+			literal(0),
+			literal(1),
+			literal(2),
+			literal(3)
+		]),
 		maxDepth: literal(1)
 	})
 });
@@ -4195,7 +4038,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 1,
+			maxSubagents: 0,
 			maxDepth: 1
 		}
 	},
@@ -4219,14 +4062,14 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 2,
+			maxSubagents: 1,
 			maxDepth: 1
 		}
 	},
 	plus: {
 		root: {
 			model: "gpt-5.6-sol",
-			reasoningEffort: "medium"
+			reasoningEffort: "low"
 		},
 		agents: {
 			explorer: {
@@ -4243,7 +4086,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 2,
+			maxSubagents: 2,
 			maxDepth: 1
 		}
 	},
@@ -4267,7 +4110,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 2,
+			maxSubagents: 2,
 			maxDepth: 1
 		}
 	},
@@ -4291,7 +4134,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 2,
+			maxSubagents: 2,
 			maxDepth: 1
 		}
 	},
@@ -4315,7 +4158,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 2,
+			maxSubagents: 2,
 			maxDepth: 1
 		}
 	}
@@ -4455,19 +4298,13 @@ var GENERATED_RUNTIMES = [
 	"git-bash.js",
 	"git-bash-resolver.js",
 	"LICENSE-LSP-MIT.txt",
-	"LICENSE-OPENSLIMEDIT-MIT.txt",
 	"lsp.js",
 	"mcp-stdio-core.js",
 	"rules.js"
 ];
 var WINDOWS_SHELL_POLICY = "On native Windows, before the first shell action, inspect callable and deferred tools until `mcp__git_bash__run` is resolved. Use it for every shell command, including Git, Bash, POSIX, package, build, test, and script commands. If unavailable, stop and report the blocker. Never fall back to PowerShell or cmd.";
 /** Provides effective mcp servers. */
-function effectiveMcpServers(platform, packageRunner = "bun") {
-	const codexSlimEdit = codexSlimEditInvocation({
-		packageRunner,
-		platform,
-		packageVersion: VERSION
-	});
+function effectiveMcpServers(platform) {
 	return {
 		...platform === "win32" ? { git_bash: {
 			command: "node",
@@ -4480,10 +4317,6 @@ function effectiveMcpServers(platform, packageRunner = "bun") {
 			args: ["runtime/lsp.js", "mcp"],
 			cwd: "."
 		},
-		codexslimedit: {
-			...codexSlimEdit,
-			enabled_tools: ["read_file", "apply_patch"]
-		},
 		context7: {
 			command: "bunx",
 			args: ["@upstash/context7-mcp"]
@@ -4576,6 +4409,130 @@ function missing(checkedPaths) {
 	};
 }
 //#endregion
+//#region packages/mcp-stdio-core/src/process.ts
+var TRUNCATED_MARKER = "\n... diagnostic output truncated ...\n";
+var defaultManagedProcessRuntime = {
+	terminationGraceMs: 2e3,
+	kill: killProcessTree
+};
+/** Runs managed process. */
+async function runManagedProcess(input, runtime = defaultManagedProcessRuntime) {
+	return await new Promise((resolve) => {
+		const child = spawn(input.command, [...input.args], {
+			...input.cwd === void 0 ? {} : { cwd: input.cwd },
+			...input.env === void 0 ? {} : { env: input.env },
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			windowsHide: true,
+			detached: input.platform !== "win32"
+		});
+		let stdout = {
+			head: "",
+			tail: "",
+			truncated: false
+		};
+		let stderr = {
+			head: "",
+			tail: "",
+			truncated: false
+		};
+		let timedOut = false;
+		let matched = false;
+		let settled = false;
+		let forceKillTimeout;
+		const finish = (exitCode, error) => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timeout);
+			if (forceKillTimeout !== void 0) clearTimeout(forceKillTimeout);
+			resolve({
+				exitCode,
+				stdout: outputText(stdout),
+				stderr: outputText(stderr),
+				timedOut,
+				matched,
+				outputTruncated: stdout.truncated || stderr.truncated,
+				...error === void 0 ? {} : { error }
+			});
+		};
+		const terminate = () => {
+			if (forceKillTimeout !== void 0) return;
+			runtime.kill(child, input.platform, "SIGTERM");
+			forceKillTimeout = setTimeout(() => {
+				runtime.kill(child, input.platform, "SIGKILL");
+			}, runtime.terminationGraceMs);
+			forceKillTimeout.unref();
+		};
+		const inspectMatch = () => {
+			if (matched || input.matchOutput === void 0) return;
+			if (input.matchOutput(`${outputText(stdout)}\n${outputText(stderr)}`)) {
+				matched = true;
+				terminate();
+			}
+		};
+		child.stdout.on("data", (chunk) => {
+			stdout = appendOutput(stdout, chunk.toString(), input.maxOutputChars);
+			inspectMatch();
+		});
+		child.stderr.on("data", (chunk) => {
+			stderr = appendOutput(stderr, chunk.toString(), input.maxOutputChars);
+			inspectMatch();
+		});
+		child.once("error", (error) => finish(null, error.message));
+		child.once("close", (code) => finish(code));
+		const timeout = setTimeout(() => {
+			timedOut = true;
+			terminate();
+		}, input.timeoutMs);
+		timeout.unref();
+		if (input.stdin === void 0) child.stdin.end();
+		else child.stdin.end(input.stdin);
+	});
+}
+/** Terminates process tree. */
+function killProcessTree(child, platform, signal = "SIGTERM", runTaskkill = (command, args) => spawnSync(command, [...args], {
+	stdio: "ignore",
+	windowsHide: true
+})) {
+	if (platform === "win32" && child.pid !== void 0) {
+		const result = runTaskkill("taskkill", [
+			"/pid",
+			String(child.pid),
+			"/f",
+			"/t"
+		]);
+		if (result.error === void 0 && result.status === 0) return;
+	}
+	if (platform !== "win32" && child.pid !== void 0) try {
+		process.kill(-child.pid, signal);
+		return;
+	} catch {}
+	try {
+		child.kill(signal);
+	} catch {}
+}
+function appendOutput(state, chunk, limit) {
+	const safeLimit = Math.max(1, limit);
+	const headLimit = Math.ceil(safeLimit / 2);
+	const tailLimit = Math.floor(safeLimit / 2);
+	if (!state.truncated && state.head.length + chunk.length <= safeLimit) return {
+		...state,
+		head: state.head + chunk
+	};
+	const combined = state.truncated ? chunk : state.head + chunk;
+	return {
+		head: state.truncated ? state.head : combined.slice(0, headLimit),
+		tail: `${state.tail}${combined.slice(state.truncated ? 0 : headLimit)}`.slice(-tailLimit),
+		truncated: true
+	};
+}
+function outputText(state) {
+	return state.truncated ? `${state.head}${TRUNCATED_MARKER}${state.tail}` : state.head;
+}
+//#endregion
 //#region packages/cli/src/toml.ts
 var TOML_TABLE = /^[ \t]*(?:\[[^\]\r\n]+\]|\[\[[^\]\r\n]+\]\])[ \t]*(?:#.*)?$/m;
 /** Reads a root TOML string value. */
@@ -4666,6 +4623,7 @@ var END = "# <<< holycodex managed <<<";
 var ORIGINAL_ROOT = "# holycodex original root: ";
 var ORIGINAL_TABLE_KEY = "# holycodex original table key: ";
 var PLAN_PREFIX = "# holycodex plan: ";
+var MAX_SUBAGENTS_PREFIX = "# holycodex max-subagents: ";
 var OLD_NAMESPACES = [
 	"marketplaces.sisyphuslabs",
 	"plugins.\"omo@sisyphuslabs\"",
@@ -4743,6 +4701,16 @@ function readManagedPlan(input) {
 	const value = new RegExp(`^${PLAN_PREFIX}(.+)$`, "m").exec(input)?.[1]?.trim();
 	return PLAN_NAMES.find((plan) => plan === value);
 }
+/** Reads an explicit managed direct-subagent override. */
+function readManagedMaxSubagents(input) {
+	const raw = new RegExp(`^${MAX_SUBAGENTS_PREFIX}(.*)$`, "m").exec(input)?.[1]?.trim();
+	if (raw === void 0) return { configured: false };
+	if (!/^[0-3]$/.test(raw)) return { configured: true };
+	return {
+		configured: true,
+		value: Number(raw)
+	};
+}
 /** Identifies explicit Root route overrides preserved from active managed configuration. */
 function readPreservedRootOverrides(input) {
 	const managedRoot = new RegExp(`^${START}\\r?\\n([\\s\\S]*?)^${END}\\r?$`, "m").exec(input)?.[1];
@@ -4797,7 +4765,7 @@ function mergedStatusLine(original) {
 	return `[${items.map((item) => JSON.stringify(item)).join(", ")}]`;
 }
 /** Installs config. */
-function installConfig(input, mode, _platform, plan = DEFAULT_PLAN) {
+function installConfig(input, mode, _platform, plan = DEFAULT_PLAN, maxSubagents) {
 	const base = preserveManagedRootPreferences(input, removeLegacyOmo(removeManaged(input)));
 	const firstTable = base.search(/^\s*\[/m);
 	const root = firstTable < 0 ? base : base.slice(0, firstTable);
@@ -4814,17 +4782,20 @@ function installConfig(input, mode, _platform, plan = DEFAULT_PLAN) {
 	const hasEffort = /^\s*model_reasoning_effort\s*=/m.test(preservedRoot);
 	const hasVerbosity = /^\s*model_verbosity\s*=/m.test(preservedRoot);
 	const rootRoute = MODEL_ROUTING_PLANS[plan].root;
+	const effectiveMaxSubagents = maxSubagents ?? MODEL_ROUTING_PLANS[plan].usage.maxSubagents;
 	const model = hasModel ? "" : `model = "${rootRoute.model}"\n`;
 	const effort = hasEffort ? "" : `model_reasoning_effort = "${rootRoute.reasoningEffort}"\n`;
 	const verbosity = hasVerbosity ? "" : "model_verbosity = \"low\"\n";
 	const approval = mode === "default" ? "on-request" : "never";
 	const sandbox = mode === "dangerous" ? "danger-full-access" : "workspace-write";
-	let configured = `${`${START}\n${PLAN_PREFIX}${plan}\n${originalRoot ? `${ORIGINAL_ROOT}${Buffer.from(originalRoot).toString("base64")}\n` : ""}${model}${effort}${verbosity}${preservedRoot ? `${preservedRoot}\n` : ""}approval_policy = "${approval}"\nsandbox_mode = "${sandbox}"\nstatus_line = ${mergedStatusLine(controlled[3])}\n${END}`}${tables ? `\n\n${tables}` : ""}`;
+	const original = originalRoot ? `${ORIGINAL_ROOT}${Buffer.from(originalRoot).toString("base64")}\n` : "";
+	const preserved = preservedRoot ? `${preservedRoot}\n` : "";
+	let configured = `${`${START}\n${PLAN_PREFIX}${plan}\n${maxSubagents === void 0 ? "" : `${MAX_SUBAGENTS_PREFIX}${maxSubagents}\n`}${original}${model}${effort}${verbosity}${preserved}approval_policy = "${approval}"\nsandbox_mode = "${sandbox}"\nstatus_line = ${mergedStatusLine(controlled[3])}\n${END}`}${tables ? `\n\n${tables}` : ""}`;
 	configured = injectTableKey(configured, "features", "default_mode_request_user_input", "true");
 	configured = injectTableKey(configured, "features", "multi_agent", "true");
 	configured = injectTableKey(configured, "features", "multi_agent_v2", "true");
 	const usage = MODEL_ROUTING_PLANS[plan].usage;
-	configured = injectTableKey(configured, "agents", "max_threads", String(usage.maxThreads));
+	configured = injectTableKey(configured, "agents", "max_threads", String(effectiveMaxSubagents + 1));
 	configured = injectTableKey(configured, "agents", "max_depth", String(usage.maxDepth));
 	if (mode !== "dangerous") configured = injectTableKey(configured, "sandbox_workspace_write", "network_access", "true");
 	for (const agent of AGENTS) configured = injectTableKey(configured, `agents.${agent}`, "config_file", `"holycodex/agents/${agent}.toml"`);
@@ -4879,10 +4850,7 @@ async function startContext7(platform) {
 }
 var defaultRuntime$1 = {
 	platform: process.platform,
-	command: (name, args) => process.env.NODE_ENV === "test" && process.env.HOLYCODEX_TEST_SKIP_PACKAGE_RESOLUTION === "1" && args.some((argument) => argument.startsWith("codexslimedit@")) ? Promise.resolve({
-		ok: true,
-		output: "package resolution skipped in tests"
-	}) : runCommand(name, args, process.platform),
+	command: (name, args) => runCommand(name, args, process.platform),
 	context7: () => startContext7(process.platform),
 	gitBash: resolveGitBashForCurrentProcess
 };
@@ -4937,6 +4905,13 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 	const pluginRoot = join(home, "plugins", "cache", "holycodex", "holycodex", VERSION);
 	const agentRoot = join(home, "holycodex", "agents");
 	const configPath = join(home, "config.toml");
+	let config = "";
+	let configAvailable = true;
+	try {
+		config = await readFile(configPath, "utf8");
+	} catch {
+		configAvailable = false;
+	}
 	const missing = await missingFiles(pluginRoot, [
 		".codex-plugin/plugin.json",
 		".mcp.json",
@@ -4961,12 +4936,6 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 		const expected = expectedMcps[name];
 		checks.push(configured === void 0 || expected === void 0 ? check(`mcp-${name}`, "error", "missing-required-mcp", `${name} is not configured.`, "Reinstall HolyCodex.") : !mcpConfigMatches(configured, expected) ? check(`mcp-${name}`, "error", "invalid-required-mcp-config", `${name} configuration is stale or contains unsupported settings.`, "Reinstall HolyCodex.") : check(`mcp-${name}`, "ok", "required-mcp-ready", `${name} is configured locally.`));
 	}
-	const codexSlimEdit = servers?.codexslimedit;
-	const codexSlimEditConfig = ["bun", "npm"].map((runner) => effectiveMcpServers(runtime.platform, runner).codexslimedit).find((expected) => {
-		return expected !== void 0 && codexSlimEdit !== void 0 && mcpConfigMatches(codexSlimEdit, expected);
-	});
-	const codexSlimEditStarted = codexSlimEditConfig === void 0 ? void 0 : await runtime.command(codexSlimEditConfig.command, [...codexSlimEditConfig.args, "--version"]);
-	checks.push(codexSlimEdit === void 0 ? check("mcp-codexslimedit", "error", "missing-codexslimedit", "codexslimedit is not configured.", "Reinstall HolyCodex.") : codexSlimEditStarted?.ok === true ? check("mcp-codexslimedit", "ok", "codexslimedit-ready", "codexslimedit is configured through npm or Bun.") : codexSlimEditConfig === void 0 ? check("mcp-codexslimedit", "error", "invalid-codexslimedit-config", "codexslimedit configuration is stale or uses an unsupported runner.", "Reinstall HolyCodex.") : check("mcp-codexslimedit", "error", "codexslimedit-unavailable", `codexslimedit could not start: ${codexSlimEditStarted?.output || "unknown runner error"}`, "Check the configured package runner and network access, then reinstall HolyCodex."));
 	const gitBashConfig = servers?.git_bash;
 	if (runtime.platform === "win32" && gitBashConfig !== void 0) {
 		const expected = effectiveMcpServers("win32").git_bash;
@@ -4997,19 +4966,16 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 		const gitBash = runtime.gitBash();
 		checks.push(gitBash.found ? check("git-bash", "ok", "git-bash-ready", `Git Bash: ${gitBash.path ?? "configured"}.`) : check("git-bash", "error", "missing-git-bash", "Git Bash is required on Windows but unavailable.", gitBash.installHint));
 	} else checks.push(check("git-bash", "ok", "git-bash-not-applicable", "Git Bash is not applicable on this platform."));
-	let config = "";
-	try {
-		config = await readFile(configPath, "utf8");
-	} catch {
-		checks.push(check("codex-config", "error", "missing-codex-config", `Missing ${configPath}.`, "Run holycodex install."));
-	}
+	if (!configAvailable) checks.push(check("codex-config", "error", "missing-codex-config", `Missing ${configPath}.`, "Run holycodex install."));
 	const mode = autonomy(config);
 	const plan = readManagedPlan(config);
 	checks.push(plan === void 0 ? check("routing-plan", "error", "routing-plan-missing", "No managed model routing plan is recorded.", "Rerun holycodex install.") : check("routing-plan", "ok", "routing-plan-ready", `Model routing plan ${plan} is active.`));
 	const preset = plan === void 0 ? void 0 : MODEL_ROUTING_PLANS[plan];
+	const managedMaxSubagents = readManagedMaxSubagents(config);
+	const expectedMaxSubagents = managedMaxSubagents.configured ? managedMaxSubagents.value : preset?.usage.maxSubagents;
 	const rootOverrides = readPreservedRootOverrides(config);
 	checks.push(preset !== void 0 && rootTomlString(config, "model") === preset.root.model && rootTomlString(config, "model_reasoning_effort") === preset.root.reasoningEffort ? check("root-model", "ok", "root-model-ready", "Root model matches the selected routing plan.") : rootOverrides.model || rootOverrides.reasoningEffort ? check("root-model", "ok", "root-model-override", "Root model uses an intentionally preserved explicit override.") : check("root-model", "error", "root-model-stale", "Root model configuration does not match the selected routing plan.", "Reinstall HolyCodex."));
-	checks.push(preset === void 0 || tableInteger(config, "agents", "max_threads") !== preset.usage.maxThreads || tableInteger(config, "agents", "max_depth") !== preset.usage.maxDepth ? check("agent-usage", "error", "agent-usage-stale", "Agent concurrency configuration does not match the selected routing plan.", "Reinstall HolyCodex.") : check("agent-usage", "ok", "agent-usage-ready", "Agent concurrency matches the selected routing plan."));
+	checks.push(preset === void 0 || expectedMaxSubagents === void 0 || tableInteger(config, "agents", "max_threads") !== expectedMaxSubagents + 1 || tableInteger(config, "agents", "max_depth") !== preset.usage.maxDepth ? check("agent-usage", "error", "agent-usage-stale", "Agent concurrency configuration does not match the selected routing plan or explicit override.", "Reinstall HolyCodex.") : check("agent-usage", "ok", "agent-usage-ready", `Agent concurrency allows ${expectedMaxSubagents} direct subagent${expectedMaxSubagents === 1 ? "" : "s"}.`));
 	checks.push(mode === "unknown" ? check("autonomy", "error", "invalid-autonomy-config", "Approval, sandbox, and network settings do not match a supported mode.", "Rerun install with the intended autonomy flag.") : mode === "dangerous" ? check("autonomy", "warning", "dangerous-autonomy", "Explicit dangerous autonomy is active; workspace containment is removed.") : check("autonomy", "ok", `${mode}-ready`, mode === "safe-workspace" ? "Safe workspace autonomy is active." : "Approval-free workspace autonomy is active."));
 	checks.push(tableBoolean(config, "features", "default_mode_request_user_input") === true ? check("user-input", "ok", "user-input-ready", "default_mode_request_user_input is enabled.") : check("user-input", "error", "user-input-disabled", "default_mode_request_user_input is not enabled.", "Rerun holycodex install."));
 	checks.push(rootTomlStringArray(config, "status_line")?.includes("context-remaining") === true ? check("context-visibility", "warning", "context-visible-support-unverified", "status_line includes context-remaining. Current official Codex config documents this item, but publishes no minimum compatible Codex version.") : check("context-visibility", "error", "context-hidden", "status_line does not include context-remaining.", "Rerun holycodex install."));
@@ -5078,13 +5044,7 @@ async function readText(path) {
 //#region packages/cli/src/install.ts
 var defaultRuntime = {
 	platform: process.platform,
-	gitBash: resolveGitBashForCurrentProcess,
-	packageRunner: detectPackageRunner(),
-	installCodexSlimEdit: async (packageRunner) => installCodexSlimEdit({
-		packageRunner,
-		packageVersion: VERSION,
-		platform: process.platform
-	})
+	gitBash: resolveGitBashForCurrentProcess
 };
 function paths(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")) {
 	const marketplaceCache = join(home, "plugins", "cache", "holycodex");
@@ -5114,7 +5074,6 @@ function assertGitBashReady(platform, resolution) {
 /** Provides install. */
 async function install(options, runtime = defaultRuntime) {
 	assertGitBashReady(runtime.platform, runtime.gitBash());
-	await runtime.installCodexSlimEdit(runtime.packageRunner);
 	const plan = options.plan ?? "plus";
 	const target = paths();
 	const root = backupRoot();
@@ -5126,7 +5085,8 @@ async function install(options, runtime = defaultRuntime) {
 	].filter((path) => path !== void 0);
 	const existingConfig = await readText(target.config);
 	const previousPlan = readManagedPlan(existingConfig);
-	const config = installConfig(existingConfig, options.autonomy, runtime.platform, plan);
+	const maxSubagents = options.maxSubagents ?? MODEL_ROUTING_PLANS[plan].usage.maxSubagents;
+	const config = installConfig(existingConfig, options.autonomy, runtime.platform, plan, options.maxSubagents);
 	await atomicWrite(target.config, config);
 	await rm(target.marketplaceCache, {
 		recursive: true,
@@ -5134,7 +5094,7 @@ async function install(options, runtime = defaultRuntime) {
 	});
 	await mkdir(dirname(target.cache), { recursive: true });
 	await cp(pluginRoot, target.cache, { recursive: true });
-	await writePlatformPlugin(target.cache, runtime.platform, plan, runtime.packageRunner);
+	await writePlatformPlugin(target.cache, runtime.platform, plan);
 	const existingAgentPreferences = await readAgentPreferences(target.agents, previousPlan);
 	await rm(target.agents, {
 		recursive: true,
@@ -5158,7 +5118,8 @@ async function install(options, runtime = defaultRuntime) {
 			...removedLegacy
 		],
 		backups,
-		plan
+		plan,
+		maxSubagents
 	};
 }
 async function readAgentPreferences(root, previousPlan) {
@@ -5189,8 +5150,8 @@ async function preserveAgentPreferences(root, preferences) {
 function replaceTomlString(input, key, value) {
 	return input.replace(new RegExp(`^${key}\\s*=.*$`, "m"), `${key} = ${JSON.stringify(value)}`);
 }
-async function writePlatformPlugin(root, platform, plan, packageRunner) {
-	await atomicWrite(join(root, ".mcp.json"), `${JSON.stringify({ mcpServers: effectiveMcpServers(platform, packageRunner) }, null, 2)}\n`);
+async function writePlatformPlugin(root, platform, plan) {
+	await atomicWrite(join(root, ".mcp.json"), `${JSON.stringify({ mcpServers: effectiveMcpServers(platform) }, null, 2)}\n`);
 	await writeInstalledAgents(join(root, "agents"), platform, plan);
 }
 async function writeInstalledAgents(root, platform, plan) {
@@ -5270,13 +5231,13 @@ function renderHelp(version, color) {
 	const title = paint(color, `${BOLD}${CYAN}`, `HOLYCODEX ${version}`);
 	const section = (text) => paint(color, BOLD, text);
 	const muted = (text) => paint(color, DIM, text);
-	return `${title}\n${muted("Lean Codex toolkit installer and doctor")}\n\n${section("USAGE")}\n  holycodex <command> [options]\n\n${section("COMMANDS")}\n  install                         Install or update HolyCodex\n  cleanup                         Remove HolyCodex-owned state\n  doctor                          Diagnose installation and runtime\n\n${section("OPTIONS")}\n  --plan <plan>                   Model routing plan for install: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  -h, --help                      Show help\n  -v, --version                   Show version\n  --no-tui                        Accepted; commands remain noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  --json                          Print machine-readable output\n`;
+	return `${title}\n${muted("Lean Codex toolkit installer and doctor")}\n\n${section("USAGE")}\n  holycodex <command> [options]\n\n${section("COMMANDS")}\n  install                         Install or update HolyCodex\n  cleanup                         Remove HolyCodex-owned state\n  doctor                          Diagnose installation and runtime\n\n${section("OPTIONS")}\n  --plan <plan>                   Model routing plan for install: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --max-subagents <0-3>          Override concurrent direct subagents for install\n  -h, --help                      Show help\n  -v, --version                   Show version\n  --no-tui                        Accepted; commands remain noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  --json                          Print machine-readable output\n`;
 }
 /** Renders install-specific model plan and option help. */
 function renderInstallHelp(version, color) {
 	const title = paint(color, `${BOLD}${CYAN}`, `HOLYCODEX ${version}`);
 	const section = (text) => paint(color, BOLD, text);
-	return `${title}\n\n${section("Usage:")}\n  holycodex install [options]\n\n${section("Options:")}\n  --plan <plan>                   Model routing plan: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --json                          Print machine-readable output\n  --no-tui                        Accepted; install remains noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  -h, --help                      Show help\n\nPlans provide increasing expected model usage and capability.\n\n${section("Examples:")}\n  bunx holycodex install\n  bunx holycodex install --plan go\n  bunx holycodex install --plan plus-low\n  bunx holycodex install --plan plus-high\n  bunx holycodex install --plan pro-5x\n  bunx holycodex install --plan pro-20x\n`;
+	return `${title}\n\n${section("Usage:")}\n  holycodex install [options]\n\n${section("Options:")}\n  --plan <plan>                   Model routing plan: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --max-subagents <0-3>          Override concurrent direct subagents\n  --json                          Print machine-readable output\n  --no-tui                        Accepted; install remains noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  -h, --help                      Show help\n\nPlans provide increasing expected model usage and capability.\n\n${section("Examples:")}\n  bunx holycodex install\n  bunx holycodex install --plan go\n  bunx holycodex install --plan plus-low\n  bunx holycodex install --plan plus-high\n  bunx holycodex install --plan pro-5x\n  bunx holycodex install --plan pro-20x\n`;
 }
 /** Renders error. */
 function renderError(message, color) {
@@ -5304,7 +5265,7 @@ async function main() {
 	const args = process$1.argv.slice(2);
 	const stdoutColor = supportsColor(process$1.stdout.isTTY, process$1.env.NO_COLOR);
 	const stderrColor = supportsColor(process$1.stderr.isTTY, process$1.env.NO_COLOR);
-	const command = args.find((arg, index) => !arg.startsWith("-") && args[index - 1] !== "--plan");
+	const command = args.find((arg, index) => !arg.startsWith("-") && args[index - 1] !== "--plan" && args[index - 1] !== "--max-subagents");
 	if (args.includes("--help") || args.includes("-h") || args.length === 0) {
 		process$1.stdout.write(command === "install" ? renderInstallHelp(VERSION, stdoutColor) : renderHelp(VERSION, stdoutColor));
 		return;
@@ -5320,6 +5281,12 @@ async function main() {
 	const parsedPlan = PlanNameSchema.safeParse(planValue);
 	if (!parsedPlan.success) throw new Error(`Unknown plan: ${planValue}. Valid plans: ${PLAN_NAMES.join(", ")}.`);
 	const plan = parsedPlan.data;
+	if (args.flatMap((arg, index) => arg === "--max-subagents" ? [index] : []).length > 1) throw new Error("--max-subagents may be specified only once.");
+	const maxSubagentsIndex = args.indexOf("--max-subagents");
+	const maxSubagentsValue = maxSubagentsIndex < 0 ? void 0 : args[maxSubagentsIndex + 1];
+	if (maxSubagentsIndex >= 0 && (maxSubagentsValue === void 0 || maxSubagentsValue.startsWith("-") || maxSubagentsValue === command)) throw new Error("Missing --max-subagents value. Valid range: 0-3.");
+	if (maxSubagentsValue !== void 0 && !/^[0-3]$/.test(maxSubagentsValue)) throw new Error(`Invalid --max-subagents value: ${maxSubagentsValue}. Valid range: 0-3.`);
+	const maxSubagents = maxSubagentsValue === void 0 ? void 0 : Number(maxSubagentsValue);
 	const autonomyFlags = args.filter((arg) => [
 		"--codex-autonomous",
 		"--no-codex-autonomous",
@@ -5333,7 +5300,8 @@ async function main() {
 	const options = {
 		autonomy: args.includes("--dangerous-codex-autonomous") ? "dangerous" : args.includes("--codex-autonomous") ? "autonomous" : "default",
 		json: args.includes("--json"),
-		plan
+		plan,
+		...maxSubagents === void 0 ? {} : { maxSubagents }
 	};
 	if (command === "doctor") {
 		const result = await doctor();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.8.1",
+  "version": "0.8.2-dev.29763019035.1",
   "description": "Lean Codex-only agent toolkit installer and doctor",
   "keywords": [
     "agents",
@@ -39,7 +39,7 @@
     "prepack": "vp run --workspace-root build"
   },
   "dependencies": {
-    "@holycodex/plugin": "0.8.1",
+    "@holycodex/plugin": "0.8.2-dev.29763019035.1",
     "zod": "^4.4.3"
   },
   "engines": {