mu-agent 0.1.8 → 0.1.10

package/judge/themes/mu-dark.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
+	"name": "mu-dark",
+	"appearance": "dark",
+	"vars": {
+		"text": "#e6e6ec",
+		"muted": "#a1a1ad",
+		"dim": "#6e6e7a",
+		"violet": "#b2a4ff",
+		"pink": "#ff8ad8",
+		"blue": "#8fa2ff",
+		"green": "#4ade9b",
+		"red": "#ff6b81",
+		"amber": "#f5b544",
+		"rule": "#3a3a46"
+	},
+	"colors": {
+		"accent": "violet",
+		"border": "rule",
+		"borderAccent": "#8f7cf7",
+		"borderMuted": "#2a2a33",
+		"success": "green",
+		"error": "red",
+		"warning": "amber",
+		"muted": "muted",
+		"dim": "dim",
+		"text": "text",
+		"thinkingText": "#9a9aa6",
+		"selectedBg": "#2a2550",
+		"scrollbarTrack": "#26262e",
+		"scrollbarThumb": "dim",
+		"searchMatchBg": "#4a3a12",
+		"searchMatchText": "text",
+		"userMessageBg": "#17171d",
+		"userMessageText": "text",
+		"customMessageBg": "#1c1119",
+		"customMessageText": "muted",
+		"customMessageLabel": "pink",
+		"toolPendingBg": "#16161c",
+		"toolSuccessBg": "#10201a",
+		"toolErrorBg": "#2a1317",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "#d3caff",
+		"mdLink": "blue",
+		"mdLinkUrl": "dim",
+		"mdCode": "#c9beff",
+		"mdCodeBlock": "#d7d7df",
+		"mdCodeBlockBorder": "rule",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "rule",
+		"mdHr": "rule",
+		"mdListBullet": "violet",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "dim",
+		"syntaxComment": "#7a7a86",
+		"syntaxKeyword": "#b9abff",
+		"syntaxFunction": "#9fb0ff",
+		"syntaxVariable": "text",
+		"syntaxString": "#ff9fdf",
+		"syntaxNumber": "#ffbd7a",
+		"syntaxType": "#6fd6d0",
+		"syntaxOperator": "muted",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "#5c5c66",
+		"thinkingMinimal": "#6e6e8a",
+		"thinkingLow": "#8585b8",
+		"thinkingMedium": "#9d8cff",
+		"thinkingHigh": "#c58cff",
+		"thinkingXhigh": "pink",
+		"thinkingMax": "red",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#0b0b0e",
+		"cardBg": "#121217",
+		"infoBg": "#2a2410"
+	}
+}

package/judge/themes/mu-light.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
+	"name": "mu-light",
+	"appearance": "light",
+	"vars": {
+		"text": "#18181c",
+		"muted": "#55555f",
+		"dim": "#85858f",
+		"violet": "#5b45db",
+		"pink": "#b42d86",
+		"blue": "#3d55c9",
+		"green": "#0e7f55",
+		"red": "#cc2f55",
+		"amber": "#9a5a06",
+		"rule": "#d4d4da"
+	},
+	"colors": {
+		"accent": "violet",
+		"border": "rule",
+		"borderAccent": "#7f6af0",
+		"borderMuted": "#e6e6ea",
+		"success": "green",
+		"error": "red",
+		"warning": "amber",
+		"muted": "muted",
+		"dim": "dim",
+		"text": "text",
+		"thinkingText": "#6a6a74",
+		"selectedBg": "#e6e1ff",
+		"scrollbarTrack": "#ececf0",
+		"scrollbarThumb": "#a6a6b0",
+		"searchMatchBg": "#fff0c2",
+		"searchMatchText": "text",
+		"userMessageBg": "#f3f3f0",
+		"userMessageText": "text",
+		"customMessageBg": "#fff4fb",
+		"customMessageText": "muted",
+		"customMessageLabel": "pink",
+		"toolPendingBg": "#f6f6f4",
+		"toolSuccessBg": "#eef8f2",
+		"toolErrorBg": "#fdf0f2",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "#3a2a96",
+		"mdLink": "blue",
+		"mdLinkUrl": "dim",
+		"mdCode": "violet",
+		"mdCodeBlock": "#2a2a30",
+		"mdCodeBlockBorder": "rule",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "rule",
+		"mdHr": "rule",
+		"mdListBullet": "violet",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "dim",
+		"syntaxComment": "#6a6a73",
+		"syntaxKeyword": "violet",
+		"syntaxFunction": "#3f4dc0",
+		"syntaxVariable": "text",
+		"syntaxString": "pink",
+		"syntaxNumber": "#9a5208",
+		"syntaxType": "#0b767c",
+		"syntaxOperator": "muted",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "#a6a6b0",
+		"thinkingMinimal": "#8a8ab0",
+		"thinkingLow": "#6a6ad0",
+		"thinkingMedium": "violet",
+		"thinkingHigh": "#8a2fc0",
+		"thinkingXhigh": "pink",
+		"thinkingMax": "red",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#ffffff",
+		"cardBg": "#f7f7f5",
+		"infoBg": "#fff6dc"
+	}
+}

