holycodex 0.9.3 → 0.9.5

package/README.md

@@ -7,6 +7,6 @@ bunx holycodex@dev install
 bunx holycodex@dev doctor
 ```
 
-Use `holycodex --help` for commands and autonomy options. Stable releases use `bunx holycodex`; development releases use npm's `dev` dist-tag.
+Use `holycodex --help` for commands, autonomy options, and service tiers. `--fast` selects the fast tier; `--no-fast` or omitting both tier flags selects the default. Stable releases use `bunx holycodex`; development releases use npm's `dev` dist-tag.
 
 Repository, documentation, license, and security notices: https://github.com/davidbasilefilho/holycodex

package/dist/cli.js

@@ -4252,7 +4252,7 @@ function superRefine(fn, params) {
 }
 //#endregion
 //#region packages/cli/src/catalog.ts
-var VERSION = "0.9.3";
+var VERSION = "0.9.5";
 var SKILLS = [
 	"ast-grep",
 	"caveman",
@@ -4385,7 +4385,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			},
 			librarian: {
 				model: "gpt-5.6-terra",
-				reasoningEffort: "low"
+				reasoningEffort: "medium"
 			},
 			worker: {
 				model: "gpt-5.6-terra",
@@ -4412,8 +4412,8 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 				reasoningEffort: "high"
 			},
 			worker: {
-				model: "gpt-5.6-sol",
-				reasoningEffort: "low"
+				model: "gpt-5.6-terra",
+				reasoningEffort: "high"
 			}
 		},
 		usage: {
@@ -4432,8 +4432,8 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 				reasoningEffort: "high"
 			},
 			librarian: {
-				model: "gpt-5.6-luna",
-				reasoningEffort: "xhigh"
+				model: "gpt-5.6-terra",
+				reasoningEffort: "high"
 			},
 			worker: {
 				model: "gpt-5.6-sol",
@@ -4456,8 +4456,8 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 				reasoningEffort: "xhigh"
 			},
 			librarian: {
-				model: "gpt-5.6-luna",
-				reasoningEffort: "xhigh"
+				model: "gpt-5.6-sol",
+				reasoningEffort: "medium"
 			},
 			worker: {
 				model: "gpt-5.6-sol",
@@ -4500,6 +4500,9 @@ var LEGACY_MANAGED_AGENT_MODEL_HISTORY = {
 		librarian: [{
 			model: "gpt-5.6-luna",
 			reasoningEffort: "low"
+		}, {
+			model: "gpt-5.6-terra",
+			reasoningEffort: "low"
 		}],
 		worker: [{
 			model: "gpt-5.6-terra",
@@ -4518,6 +4521,9 @@ var LEGACY_MANAGED_AGENT_MODEL_HISTORY = {
 		worker: [{
 			model: "gpt-5.6-terra",
 			reasoningEffort: "high"
+		}, {
+			model: "gpt-5.6-sol",
+			reasoningEffort: "low"
 		}]
 	},
 	"pro-5x": {
@@ -4531,6 +4537,9 @@ var LEGACY_MANAGED_AGENT_MODEL_HISTORY = {
 		librarian: [{
 			model: "gpt-5.6-terra",
 			reasoningEffort: "high"
+		}, {
+			model: "gpt-5.6-luna",
+			reasoningEffort: "xhigh"
 		}],
 		worker: [{
 			model: "gpt-5.6-terra",
@@ -4545,13 +4554,20 @@ var LEGACY_MANAGED_AGENT_MODEL_HISTORY = {
 			model: "gpt-5.6-sol",
 			reasoningEffort: "medium"
 		}],
-		librarian: [{
-			model: "gpt-5.6-terra",
-			reasoningEffort: "high"
-		}, {
-			model: "gpt-5.6-sol",
-			reasoningEffort: "medium"
-		}],
+		librarian: [
+			{
+				model: "gpt-5.6-terra",
+				reasoningEffort: "high"
+			},
+			{
+				model: "gpt-5.6-sol",
+				reasoningEffort: "medium"
+			},
+			{
+				model: "gpt-5.6-luna",
+				reasoningEffort: "xhigh"
+			}
+		],
 		worker: [{
 			model: "gpt-5.6-terra",
 			reasoningEffort: "high"
@@ -4975,8 +4991,8 @@ function removeManaged(input) {
 	return input.replace(new RegExp(`${escapedStart}([\\s\\S]*?)${escapedEnd}(?:\\r?\\n){0,2}`, "g"), (_match, body) => {
 		const encoded = body.match(/^# holycodex original root: ([A-Za-z0-9+/=]+)$/m)?.[1];
 		if (encoded !== void 0) return `${Buffer.from(encoded, "base64").toString("utf8")}\n`;
-		const tableKey = body.match(/^# holycodex original table key: ([A-Za-z0-9+/=]+)$/m)?.[1];
-		return tableKey === void 0 ? "" : `${Buffer.from(tableKey, "base64").toString("utf8")}\n`;
+		const tableKeys = [...body.matchAll(/^# holycodex original table key: ([A-Za-z0-9+/=]+)$/gm)].flatMap((match) => match[1] === void 0 ? [] : [match[1]]);
+		return tableKeys.length === 0 ? "" : `${tableKeys.map((key) => Buffer.from(key, "base64").toString("utf8")).join("\n")}\n`;
 	}).trim();
 }
 /** Removes legacy omo. */
@@ -4992,18 +5008,17 @@ function removeLegacyOmo(input) {
 		].some((name) => header === name || header.startsWith(`${name}.`)) || !/(?:sisyphuslabs|omo@|oh-my|code-yeongyu)/i.test(section);
 	}).join("").trimEnd();
 }
-function injectTableKey(input, table, key, value) {
+function injectTableKeys(input, table, entries) {
 	const match = new RegExp(`^\\s*\\[${table.replaceAll(".", "\\.")}]\\s*(?:#.*)?$`, "m").exec(input);
 	const tail = match === null ? "" : input.slice(match.index + match[0].length);
 	const tableEnd = nextTableBoundary(tail);
 	const tableBody = tableEnd < 0 ? tail : tail.slice(0, tableEnd);
-	const originalKey = new RegExp(`^[ \\t]*${key}[ \\t]*=.*$`, "m").exec(tableBody)?.[0];
-	const managed = `${START}\n${originalKey === void 0 ? "" : `${ORIGINAL_TABLE_KEY}${Buffer.from(originalKey).toString("base64")}\n`}${key} = ${value}\n${END}`;
-	if (match === null) return `${input.trimEnd()}\n\n${START}\n[${table}]\n${key} = ${value}\n${END}`.trim();
+	const managed = `${START}\n${entries.map(([key]) => new RegExp(`^[ \\t]*${key}[ \\t]*=.*$`, "m").exec(tableBody)?.[0]).filter((value) => value !== void 0).map((value) => `${ORIGINAL_TABLE_KEY}${Buffer.from(value).toString("base64")}\n`).join("")}${entries.map(([key, value]) => `${key} = ${value}`).join("\n")}\n${END}`;
+	if (match === null) return `${input.trimEnd()}\n\n${START}\n[${table}]\n${entries.map(([key, value]) => `${key} = ${value}`).join("\n")}\n${END}`.trim();
 	const bodyStart = match.index + match[0].length;
 	const next = nextTableBoundary(input.slice(bodyStart));
 	const bodyEnd = next < 0 ? input.length : bodyStart + next;
-	const cleanedBody = input.slice(bodyStart, bodyEnd).replace(new RegExp(`^\\s*${key}\\s*=.*\\r?\\n?`, "gm"), "").trim();
+	const cleanedBody = entries.reduce((body, [key]) => body.replace(new RegExp(`^\\s*${key}\\s*=.*\\r?\\n?`, "gm"), ""), input.slice(bodyStart, bodyEnd)).trim();
 	const suffix = input.slice(bodyEnd).trimStart();
 	return `${input.slice(0, bodyStart)}\n${cleanedBody ? `${cleanedBody}\n` : ""}${managed}${suffix ? `\n${suffix}` : ""}`.trim();
 }
