wizards 0.5.0 → 0.5.1

package/apps/runtime/dist/cli/connect.js

@@ -5,7 +5,7 @@ import { delimiter, dirname, join } from "node:path";
 import { promisify } from "node:util";
 import { installedByScript, packageRoot } from "./home.js";
 import { findOnPath } from "./machine.js";
-import { bad, dim, ok, tilde } from "./ui.js";
+import { bad, cmd, dim, ok, tilde } from "./ui.js";
 const run = promisify(execFile);
 /**
  * The wizards in the person's own AI apps: `wizards connect` writes this install's MCP
@@ -214,7 +214,7 @@ function jsonApp(def) {
     const running = () => def.ownsFileWhileRunning?.()
         ? {
             ok: false,
-            message: `${def.name} is running and would overwrite its config. Quit it (Cmd+Q), then run this again.`,
+            message: `${def.name} is running and would overwrite its settings. Quit it completely, then try again.`,
         }
         : null;
     const snippet = (server) => JSON.stringify(def.at.reduceRight((inner, key) => ({ [key]: inner }), {
@@ -236,17 +236,17 @@ function jsonApp(def) {
             if (next === null) {
                 return {
                     ok: false,
-                    message: `${def.file} is not plain JSON (comments?); add this to it:`,
+                    message: `${tilde(def.file)} isn’t plain JSON (comments?). Add this to it yourself:`,
                     snippet: snippet(server),
                 };
             }
             save(def.file, next);
-            return { ok: true, message: `added to ${def.file}` };
+            return { ok: true, message: `added to ${tilde(def.file)}` };
         },
         async disconnect() {
             const text = read(def.file);
             if (!text || !jsonHasServer(text, def.at)) {
-                return { ok: true, message: "was not connected" };
+                return { ok: true, message: "wasn’t connected" };
             }
             const busy = running();
             if (busy) {
@@ -256,11 +256,11 @@ function jsonApp(def) {
             if (next === null) {
                 return {
                     ok: false,
-                    message: `${def.file} is not plain JSON; remove "${SERVER_NAME}" there.`,
+                    message: `${tilde(def.file)} isn’t plain JSON. Remove “${SERVER_NAME}” from it yourself.`,
                 };
             }
             save(def.file, next);
-            return { ok: true, message: `removed from ${def.file}` };
+            return { ok: true, message: `removed from ${tilde(def.file)}` };
         },
     };
 }
@@ -285,7 +285,7 @@ function claudeCode(paths) {
         async connect(server) {
             const claude = appCommand(paths, "claude");
             if (!claude) {
-                return { ok: false, message: "the claude command was not found" };
+                return { ok: false, message: "The claude command wasn’t found." };
             }
             // Claude Code keeps rewriting its own file: its command changes it, not we.
             await run(claude, ["mcp", "remove", "--scope", "user", SERVER_NAME]).catch(() => undefined);
@@ -301,7 +301,7 @@ function claudeCode(paths) {
                     server.command,
                     ...server.args,
                 ]);
-                return { ok: true, message: "added with `claude mcp add --scope user`" };
+                return { ok: true, message: "added with claude mcp add --scope user" };
             }
             catch (error) {
                 return { ok: false, message: error.message.split("\n")[0] };
@@ -310,10 +310,10 @@ function claudeCode(paths) {
         async disconnect() {
             const claude = appCommand(paths, "claude");
             if (!claude) {
-                return { ok: true, message: "was not connected" };
+                return { ok: true, message: "wasn’t connected" };
             }
             await run(claude, ["mcp", "remove", "--scope", "user", SERVER_NAME]).catch(() => undefined);
-            return { ok: true, message: "removed with `claude mcp remove`" };
+            return { ok: true, message: "removed with claude mcp remove" };
         },
     };
 }
@@ -329,15 +329,15 @@ function codex() {
         connected: async () => tomlHasServer(read(file) ?? ""),
         async connect(server) {
             save(file, withTomlServer(read(file), server));
-            return { ok: true, message: `added to ${file}` };
+            return { ok: true, message: `added to ${tilde(file)}` };
         },
         async disconnect() {
             const text = read(file);
             if (!text || !tomlHasServer(text)) {
-                return { ok: true, message: "was not connected" };
+                return { ok: true, message: "wasn’t connected" };
             }
             save(file, withoutTomlServer(text));
-            return { ok: true, message: `removed from ${file}` };
+            return { ok: true, message: `removed from ${tilde(file)}` };
         },
     };
 }
@@ -355,15 +355,15 @@ function goose() {
         connected: async () => yamlHasExtension(read(file) ?? ""),
         async connect(server) {
             save(file, withYamlExtension(read(file), server));
-            return { ok: true, message: `added to ${file}` };
+            return { ok: true, message: `added to ${tilde(file)}` };
         },
         async disconnect() {
             const text = read(file);
             if (!text || !yamlHasExtension(text)) {
-                return { ok: true, message: "was not connected" };
+                return { ok: true, message: "wasn’t connected" };
             }
             save(file, withoutYamlExtension(text));
-            return { ok: true, message: `removed from ${file}` };
+            return { ok: true, message: `removed from ${tilde(file)}` };
         },
     };
 }
@@ -397,7 +397,7 @@ function openClaw(paths) {
                     "--args",
                     ...server.args,
                 ]);
-                return { ok: true, message: "added with `openclaw mcp set`" };
+                return { ok: true, message: "added with openclaw mcp set" };
             }
             catch (error) {
                 return { ok: false, message: error.message.split("\n")[0] };
@@ -409,7 +409,7 @@ function openClaw(paths) {
                 return json.disconnect();
             }
             await run(openclaw, ["mcp", "unset", SERVER_NAME]).catch(() => undefined);
-            return { ok: true, message: "removed with `openclaw mcp unset`" };
+            return { ok: true, message: "removed with openclaw mcp unset" };
         },
     };
 }
@@ -492,18 +492,18 @@ export async function appStates(paths) {
 export async function connectCommand(paths, ids, remove) {
     const unknown = ids.filter((id) => !apps(paths).some((app) => app.id === id));
     if (unknown.length) {
-        console.error(`Unknown app ${unknown.join(", ")}. One of: ${apps(paths)
+        console.error(`Unknown app ${unknown.map((id) => `“${id}”`).join(", ")}. Choose from: ${apps(paths)
             .map((app) => app.id)
-            .join(", ")}`);
+            .join(", ")}.`);
         return 2;
     }
     const results = await connectApps(paths, ids, remove);
     if (!results.length) {
-        console.log("No AI app found on this machine. Name one: connect cursor");
+        console.log(`No AI app found on this computer. Name one: ${cmd("connect cursor")}`);
         return 0;
     }
     for (const { app, outcome } of results) {
-        console.log(`${outcome.ok ? ok : bad} ${app.name.padEnd(22)} ${dim(tilde(outcome.message))}`);
+        console.log(`${outcome.ok ? ok : bad} ${app.name.padEnd(22)} ${dim(outcome.message)}`);
         if (!outcome.ok && outcome.snippet) {
             console.log(outcome.snippet);
         }
@@ -511,7 +511,7 @@ export async function connectCommand(paths, ids, remove) {
     if (!remove && results.some((r) => r.outcome.ok)) {
         console.log("");
         console.log(dim("Restart the app (or reload its MCP servers) to see the wizards in it."));
-        console.log(dim("Claude Desktop, Cursor, VS Code and Goose show a run as a widget; the others as text."));
+        console.log(dim("Claude Desktop, Cursor, VS Code and Goose show a run as a widget, the others as text."));
     }
     return results.every((r) => r.outcome.ok) ? 0 : 1;
 }

package/apps/runtime/dist/cli/features.js

@@ -3,7 +3,7 @@ import { declaredFeatures, featuresFile, fileFeatures, writeFeature } from "../f
 import { discoverPlugins } from "../plugins/discovery.js";
 import { pluginDirs } from "../plugins/loader.js";
 import { proModulesDir } from "../plugins/pro-state.js";
-import { command } from "./home.js";
+import { cmd, tilde } from "./ui.js";
 /**
  * `wizards features` — the feature switches of this install, from its `.features` file. Not in
  * the help: for whoever works on a part before it is on for everyone.
@@ -31,20 +31,20 @@ export function featuresCommand(args) {
             const kind = d ? d.kind : "?";
             console.log(`${all[n] ? "on " : "off"}  ${n.padEnd(28)} ${kind.padEnd(8)} ${source.padEnd(9)} ${d?.label ?? ""}`);
         }
-        console.log(`\nfile: ${file}\nAn account's or a team's switches come on top of these while the runtime runs.`);
+        console.log(`\nFile: ${tilde(file)}\nWhile engenty wizards runs, account and team switches apply on top of these.`);
         return 0;
     }
     if (!FEATURE_NAME.test(name)) {
-        console.error(`"${name}" is no switch name (teamPlans, contacts.leadScoring).`);
+        console.error(`“${name}” isn’t a valid switch name (e.g. teamPlans, contacts.leadScoring).`);
         return 2;
     }
     if (value === "on" || value === "off" || value === "default") {
         writeFeature(name, value === "default" ? null : value === "on", file);
         console.log(value === "default"
-            ? `${name} follows the default again (${file}). A running runtime reads it at once.`
-            : `${name} is ${value} on this machine (${file}). A running runtime reads it at once.`);
+            ? `${name} follows the default again (${tilde(file)}). engenty wizards picks this up straight away.`
+            : `${name} is ${value} on this computer (${tilde(file)}). engenty wizards picks this up straight away.`);
         return 0;
     }
-    console.error(`${command()} features ${name} on|off|default`);
+    console.error(`Usage: ${cmd(`features ${name} on|off|default`)}`);
     return 2;
 }

package/apps/runtime/dist/cli/main.js

@@ -11,45 +11,57 @@ import { logsCommand, reportCommand } from "./report.js";
 import { setup } from "./setup.js";
 import { open, start, studio } from "./start.js";
 import { autostart, restart, status, stop } from "./status.js";
+import { cmd, cyan, tilde } from "./ui.js";
 import { update } from "./update.js";
 import { validateCommand } from "./validate.js";
+/** One line of the help: the name padded, then coloured, so the columns stay straight. */
+const line = (name, what) => `  ${cyan(name.padEnd(command().length + 12))}${what}`;
+const more = (what) => `  ${" ".repeat(command().length + 12)}${what}`;
 const HELP = `engenty wizards ${packageVersion()}
+engenty wizards runs the studio and your wizards on this computer. Below, “it” means engenty wizards.
 
-  ${command()}            what runs, and a menu: start, stop, update …; the first time, the setup runs first
-                        (needs a terminal)
-  ${command()} start      start it and open the studio; it runs in this terminal until Ctrl-C
-  ${command()} studio     open the studio; when it does not run, it starts as a service first
-  ${command()} setup      guided setup: your engenty account, an AI client to think with, ffmpeg,
-                        start at login
-  ${command()} account    your engenty account: status, sign-in, sign-out
-  ${command()} open       let this browser into the running studio (--print: only show the link)
-  ${command()} status     what is installed and what runs
-  ${command()} doctor     status, and what is wrong
-  ${command()} logs       the last lines it printed (\`logs 500\` for more)
-  ${command()} report     send status, model settings and the last log lines to your account, for support
-  ${command()} stop       stop it; the data is kept
-  ${command()} restart    stop it and start it again (after an update: the new version)
-  ${command()} update     the newest version
-  ${command()} autostart  start it at login: on, off (macOS: a LaunchAgent; Linux: a systemd service)
-  ${command()} connect    your wizards in your AI apps: every app found, or name them —
-                        ${apps(layout())
+Usage
+  ${command()} [command] [options]
+
+Commands
+${line(command(), "show the status and a menu (start, stop, update…); runs the setup the first time")}
+${more("(needs a terminal)")}
+${line(`${command()} start`, "start it in this terminal and open the studio (Ctrl-C stops it)")}
+${line(`${command()} studio`, "open the studio, starting it in the background if needed")}
+${line(`${command()} setup`, "set up your engenty account, an AI client, ffmpeg and start at login")}
+${line(`${command()} account`, "show your engenty account; add sign-in or sign-out to change it")}
+${line(`${command()} open`, "sign this browser in to the running studio (--print: only print the link)")}
+${line(`${command()} status`, "show what’s installed and running")}
+${line(`${command()} doctor`, "show the status and check for problems")}
+${line(`${command()} logs`, `print the last log lines (${command()} logs 500 for more)`)}
+${line(`${command()} report`, "send the status, model settings and last log lines to your account for support")}
+${line(`${command()} stop`, "stop it (your data is kept)")}
+${line(`${command()} restart`, "restart it, e.g. to switch to a newly installed version")}
+${line(`${command()} update`, "install the latest version")}
+${line(`${command()} autostart`, "start it when you log in: add on or off")}
+${more("(macOS: a LaunchAgent; Linux: a systemd user service)")}
+${line(`${command()} connect`, "add your wizards to your AI apps: every app found, or the ones you name:")}
+${more(apps(layout())
     .map((app) => app.id)
-    .join(", ")}
-  ${command()} disconnect take them out again (same names)
-  ${command()} mcp        the MCP server over stdio, as the AI apps start it
-  ${command()} validate   check wizards without the studio: .wizard files, unpacked packages, wizard JSON
-                        (--json for the issues as JSON); a project's connectors and plugins are
-                        checked on import
+    .join(", "))}
+${line(`${command()} disconnect`, "remove your wizards from those apps (same names)")}
+${line(`${command()} mcp`, "run the MCP server over stdio (AI apps start this)")}
+${line(`${command()} validate`, "check wizards without the studio: .wizard files, unpacked packages, wizard JSON")}
+${more("--json prints the issues as JSON. A space’s connectors and plugins are checked on import.")}
 
-  --yes, -y          ask nothing and install nothing optional
-  --local            setup without an account: nothing leaves this computer
-  --client <name>    install this AI client without asking: ${CLIENTS.map((c) => c.id).join(", ")}
-  --no-open          start without opening the browser
-  --service, -s      start as a service, detached from this terminal; \`${command()} stop\` stops it
-  --version, --help
+Options
+  --yes, -y           don’t ask; skip everything optional
+  --local             set up without an account; nothing leaves this computer
+  --client <name>     install this AI client without asking: ${CLIENTS.map((c) => c.id).join(", ")}
+  --no-open           start without opening the browser
+  --background, -s    start in the background, detached from this terminal (${command()} stop stops it)
+  --version, -v       print the version
+  --help, -h          print this help
 
-  Everything lives in ~/.engenty/wizards (ENGENTY_HOME moves it); settings go into its .env.
+Everything lives in ${tilde(layout().home)} (ENGENTY_HOME moves it). Settings go in its .env file.
 `;