package/kyrn/bin/kyrn-doctor

@@ -87,13 +87,13 @@ if (layout === "package") {
 	row(
 		linked ? "ok" : "--",
 		"command",
-		linked ? linked.replaceAll(homedir(), "~") : `not on PATH yet: ${join(root, "kyrn", "bin", process.platform === "win32" ? "mu.cmd" : "mu")} link`,
+		linked ? linked.replaceAll(homedir(), "~") : `not on your PATH yet: run ${join(root, "kyrn", "bin", process.platform === "win32" ? "mu.cmd" : "mu")} link`,
 	);
 }
 
 row("--", "home", tilde(agentDir));
 if (home === ".kyrn" && agentDir.startsWith(join(homedir(), ".kyrn"))) {
-	row("--", "", "this home is from before the rename: `mu migrate` moves it to ~/.mu (`--dry-run` to look first)");
+	row("--", "", "this home folder predates the rename: `mu migrate` moves it to ~/.mu (add `--dry-run` to preview)");
 }
 // Only the size is looked at: pi writes an empty `{}` at its first start, and any stored login is far longer.
 let authBytes = 0;
@@ -112,23 +112,23 @@ row(
 	"model",
 	settings.defaultModel
 		? `${settings.defaultProvider ?? "?"}/${settings.defaultModel}${settings.defaultThinkingLevel ? ` · thinking ${settings.defaultThinkingLevel}` : ""}`
-		: "no default: the first provider with credentials is used. Pick one with /model, save with ctrl+s",
+		: "no default: mu uses the first provider with credentials. Pick one with /model and save it with ctrl+s",
 );
 
 const config = readJson(join(agentDir, "mu.json")) ?? readJson(join(agentDir, "kyrn.json"));
 const tiers = (env("JUDGE") ? env("JUDGE").split(",") : (config?.tiers ?? ["jev"])).map((tier) => tier.trim());
 const mode = env("JUDGE_MODE") ?? config?.modes?.default ?? "active";
-row("--", "judges", `${tiers.join(" > ")} · decisions ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}`);
+row("--", "judges", `${tiers.join(" > ")} · default mode ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}`);
 const overrides = Object.entries(config?.modes ?? {}).filter(([id]) => id !== "default");
 if (overrides.length > 0) row("--", "modes", overrides.map(([id, value]) => `${id}=${value}`).join(" "));
 const ladder = config?.features?.swarm?.models ?? [];