@@ -5021,6 +5036,14 @@ function rootValue(input, key) {
 function removeRootValue(input, value) {
 	return value === void 0 ? input : input.replace(value, "");
 }
+function removeRootKey(input, key) {
+	let updated = input;
+	for (;;) {
+		const value = rootValue(updated, key);
+		if (value === void 0) return updated;
+		updated = removeRootValue(updated, value);
+	}
+}
 /** Reads the explicitly recorded model routing plan from managed configuration. */
 function readManagedPlan(input) {
 	const value = new RegExp(`^${PLAN_PREFIX}(.+)$`, "m").exec(input)?.[1]?.trim();
@@ -5044,8 +5067,8 @@ function readPreservedRootOverrides(input) {
 		reasoningEffort: false
 	};
 	const plan = readManagedPlan(managedRoot);
-	const model = rootTomlString(managedRoot, "model");
-	const reasoningEffort = rootTomlString(managedRoot, "model_reasoning_effort");
+	const model = rootTomlString(input, "model");
+	const reasoningEffort = rootTomlString(input, "model_reasoning_effort");
 	if (plan === void 0 || model === void 0 || reasoningEffort === void 0) return {
 		model: false,
 		reasoningEffort: false
@@ -5075,11 +5098,6 @@ function preserveManagedRootPreferences(input, base) {
 		updatedRoot = removeRootValue(updatedRoot, rootValue(updatedRoot, key)).trim();
 		updatedRoot = `${updatedRoot}${updatedRoot ? "\n" : ""}${live}`;
 	}
-	const verbosity = rootValue(managedRoot, "model_verbosity")?.trim();
-	if (verbosity !== void 0 && verbosity !== (rootValue(root, "model_verbosity")?.trim() ?? "model_verbosity = \"low\"")) {
-		updatedRoot = removeRootValue(updatedRoot, rootValue(updatedRoot, "model_verbosity")).trim();
-		updatedRoot = `${updatedRoot}${updatedRoot ? "\n" : ""}${verbosity}`;
-	}
 	if (updatedRoot === root.trim()) return base;
 	return `${updatedRoot}${tables ? `\n${tables.trimStart()}` : ""}`;
 }
@@ -5090,7 +5108,7 @@ function mergedStatusLine(original) {
 	return `[${items.map((item) => JSON.stringify(item)).join(", ")}]`;
 }
 /** Installs config. */
-function installConfig(input, mode, _platform, plan = DEFAULT_PLAN, maxSubagents) {
+function installConfig(input, mode, _platform, plan = DEFAULT_PLAN, maxSubagents, fast = false) {
 	const base = preserveManagedRootPreferences(input, removeLegacyOmo(removeManaged(input)));
 	const firstTable = base.search(/^\s*\[/m);
 	const root = firstTable < 0 ? base : base.slice(0, firstTable);
@@ -5099,31 +5117,41 @@ function installConfig(input, mode, _platform, plan = DEFAULT_PLAN, maxSubagents
 		"approval_policy",
 		"sandbox_mode",
 		"max_concurrent_threads_per_session",
-		"status_line"
+		"status_line",
+		"model_verbosity",
+		"service_tier"
 	].map((key) => rootValue(root, key));
-	const originalRoot = root.trim();
-	const preservedRoot = controlled.reduce(removeRootValue, root).trim();
+	const preservedRoot = [
+		"approval_policy",
+		"sandbox_mode",
+		"max_concurrent_threads_per_session",
+		"status_line",
+		"model_verbosity",
+		"service_tier"
+	].reduce(removeRootKey, root).trim();
+	const originalControlled = controlled.filter((value) => value !== void 0).sort((left, right) => root.indexOf(left) - root.indexOf(right)).join("\n");
 	const hasModel = /^\s*model\s*=/m.test(preservedRoot);
 	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";
-	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 original = originalControlled ? `${ORIGINAL_ROOT}${Buffer.from(originalControlled).toString("base64")}\n` : "";
+	const rootBlock = `${START}\n${PLAN_PREFIX}${plan}\n${maxSubagents === void 0 ? "" : `${MAX_SUBAGENTS_PREFIX}${maxSubagents}\n`}${original}${model}${effort}model_verbosity = "low"\nservice_tier = "${fast ? "fast" : "default"}"\napproval_policy = "${approval}"\nsandbox_mode = "${sandbox}"\nstatus_line = ${mergedStatusLine(controlled[3])}\n${END}`;
+	let configured = `${preservedRoot ? `${preservedRoot}\n` : ""}${rootBlock}${tables ? `\n\n${tables}` : ""}`;
+	configured = injectTableKeys(configured, "features", [
+		["default_mode_request_user_input", "true"],
+		["multi_agent", "true"],
+		["multi_agent_v2", "true"]
+	]);
 	const usage = MODEL_ROUTING_PLANS[plan].usage;
-	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"`);
+	configured = injectTableKeys(configured, "agents", [["max_threads", String(effectiveMaxSubagents + 1)], ["max_depth", String(usage.maxDepth)]]);
+	if (mode !== "dangerous") configured = injectTableKeys(configured, "sandbox_workspace_write", [["network_access", "true"]]);
+	configured = injectTableKeys(configured, "desktop", [["enabled-reasoning-efforts", "[\"low\", \"medium\", \"high\"]"], ["show-context-window-usage", "true"]]);
+	if (_platform === "win32") configured = injectTableKeys(configured, "windows", [["sandbox", "\"unelevated\""]]);
+	for (const agent of AGENTS) configured = injectTableKeys(configured, `agents.${agent}`, [["config_file", `"holycodex/agents/${agent}.toml"`]]);
 	const plugin = `${START}\n[plugins."holycodex@holycodex"]\nenabled = true\n${END}`;
 	return `${configured.trim()}\n\n${plugin}\n`;
 }
@@ -5210,6 +5238,14 @@ function tableBoolean(config, table, key) {
 	const value = body === void 0 ? void 0 : new RegExp(`^\\s*${key}\\s*=\\s*(true|false)`, "m").exec(body)?.[1];
 	return value === void 0 ? void 0 : value === "true";
 }
+function tableString(config, table, key) {
+	const body = new RegExp(`^\\s*\\[${table.replaceAll(".", "\\.")}]\\s*$([\\s\\S]*?)(?=^\\s*\\[|(?![\\s\\S]))`, "m").exec(config)?.[1];
+	return body === void 0 ? void 0 : rootTomlString(body, key);
+}
+function tableStringArray(config, table, key) {
+	const body = new RegExp(`^\\s*\\[${table.replaceAll(".", "\\.")}]\\s*$([\\s\\S]*?)(?=^\\s*\\[|(?![\\s\\S]))`, "m").exec(config)?.[1];
+	return body === void 0 ? void 0 : rootTomlStringArray(body, key);
+}
 function tableInteger(config, table, key) {
 	const body = new RegExp(`^\\s*\\[${table.replaceAll(".", "\\.")}]\\s*$([\\s\\S]*?)(?=^\\s*\\[|(?![\\s\\S]))`, "m").exec(config)?.[1];
 	const value = body === void 0 ? void 0 : new RegExp(`^\\s*${key}\\s*=\\s*(\\d+)`, "m").exec(body)?.[1];
@@ -5300,12 +5336,17 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 	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(["default", "fast"].includes(rootTomlString(config, "service_tier") ?? "") ? check("service-tier", "ok", "service-tier-ready", "Codex service tier is explicitly managed.") : check("service-tier", "error", "service-tier-stale", "service_tier must be either default or fast.", "Reinstall HolyCodex with --fast or --no-fast."));
+	checks.push(rootTomlString(config, "model_verbosity") === "low" ? check("root-verbosity", "ok", "root-verbosity-ready", "Root model verbosity is forced to low.") : check("root-verbosity", "error", "root-verbosity-stale", "Root model verbosity must be low.", "Reinstall HolyCodex."));
 	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(tableStringArray(config, "desktop", "enabled-reasoning-efforts")?.join(",") === "low,medium,high" ? check("desktop-reasoning", "ok", "desktop-reasoning-ready", "Desktop exposes low, medium, and high reasoning efforts.") : check("desktop-reasoning", "error", "desktop-reasoning-stale", "Desktop reasoning choices must be low, medium, and high.", "Reinstall HolyCodex."));
+	checks.push(tableBoolean(config, "desktop", "show-context-window-usage") === true ? check("desktop-context-usage", "ok", "desktop-context-usage-ready", "Desktop context-window usage is visible.") : check("desktop-context-usage", "error", "desktop-context-usage-hidden", "Desktop context-window usage is not enabled.", "Reinstall HolyCodex."));
 	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."));
 	const codex = await runtime.command("codex", ["--version"]);
 	checks.push(codex.ok ? check("codex", "ok", "codex-version", codex.output || "Codex is available.") : check("codex", "warning", "codex-version-unavailable", "Codex version could not be read; status-line compatibility cannot be independently confirmed."));
+	if (runtime.platform === "win32") checks.push(tableString(config, "windows", "sandbox") === "unelevated" ? check("windows-sandbox", "ok", "windows-sandbox-ready", "Windows sandbox runs unelevated.") : check("windows-sandbox", "error", "windows-sandbox-stale", "Windows sandbox must run unelevated.", "Reinstall HolyCodex on Windows."));
 	const agentModelFailures = [];
 	for (const agent of AGENTS) try {
 		const text = await readFile(join(agentRoot, `${agent}.toml`), "utf8");
@@ -5410,7 +5451,7 @@ 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, options.maxSubagents);
+	const config = installConfig(existingConfig, options.autonomy, runtime.platform, plan, options.maxSubagents, options.fast ?? false);
 	await atomicWrite(target.config, config);
 	await rm(target.cache, {
 		recursive: true,
@@ -5485,6 +5526,7 @@ async function writeInstalledAgents(root, platform, plan) {
 		let source = await readText(path);
 		source = replaceTomlString(source, "model", route.model);
 		source = replaceTomlString(source, "model_reasoning_effort", route.reasoningEffort);
+		source = replaceTomlString(source, "model_verbosity", "low");
 		if (platform === "win32") {
 			await atomicWrite(path, source);
 			return;
@@ -5552,16 +5594,16 @@ function supportsColor(isTTY, noColor) {
 }
 /** Renders help. */
 function renderHelp(version, color) {
-	const title = paint(color, `${BOLD}${CYAN}`, `HOLYCODEX ${version}`);
+	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  --max-subagents <count>          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`;
+	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 <count>          Override concurrent direct subagents for install\n  --fast                          Use Codex fast service tier\n  --no-fast                       Use Codex default service tier\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 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  --max-subagents <count>          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`;
+	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 <count>          Override concurrent direct subagents\n  --fast                          Use Codex fast service tier\n  --no-fast                       Use Codex default service tier\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) {
@@ -5625,9 +5667,16 @@ async function main() {
 		process$1.exitCode = 1;
 		return;
 	}
+	const fastFlags = args.filter((arg) => ["--fast", "--no-fast"].includes(arg));
+	if (fastFlags.length > 1) {
+		process$1.stderr.write(renderError(`Conflicting fast flags: ${fastFlags.join(", ")}`, stderrColor));
+		process$1.exitCode = 1;
+		return;
+	}
 	const options = {
 		autonomy: args.includes("--dangerous-codex-autonomous") ? "dangerous" : args.includes("--codex-autonomous") ? "autonomous" : "default",
 		json: args.includes("--json"),
+		fast: args.includes("--fast"),
 		plan,
 		...maxSubagents === void 0 ? {} : { maxSubagents }
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "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.9.3",
+    "@holycodex/plugin": "0.9.5",
     "zod": "^4.4.3"
   },
   "engines": {