+/** After a mistake on the command line: one line, not the whole help. */
+const SEE_HELP = `Run ${cmd("help")} to see every command.`;
 function parse(argv) {
     const args = {
         command: "",
@@ -75,7 +87,7 @@ function parse(argv) {
         else if (arg === "--no-open") {
             args.open = false;
         }
-        else if (arg === "--service" || arg === "-s") {
+        else if (arg === "--background" || arg === "--service" || arg === "-s") {
             args.service = true;
         }
         else if (arg === "--print") {
@@ -87,7 +99,7 @@ function parse(argv) {
         else if (arg === "--client") {
             const id = argv[++i];
             if (!CLIENTS.some((client) => client.id === id)) {
-                return `--client takes one of: ${CLIENTS.map((c) => c.id).join(", ")}`;
+                return `--client takes one of these: ${CLIENTS.map((c) => c.id).join(", ")}.`;
             }
             args.clients.push(id);
         }
@@ -110,7 +122,7 @@ function parse(argv) {
             args.paths.push(arg);
         }
         else if (args.command) {
-            return `Unexpected argument ${arg}.`;
+            return `Unexpected argument “${arg}”.`;
         }
         else {
             args.command = arg;
@@ -121,7 +133,7 @@ function parse(argv) {
 async function main(argv) {
     const args = parse(argv);
     if (typeof args === "string") {
-        console.error(`${args}\n\n${HELP}`);
+        console.error(`${args} ${SEE_HELP}`);
         return 2;
     }
     const paths = layout();
@@ -129,11 +141,11 @@ async function main(argv) {
     if (!args.command) {
         // Without a command: the menu, which needs a terminal. Starting is \`start\`.
         if (args.service || !args.open || args.print) {
-            console.error(`Options to start it go with start: ${command()} start ${argv.join(" ")}`);
+            console.error(`Those options belong to start: ${cmd(`start ${argv.join(" ")}`)}`);
             return 2;
         }
         if (!process.stdin.isTTY || !process.stdout.isTTY) {
-            console.error(`The menu needs a terminal. To start it: ${command()} start\n\n${HELP}`);
+            console.error(`The menu needs a terminal. To start engenty wizards: ${cmd("start")}\n\n${HELP}`);
             return 2;
         }
         return menu(paths, setupOptions, HELP);
@@ -192,12 +204,12 @@ async function main(argv) {
             process.chdir(startedIn);
             return validateCommand(args.paths, args.json);
         default:
-            console.error(`Unknown command ${args.command}.\n\n${HELP}`);
+            console.error(`Unknown command “${args.command}”. ${SEE_HELP}`);
             return 2;
     }
 }
 if (!nodeIsCurrent()) {
-    console.error(`engenty wizards needs Node.js 24.11 or newer; this is ${process.version}.`);
+    console.error(`engenty wizards needs Node.js 24.11 or newer. This is ${process.version}.`);
     process.exit(1);
 }
 process.exitCode = await main(process.argv.slice(2));

package/apps/runtime/dist/cli/mcp.js

@@ -3,6 +3,7 @@ import { join } from "node:path";
 import { createInterface } from "node:readline";
 import { LOCAL_CLIENT_HEADER, LOCAL_MCP_HEADER, mintLocalTicket } from "../auth/local-ticket.js";
 import { runningRuntime, settings, startInBackground } from "./start.js";
+import { tilde } from "./ui.js";
 /** The JSON-RPC messages of a response: a JSON body (one or a batch) or a server-sent stream. */
 export function messagesOf(contentType, body) {
     if (!body.trim()) {
@@ -48,12 +49,12 @@ export async function mcp(paths) {
             if (found) {
                 return found;
             }
-            process.stderr.write("engenty wizards is not running; starting it …\n");
+            process.stderr.write("engenty wizards isn’t running. Starting it…\n");
             const started = await startInBackground(paths);
             if (started) {
                 return started;
             }
-            throw new Error(`engenty wizards did not start; see ${join(paths.logs, "runtime.log")}.`);
+            throw new Error(`engenty wizards didn’t start. Its log is in ${tilde(join(paths.logs, "runtime.log"))}.`);
         })();
         running.catch(() => {
             running = null;
@@ -64,7 +65,7 @@ export async function mcp(paths) {
         const at = await runtime();
         const secret = readSecret(paths, dataDir);
         if (!secret) {
-            throw new Error("The data folder has no secret; start engenty wizards once.");
+            throw new Error("No secret in the data folder yet. Start engenty wizards once first.");
         }
         const response = await fetch(`http://127.0.0.1:${at.port}/api/mcp`, {
             method: "POST",
@@ -79,7 +80,7 @@ export async function mcp(paths) {
         });
         const body = await response.text();
         if (!response.ok && response.status !== 202) {
-            throw new Error(`engenty wizards answered ${response.status}: ${body.slice(0, 300)}`);
+            throw new Error(`engenty wizards responded with ${response.status}: ${body.slice(0, 300)}`);
         }
         return messagesOf(response.headers.get("content-type") ?? "", body);
     };

package/apps/runtime/dist/cli/menu.js

@@ -7,7 +7,7 @@ import { command, packageVersion, readInstallNote } from "./home.js";
 import { setup } from "./setup.js";
 import { open, runningRuntime, settings, start } from "./start.js";
 import { restart, status, stop } from "./status.js";
-import { badge, cyan, dim, no, ok } from "./ui.js";
+import { badge, busy, cmd, cyan, dim, no, ok } from "./ui.js";
 import { update } from "./update.js";
 async function look(paths) {
     const { dataDir } = settings(paths);
@@ -26,7 +26,7 @@ function report({ running, atLogin, release, account }) {
             : `${no} not running`,
     ];
     if (!("unavailable" in atLogin)) {
-        lines.push(atLogin.on ? `${ok} starts at login` : `${no} does not start at login`);
+        lines.push(atLogin.on ? `${ok} starts at login` : `${no} doesn’t start at login`);
     }
     lines.push(account.kind === "linked"
         ? `${ok} signed in as ${describeAccount(account)}`
@@ -41,38 +41,38 @@ function choices({ running, atLogin, release, account }) {
         ? [
             { value: "open", label: "Open the studio", hint: "in your browser" },
             { value: "restart", label: "Restart" },
-            { value: "stop", label: "Stop", hint: "the data is kept" },
+            { value: "stop", label: "Stop", hint: "your data is kept" },
         ]
         : [
-            { value: "start", label: "Start as service", hint: "in the background, opens the studio" },
-            { value: "foreground", label: "Start here", hint: "in this terminal; Ctrl-C stops it" },
+            { value: "start", label: "Start in the background", hint: "and open the studio" },
+            { value: "foreground", label: "Start here", hint: "in this terminal (Ctrl-C stops it)" },
         ];
     options.push({
         value: "update",
         label: "Update",
-        hint: release?.newer
-            ? `${release.latest} is out`
-            : release?.latest
-                ? "you have the newest"
-                : undefined,
+        hint: release?.newer ? `${release.latest} is out` : release?.latest ? "up to date" : undefined,
     });
     if (!("unavailable" in atLogin)) {
         options.push({
             value: "service",
-            label: "Service settings",
-            hint: atLogin.on ? "starts at login" : "does not start at login",
+            label: "Start at login",
+            hint: atLogin.on ? "on" : "off",
         });
     }
-    options.push({ value: "connect", label: "Connect AI apps", hint: "your wizards in Claude, Cursor, Codex …" }, {
+    options.push({
+        value: "connect",
+        label: "Connect AI apps",
+        hint: "use your wizards in Claude, Cursor, Codex…",
+    }, {
         value: "account",
         label: "Account",
         hint: account.kind === "linked"
             ? `signed in as ${describeAccount(account)}`
             : describeAccount(account),
-    }, { value: "status", label: "Status", hint: "what is installed, and what is wrong" }, { value: "setup", label: "Setup", hint: "account, AI client, ffmpeg, start at login" }, { value: "help", label: "Help", hint: "every command" }, { value: "quit", label: "Quit", hint: running ? "it keeps running" : undefined });
+    }, { value: "status", label: "Status", hint: "what’s installed, and any problems" }, { value: "setup", label: "Setup", hint: "account, AI client, ffmpeg, start at login" }, { value: "help", label: "Help", hint: "every command" }, { value: "quit", label: "Quit", hint: running ? "engenty wizards keeps running" : undefined });
     return options;
 }
-/** How the service runs: whether it starts at login. Esc goes back to the menu. */
+/** Whether it starts at login. Esc goes back to the menu. */
 async function serviceSettings(paths, atLogin) {
     if ("unavailable" in atLogin) {
         return;
@@ -81,7 +81,7 @@ async function serviceSettings(paths, atLogin) {
         message: "Start at login?",
         initialValue: atLogin.on,
         options: [
-            { value: true, label: "Yes", hint: "runs in the background from login on" },
+            { value: true, label: "Yes", hint: "runs in the background whenever you log in" },
             { value: false, label: "No", hint: "only when you start it" },
         ],
     });
@@ -92,20 +92,20 @@ async function serviceSettings(paths, atLogin) {
         await setAutostart(paths, on);
     }
     catch (error) {
-        p.log.warn(`Starting at login could not be switched: ${error.message}`);
+        p.log.warn(`Couldn’t change start at login: ${error.message}`);
     }
 }
 /** The commands used most, for when the menu ends. */
 function commands() {
     const name = command();
     return [
-        [`${name} start`, "start it and open the studio"],
-        [`${name} studio`, "open the studio; starts it when it does not run"],
-        [`${name} stop`, "stop it; the data is kept"],
-        [`${name} status`, "what is installed and what runs"],
-        [`${name} update`, "the newest version"],
-        [`${name} --version`, "the version you have"],
-        [`${name} help`, "every command"],
+        [`${name} start`, "start engenty wizards and open the studio"],
+        [`${name} studio`, "open the studio, starting engenty wizards if needed"],
+        [`${name} stop`, "stop engenty wizards (your data is kept)"],
+        [`${name} status`, "show what’s installed and running"],
+        [`${name} update`, "install the latest version"],
+        [`${name} --version`, "print the version you have"],
+        [`${name} help`, "list every command"],
     ]
         .map(([line, what]) => `${cyan(line.padEnd(name.length + 12))}${dim(what)}`)
         .join("\n");
@@ -123,13 +123,15 @@ export async function menu(paths, setupOptions, help) {
     }
     p.intro(`${badge("engenty wizards")} ${dim(packageVersion())}`);
     for (;;) {
-        const spinner = p.spinner();
-        spinner.start("Looking at what runs");
+        const spinner = busy("Checking status…");
         const state = await look(paths);
         spinner.stop(report(state));
-        const action = await p.select({ message: "What now?", options: choices(state) });
+        const action = await p.select({
+            message: "What would you like to do?",
+            options: choices(state),
+        });
         if (p.isCancel(action) || action === "quit") {
-            p.outro(dim(`${command()} opens this again; ${command()} help lists every command.`));
+            p.outro(dim(`${cmd()} opens this menu again. ${cmd("help")} lists every command.`));
             return 0;
         }
         switch (action) {
@@ -137,7 +139,7 @@ export async function menu(paths, setupOptions, help) {
                 await start(paths, { open: true, background: true });
                 break;
             case "foreground":
-                p.outro("Starting engenty wizards here");
+                p.outro("Starting engenty wizards here…");
                 return start(paths, { open: true });
             case "open":
                 await open(paths, false);
@@ -155,7 +157,7 @@ export async function menu(paths, setupOptions, help) {
                 }
                 // This menu is still the old version, so it ends here.
                 p.note(commands(), "Updated");
-                p.outro(dim(`${command()} opens this menu again, in the new version.`));
+                p.outro(dim(`${cmd()} opens this menu again, in the new version.`));
                 return 0;
             }
             case "service":

package/apps/runtime/dist/cli/report.js

@@ -1,9 +1,8 @@
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { LOCAL_MCP_HEADER, mintLocalTicket } from "../auth/local-ticket.js";
-import { command } from "./home.js";
 import { runningRuntime, settings } from "./start.js";
-import { bad, dim, ok } from "./ui.js";
+import { bad, cmd, dim, ok, tilde } from "./ui.js";
 /**
  * `wizards logs` shows the last lines the running runtime printed; `wizards report` sends its
  * status, model settings and those lines to the linked account, where an operator reads them
@@ -26,11 +25,11 @@ async function ask(paths, method, path) {
     const { dataDir } = settings(paths);
     const running = await runningRuntime(dataDir);
     if (!running) {
-        return `engenty wizards is not running. Start it with \`${command()} start\` first.`;
+        return `engenty wizards isn’t running. To start it: ${cmd("start")}`;
     }
     const secret = readSecret(paths, dataDir);
     if (!secret) {
-        return "The data folder's secret could not be read.";
+        return `Couldn’t read the data folder’s secret (${tilde(join(dataDir, "secret"))}).`;
     }
     const res = await fetch(`http://127.0.0.1:${running.port}/api/local/debug${path}`, {
         method,
@@ -57,25 +56,24 @@ export async function logsCommand(paths, value) {
         console.log(`${dim(at)} ${level} ${line.text}`);
     }
     if (!lines.length) {
-        console.log(dim("Nothing printed yet."));
+        console.log(dim("No log lines yet."));
     }
     return 0;
 }
 export async function reportCommand(paths) {
-    console.log(dim("Sending status, model settings (no keys) and the last log lines …"));
     const answer = await ask(paths, "POST", "/report");
     if (typeof answer === "string") {
         console.error(answer);
         return 1;
     }
     if (answer.status === 409) {
-        console.error(`${bad} This install is linked to no account. Link one in the studio under Settings → Account, then send again.`);
+        console.error(`${bad} This computer isn’t connected to an account. Sign in under Settings → Account in the studio, or with ${cmd("account sign-in")}. Then try again.`);
         return 1;
     }
     if (answer.status !== 200) {
-        console.error(`${bad} ${answer.body.error ?? `The runtime answered ${answer.status}.`}`);
+        console.error(`${bad} ${answer.body.error ?? `engenty wizards responded with an error (${answer.status}).`}`);
         return 1;
     }
-    console.log(`${ok} Report ${answer.body.id} is at ${answer.body.to}. Name it when you ask for help.`);
+    console.log(`${ok} Sent report ${answer.body.id} to ${answer.body.to}. Quote this ID when you ask for help.`);
     return 0;
 }