-row("--", "sub-agents", ladder.length > 0 ? `model ladder ${ladder.join(" < ")}` : "use the session's model (no ladder configured)");
+row("--", "subagents", ladder.length > 0 ? `model ladder ${ladder.join(" < ")}` : "use the session's model (no ladder configured)");
 
 const judgeSupport = localJudgeSupport({ platform: process.platform, env: process.env, wsl });
 if (tiers.some((tier) => tier.startsWith("laya")) && !judgeSupport.runs && !judgeSupport.url) {
 	// Not a failure of this installation: the sidecar is Core ML, and there is none for this platform.
-	row("--", "local judge", `not available on ${platformName({ platform: process.platform, wsl })}: the Laya sidecar is Core ML (macOS, Apple Silicon).`);
-	row("--", "", "laya's decisions fall back to the next judge or to pi's behaviour. Use jev, an llm judge, or MU_LOCAL_JUDGE_URL=<a server with the same contract>");
+	row("--", "local judge", `not available on ${platformName({ platform: process.platform, wsl })}: the Laya sidecar needs Core ML (macOS on Apple silicon)`);
+	row("--", "", "Laya's decision points use the next judge or their fallbacks. Use Jev, an LLM judge or MU_LOCAL_JUDGE_URL=<a server with the same API>");
 } else if (tiers.some((tier) => tier.startsWith("laya"))) {
 	const base = env("LOCAL_JUDGE_URL") ?? `http://127.0.0.1:${env("LOCAL_JUDGE_PORT") ?? 47823}`;
 	const startedAt = performance.now();
@@ -142,8 +142,8 @@ if (tiers.some((tier) => tier.startsWith("laya")) && !judgeSupport.runs && !judg
 			"fix",
 			"local judge",
 			judgeSupport.runs
-				? `${base} does not answer: mu judge start   (first time: mu judge setup)`
-				: `${base} (MU_LOCAL_JUDGE_URL) does not answer`,
+				? `${base} isn't answering: run mu judge start   (first time: mu judge setup)`
+				: `${base} (MU_LOCAL_JUDGE_URL) isn't answering`,
 		);
 	}
 }
@@ -192,7 +192,7 @@ if (jevTier) {
 			"jev key",
 			route
 				? `${route[0]} is set: ${route[1]} (value not shown)`
-				: `none set: Jev 1.13 on OpenCode Zen answers, free for a limited time (what it judges goes to OpenCode). For your own key, add TYPESAFE_API_KEY (or MU_JUDGE_OPENROUTER_API_KEY, AI_GATEWAY_API_KEY, OPENCODE_API_KEY) ${where}`,
+				: `none set: using Jev 1.13 on OpenCode Zen, free for a limited time (what the judge reads goes to OpenCode). To use your own key, add TYPESAFE_API_KEY (or MU_JUDGE_OPENROUTER_API_KEY, AI_GATEWAY_API_KEY, OPENCODE_API_KEY) ${where}`,
 		);
 	} else {
 		const name = judge.apiKeyEnv ?? (judge.type === "gateway" ? "AI_GATEWAY_API_KEY" : "TYPESAFE_API_KEY");
@@ -207,7 +207,7 @@ if (jevTier) {
 			has(name) && !unsent ? "ok" : "fix",
 			"jev key",
 			unsent
-				? `${jevTier} has no baseUrl: its key ${name} is only sent to the address it was set up for`
+				? `${jevTier} has no baseUrl, so its key ${name} isn't sent anywhere: add the address the key is for`
 				: has(name)
 					? `${name} is set: Jev is called ${via} (value not shown)`
 					: `missing: add ${name} ${where} (Jev is called ${via})`,
@@ -229,9 +229,9 @@ for (const model of new Set(askedTiers.map(classifierOf).filter((judge) => judge
 	// OpenCode's free models answer without a key (the client sends "public", as OpenCode's own does).
 	const names = provider === "opencode" && String(model).endsWith("-free") ? [] : CLASSIFIER_KEYS[provider];
 	if (!model?.includes("/")) {
-		row("fix", "classifier", `${model ?? "a classifier judge"} needs a model written "provider/model-id"`);
+		row("fix", "classifier", `${model ?? "a classifier judge"} needs a model in the form provider/model-id`);
 	} else if (!names) {
-		row("--", "classifier", `${model}: a provider of your own; its key is the one models.json names`);
+		row("--", "classifier", `${model}: a provider of your own: mu uses the key models.json names for it`);
 	} else if (names.every(has)) {
 		row("ok", "classifier", `${model}: ${names.length > 0 ? `${names.join(", ")} set (value not shown)` : "no key needed"}`);
 	} else {
@@ -268,15 +268,15 @@ for (const endpoint of new Set(clmJudges.map((judge) => clmEndpoint(judge.baseUr
 	} catch {}
 	const ms = Math.round(performance.now() - startedAt);
 	if (health?.ok !== true) {
-		row("fix", "clm", `${base} does not answer: start clm-serve there, or point the judge's baseUrl in mu.json at one`);
+		row("fix", "clm", `${base} isn't answering: start clm-serve there, or point the judge's baseUrl in mu.json at a running one`);
 		continue;
 	}
 	const served = Array.isArray(health.models) ? health.models : [];
 	const missing = [...new Set(judges.map((judge) => judge.model || "clm-latest"))].filter((model) => !served.includes(model));
 	if (health.embedder === false) {
-		row("fix", "clm", `${host} answers, but its encoder does not: every question fails until the embedding server is up`);
+		row("fix", "clm", `${host} answers, but its encoder doesn't: every question fails until the embedding server is up`);
 	} else if (missing.length > 0) {
-		row("fix", "clm", `${host} does not serve ${missing.join(", ")} (it serves ${served.join(", ")})`);
+		row("fix", "clm", `${host} doesn't serve ${missing.join(", ")} (it serves ${served.join(", ")})`);
 	} else {
 		row("ok", "clm", `${host} · ${served.join(", ")} · ${ms} ms`);
 	}
@@ -330,7 +330,7 @@ row(
 	"browse",
 	[browseTiers].flat().some(canRelate)
 		? `driven by ${[browseTiers].flat().join(" > ")}`
-		: 'needs a judge that can relate a goal to a page. In mu.json: "routes": { "browser.step": ["luna"] }',
+		: 'needs a judge that can match a goal to a page. In mu.json: "routes": { "browser.step": ["llm:openai-codex/gpt-5.6-luna"] }',
 );
 
 const marks = { ok: "\x1b[32m ok\x1b[0m", fix: "\x1b[33mfix\x1b[0m", "--": "\x1b[2m  ·\x1b[0m" };

package/kyrn/bin/kyrn-judge-local

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Manage the mu local judge sidecar (Laya on Core ML, Apple Silicon only).
+# Manage the mu local judge sidecar (Laya on Core ML, Apple silicon only).
 #
 #   kyrn/bin/kyrn-judge-local setup    create the venv, install pinned deps, download the weights (~680 MB)
 #   kyrn/bin/kyrn-judge-local start    start in the background if it is not already running
@@ -41,7 +41,7 @@ require_setup() {
 
 cmd_setup() {
   if [[ "$(uname -s)-$(uname -m)" != "Darwin-arm64" ]]; then
-    echo "laya-coreml needs Apple Silicon and macOS 15+." >&2
+    echo "laya-coreml needs Apple silicon and macOS 15+." >&2
     exit 1
   fi
   command -v uv >/dev/null || { echo "uv is required: https://docs.astral.sh/uv/" >&2; exit 1; }

package/kyrn/bin/kyrn-ledger

@@ -87,4 +87,4 @@ for (const file of files) {
 	}
 }
 
-if (!asJson) console.log(count === 0 ? `No decisions found under ${sessionsDir}` : `\n${count} decisions from ${files.length} sessions`);
+if (!asJson) console.log(count === 0 ? `No verdicts found under ${sessionsDir}` : `\n${count} ${count === 1 ? "verdict" : "verdicts"} from ${files.length} ${files.length === 1 ? "session" : "sessions"}`);

package/kyrn/bin/mu.mjs

@@ -94,26 +94,28 @@ export function platformName({ platform, wsl }) {
 export function usage(platform) {
 	const linkDir = platform === "win32" ? "%USERPROFILE%\\.local\\bin" : "~/.local/bin";
 	return [
-		"mu command line. (The project was called KYRN until 2026-09-21; the old spellings below still work.)",
+		"mu: a coding agent with a judgment kernel, built on pi.",
 		"",
-		"  mu                       interactive session in the current directory",
-		'  mu "prompt"              interactive, starting with this prompt',
-		'  mu -p "prompt"           one-shot: print the answer and exit',
-		"  mu -c | -r               continue the last session | pick one to resume",
-		"  mu setup                 connect a model (an API key, or a service from a list) and choose the judge",
-		"                           (mu setup --help: scripts, a key from stdin, the services it knows)",
-		"  mu judge <cmd>           the local judge (Laya): setup | start | stop | status | run",
-		"  mu ledger [n] [--json]   what the judge decided in the last n sessions",
-		"  mu import --list | <file>...   bring Claude Code and Codex conversations into mu (mu import --help)",
-		"  mu doctor                check the installation",
-		"  mu auth <cmd>            subscription sign-in for the desktop app, as JSON lines:",
+		"  mu                       start a session in the current directory",
+		'  mu "prompt"              start a session with this prompt',
+		'  mu -p "prompt"           run one prompt, print the answer and exit',
+		"  mu -c | -r               continue the last session | pick a session to resume",
+		"  mu setup                 connect a model (paste an API key or pick a service) and choose a judge",
+		"                           (see mu setup --help for scripting, reading a key from stdin and the supported services)",
+		"  mu judge <cmd>           manage the local judge, Laya (macOS on Apple silicon): setup | start | stop | status | run",
+		"  mu ledger [n] [--json]   print the judge's verdicts from the last n sessions",
+		"  mu import --list | <file>...   import Claude Code and Codex conversations (mu import --help)",
+		"  mu doctor                check the installation, the judges and the connections",
+		"  mu auth <cmd>            sign-in helper for the desktop app (JSON lines):",
 		"                           status | login <provider> | logout <provider>",
-		`  mu link | unlink         put the \`mu\` command on your PATH (${linkDir}) | remove it`,
-		"  mu migrate [--dry-run]   once: move the home from before the rename, ~/.kyrn, to ~/.mu",
-		"  mu help | version",
+		`  mu link | unlink         put the mu command on your PATH (${linkDir}) | remove it`,
+		"  mu migrate [--dry-run]   move the old home folder, ~/.kyrn, to ~/.mu (once)",
+		"  mu help | version        show this help | print the version",
 		"",
-		"Everything else goes to the agent unchanged: `mu --help` lists every flag,",
-		"and `mu install|remove|update|list|config` manage pi packages.",
+		"Everything else goes to pi unchanged: mu --help also shows pi's options,",
+		"and mu install|remove|update|list|config manage pi packages.",
+		"",
+		"Formerly KYRN: the kyrn commands still work.",
 	].join("\n");
 }
 
@@ -310,7 +312,7 @@ export function ensureAppView({ platform, app, upstream, fs = realFs }) {
 /**
  * Where this mu comes from: "repo", a checkout that runs the TypeScript sources (sourceRuntime), or "package", the
  * npm package mu-agent, which carries pi's bundle (dist/bundle/cli.js) and the judgment layer built to
- * JavaScript (judge/dist/kyrn-judge.js). A checkout without its dependencies is still a checkout.
+ * JavaScript (judge/mu/index.js). A checkout without its dependencies is still a checkout.
  */
 export function layoutOf({ root, platform, exists }) {
 	const path = pathFor(platform);
@@ -326,7 +328,7 @@ export function packageEntries({ root, platform }) {
 	const path = pathFor(platform);
 	return {
 		cli: path.join(root, "dist", "bundle", "cli.js"),
-		extension: path.join(root, "judge", "dist", "kyrn-judge.js"),
+		extension: path.join(root, "judge", "mu", "index.js"),
 		auth: path.join(root, "judge", "dist", "auth.js"),
 		import: path.join(root, "judge", "dist", "import.js"),
 		setup: path.join(root, "judge", "dist", "setup.js"),
@@ -356,13 +358,13 @@ export function installHint({ root, platform }) {
 	const steps = [`cd ${root}`, "npm ci --ignore-scripts", "npm run hydrate:model-data"];
 	// Windows PowerShell 5 has no `&&`.
 	return platform === "win32"
-		? `mu's dependencies are not installed. Run:\n${steps.map((step) => `  ${step}`).join("\n")}`
-		: `mu's dependencies are not installed. Run:  ${steps.join(" && ")}`;
+		? `mu's dependencies aren't installed. Run:\n${steps.map((step) => `  ${step}`).join("\n")}`
+		: `mu's dependencies aren't installed. Run:  ${steps.join(" && ")}`;
 }
 
 /** What mu says on a Node that does not strip TypeScript types, which a checkout cannot run on. */
 const NO_TYPE_STRIPPING =
-	"mu runs a checkout's TypeScript with Node's own type stripping (on by default from Node 22.18), and this Node does not strip types";
+	"mu runs a source checkout's TypeScript with Node's built-in type stripping (on by default since Node 22.18), but this Node doesn't strip types. Use Node 22.19 or newer.";
 
 /**
  * Node's arguments for running a checkout's TypeScript, up to the entry file. Node strips the types itself (on by
@@ -428,10 +430,10 @@ export function localJudgeSupport({ platform, env, wsl = false }) {
 		runs: false,
 		url,
 		message: [
-			`The local judge (Laya) is a Core ML sidecar: it runs on macOS with Apple Silicon only, not on ${where}.`,
-			"mu works without it: use Jev (TYPESAFE_API_KEY or AI_GATEWAY_API_KEY) or an llm judge in mu.json;",
-			"the desktop app's own local judge is being built. Decisions without a judge fall back to pi's behaviour.",
-			"A server that speaks the same contract (GET /health, POST /evaluate) can be used from here:",
+			`The local judge (Laya) is a Core ML sidecar that runs only on macOS on Apple silicon, not on ${where}.`,
+			"mu works without it: Jev answers by default (free on OpenCode Zen, or with your own key: mu setup), or set an LLM judge in mu.json.",
+			"A local judge for the desktop app is in progress. Without a judge, decision points use their fallbacks.",
+			"To use a server that implements the same API (GET /health, POST /evaluate), set:",
 			"  MU_LOCAL_JUDGE_URL=http://host:port",
 		].join("\n"),
 	};
@@ -447,12 +449,37 @@ export function launchStrategy({ platform, env, canExec }) {
 /** How the judgment layer's extension joins pi's arguments: in front for a session, never in front of pi's own
  *  commands (PI_COMMANDS), which pi reads as its first argument — an -e before them would turn them into a prompt.
  *  The judgment layer never runs for them, so its extension stays out of their way. */
-function judgeArgs({ argv, layout, root, platform }) {
+function judgeArgs({ argv, layout, root, platform, agentDir, readFile }) {
 	if (PI_COMMANDS.has(argv[0])) return [];
 	const path = pathFor(platform);
-	return layout === "package"
-		? ["-e", packageEntries({ root, platform }).extension]
-		: ["-e", path.join(root, "packages", "kyrn-judge", "src", "extension", "kyrn-judge.ts")];
+	const extension =
+		layout === "package"
+			? ["-e", packageEntries({ root, platform }).extension]
+			: ["-e", path.join(root, "packages", "kyrn-judge", "src", "extension", "kyrn-judge.ts")];
+	return [...extension, ...themeArgs({ argv, layout, root, platform, agentDir, readFile })];
+}
+
+/** mu's own terminal themes, beside the judgment layer's files. */
+export function themesDir({ layout, root, platform }) {
+	const path = pathFor(platform);
+	return layout === "package" ? path.join(root, "judge", "themes") : path.join(root, "packages", "kyrn-judge", "themes");
+}
+
+/**
+ * An interactive session gets mu's themes (mu-light and mu-dark, which /settings then lists beside pi's) and, while the
+ * person has chosen no theme of their own, starts in them: light or dark as the terminal is. A theme chosen in
+ * /settings is saved in settings.json and wins; so does --use-theme. Print and RPC modes draw nothing and get neither.
+ */
+function themeArgs({ argv, layout, root, platform, agentDir, readFile }) {
+	if (argv.includes("--mode") || argv.includes("-p") || argv.includes("--print")) return [];
+	const args = ["--theme", themesDir({ layout, root, platform })];
+	if (argv.includes("--use-theme") || !agentDir || !readFile) return args;
+	let chosen = false;
+	try {
+		const settings = JSON.parse(readFile(pathFor(platform).join(agentDir, "settings.json")));
+		chosen = typeof settings?.theme === "string" && settings.theme !== "";
+	} catch {}
+	return chosen ? args : [...args, "--use-theme", "mu-light/mu-dark"];
 }
 
 /**
@@ -485,7 +512,7 @@ export function planLaunch({
 	} else {
 		const runtime = sourceRuntime({ root, platform, stripsTypes, exists: fs.exists });
 		if (runtime.error) return { error: runtime.error };
-		entry = [...runtime.args, path.join(root, "packages", "coding-agent", "src", "experimental", "cli.ts")];
+		entry = [...runtime.args, path.join(root, "packages", "coding-agent", "src", "cli.ts")];
 	}
 
 	const muDir = muHome({ home, platform, isDir: fs.isDir });
@@ -503,7 +530,7 @@ export function planLaunch({
 		const parsed = parseEnvFile(envText);
 		fromFile = envFileAdditions({ env, entries: parsed.entries, platform });
 		// Line numbers only: the text of a line that did not parse may well be a secret.
-		if (parsed.problems.length > 0) notes.push(`mu: .env: skipped line ${parsed.problems.join(", ")} (not KEY=VALUE)`);
+		if (parsed.problems.length > 0) notes.push(`mu: .env: skipped ${parsed.problems.length === 1 ? "line" : "lines"} ${parsed.problems.join(", ")} (expected KEY=VALUE)`);
 	}
 
 	const childEnv = {};
@@ -526,14 +553,14 @@ export function planLaunch({
 		if (support.runs) startJudge = true;
 		else if (!support.url) {
 			notes.push(
-				`mu: the configuration asks for the local judge (laya), which runs on macOS only; on ${platformName({ platform, wsl })} its decisions fall back to the next judge or to pi's behaviour (mu judge status)`,
+				`mu: the configuration asks for the local judge (Laya), which runs on macOS only; on ${platformName({ platform, wsl })} its decision points use the next judge or their fallbacks (mu judge status)`,
 			);
 		}
 	}
 
 	return {
 		command: execPath,
-		args: [...entry, ...judgeArgs({ argv, layout, root, platform }), ...argv],
+		args: [...entry, ...judgeArgs({ argv, layout, root, platform, agentDir, readFile: fs.readFile }), ...argv],
 		env: childEnv,
 		strategy: launchStrategy({ platform, env, canExec }),
 		layout,
@@ -542,7 +569,7 @@ export function planLaunch({
 		agentDir,
 		startJudge,
 		notes,
-		preface: argv[0] === "-h" || argv[0] === "--help" ? `${usage(platform)}\n\nAgent flags:\n` : undefined,
+		preface: argv[0] === "-h" || argv[0] === "--help" ? `${usage(platform)}\n\npi's help (mu passes all of this through):\n` : undefined,
 	};
 }
 
@@ -572,7 +599,7 @@ export function planHost({ platform, env, argv, root, home, fs, wsl = false, str
 			...common,
 			module: path.join(root, "dist", "bundle", "index.js"),
 			execArgv: [],
-			args: [...judgeArgs({ argv, layout: launch.layout, root, platform }), ...argv],
+			args: [...judgeArgs({ argv, layout: launch.layout, root, platform, agentDir: launch.agentDir, readFile: fs.readFile }), ...argv],
 		};
 	}
 	const runtime = sourceRuntime({ root, platform, stripsTypes, exists: fs.exists });
@@ -581,13 +608,13 @@ export function planHost({ platform, env, argv, root, home, fs, wsl = false, str
 		...common,
 		module: path.join(root, "packages", "coding-agent", "src", "index.ts"),
 		execArgv: runtime.args,
-		args: [...judgeArgs({ argv, layout: launch.layout, root, platform }), ...argv],
+		args: [...judgeArgs({ argv, layout: launch.layout, root, platform, agentDir: launch.agentDir, readFile: fs.readFile }), ...argv],
 	};
 }
 
 /** What mu says when the local judge does not come up. */
 const LOCAL_JUDGE_NOT_STARTED =
-	"mu: the local judge did not start (mu judge status); decisions fall back to pi's behaviour";
+	"mu: the local judge (Laya) didn't start; decision points use the next judge or their fallbacks. Run mu judge status for details.";
 
 /** The part of the preparation that is files: the app view of a checkout, mu's agent folder, the configuration's notes. */
 function prepareFiles({ plan, platform, root, err }) {
@@ -1003,7 +1030,7 @@ export function planLink({ platform, env, home, bin, argv, fs }) {
 		return {
 			action: "refuse",
 			errors: [
-				`${link} already exists and is not this mu; it was left alone. Choose another folder: MU_LINK_DIR=<dir> mu link`,
+				`${link} already exists and is not this mu, so it was left alone. To use another folder: MU_LINK_DIR=<dir> mu link`,
 			],
 		};
 	}
@@ -1031,7 +1058,7 @@ export function planLink({ platform, env, home, bin, argv, fs }) {
 	if (windows && /[^\x00-\x7f]/.test(content)) {
 		notes.push(
 			"Note: the path from that folder to this repository has non-ASCII characters in it, and cmd reads a batch file in the",
-			"console's code page. If `mu` then cannot find its target, choose a folder on the same drive (MU_LINK_DIR), or put",
+			"console's code page. If mu then can't find its target, choose a folder on the same drive (MU_LINK_DIR), or put",
 			`${bin} on your PATH instead.`,
 		);
 	}
@@ -1200,8 +1227,8 @@ export function migrate({ platform, home, argv, fs, run, alive, self, out, err }
 		return 0;
 	}
 	if (fs.exists(next) || fs.isLink(next)) {
-		err(`${next} already exists, so nothing was moved. Two homes are never merged or overwritten here:`);
-		err("look at both folders and decide which one is the real one.");
+		err(`${next} already exists, so nothing was moved. mu never merges or overwrites two home folders:`);
+		err("look at both and decide which one to keep.");
 		return 1;
 	}
 	// Whatever is running would write into the gap between the rename and the link, and split the home in two.
@@ -1210,10 +1237,10 @@ export function migrate({ platform, home, argv, fs, run, alive, self, out, err }
 	try {
 		pid = Number.parseInt(fs.readFile(path.join(old, "local-judge", "judge.pid")).trim(), 10);
 	} catch {}
-	if (pid > 0 && alive(pid)) busy.push(`  the local judge (pid ${pid}). Stop it: mu judge stop`);
+	if (pid > 0 && alive(pid)) busy.push(`  the local judge (pid ${pid}). Stop it with mu judge stop`);
 	const found = findBusy({ platform, old, run, self });
 	if (!found) {
-		err("Nothing was moved: the list of running processes could not be read (tasklist, powershell), so it is not known whether mu is still running.");
+		err("Nothing was moved: mu couldn't read the list of running processes (tasklist, powershell), so it can't tell whether mu is still running.");
 		return 1;
 	}
 	const list = (pids) => pids.join(" ");
@@ -1247,7 +1274,7 @@ export function migrate({ platform, home, argv, fs, run, alive, self, out, err }
 		out(`renamed  ${path.join(next, config)} -> mu.json`);
 	}
 	out(`linked   ${old} -> ${next} (paths stored from before the rename keep working)`);
-	out("Check it: mu doctor");
+	out("To check it, run mu doctor");
 	return 0;
 }
 
@@ -1329,7 +1356,7 @@ function handOver({ command, args, env, strategy }) {
 		for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) process.on(signal, () => relay(signal));
 		if (process.platform === "win32") process.on("SIGBREAK", () => {});
 		child.on("error", (error) => {
-			err(`mu: could not start ${command}: ${error.message}`);
+			err(`mu: couldn't start ${command}: ${error.message}`);
 			resolve(1);
 		});
 		child.on("exit", (code, signal) => resolve(code ?? 128 + (osConstants.signals[signal] ?? 0)));
@@ -1426,7 +1453,7 @@ export async function main(argv = process.argv.slice(2)) {
 			out(await response.text());
 			return 0;
 		} catch {
-			out(`the judge server does not answer at ${plan.url}`);
+			out(`The local judge server isn't answering at ${plan.url}. Check that it's running.`);
 			return 1;
 		}
 	}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "mu-agent",
-	"version": "0.1.8",
-	"description": "mu: a coding agent that thinks before it acts. A small, fast judge makes the routine calls; the big model keeps its attention for the work. Built on pi.",
+	"version": "0.1.10",
+	"description": "mu: a coding agent that hands its routine decisions to a small, fast judge model, so the main model can keep its attention on the work. Built on pi.",
 	"type": "module",
 	"bin": {
 		"mu": "kyrn/bin/mu.mjs"
@@ -33,13 +33,12 @@
 		"node": ">=22.19.0"
 	},
 	"dependencies": {
-		"@earendil-works/chord": "1.0.2",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"jiti": "2.7.0"
 	},
 	"muBuild": {
-		"pi": "1.0.2",
+		"pi": "1.3.0",
 		"judge": "0.1.0",
-		"commit": "a63b81be9"
+		"commit": "84e66744e"
 	}
 }