wizards 0.5.0 → 0.5.1

package/README.md

@@ -10,32 +10,28 @@
   Let AI do the work.
 </p>
 
-<p align="center">
-  <img src="docs/assets/setup.png" alt="The first start of engenty wizards: choose the engine it thinks with — Codex, Claude Code, Gemini CLI, Cursor Agent or your own keys">
-</p>
-
 ## What it does
 
-- **Describe it, get a wizard.** Say in plain words what you do again and again — a post with
-  an image, a research briefing, an invoice, a quote, a damage report — and engenty builds a
+- **Describe it, get a wizard.** Say in plain words what you do again and again – a post with
+  an image, a research briefing, an invoice, a quote, a damage report – and engenty builds a
   wizard for it: pages that ask what it needs, AI steps that do the work.
 - **AI steps do the work.** They research the web, write, draw images, render video, read PDFs,
-  scans and mails, build documents and dashboards, and write into other services over MCP, HTTP
+  scans and emails, build documents and dashboards, and write into other services over MCP, HTTP
   or a browser. Anything that changes an account asks first.
 - **Share it with a link.** Anyone can run a wizard in the browser, on a phone too: camera,
   code scan, voice notes, location and a drawn signature included. Results download as PDF,
-  Word, HTML, Markdown, PNG, MP4, CSV, Excel or JSON, or go out as a link.
-- **Runs on your machine, on your subscription.** It thinks with Codex, Claude Code, Gemini CLI
+  Word, HTML, Markdown, PNG, MP4, MP3, CSV, Excel or JSON, or go out as a link.
+- **Runs on your machine, on your subscription.** It uses Codex, Claude Code, Gemini CLI
   or Cursor Agent when one is installed and signed in, so no API key is needed. Or bring a key
   (Vercel AI Gateway, OpenAI, Anthropic), or a local model through Ollama. Your wizards and
   results stay in a folder on your machine.
 
 ## How it looks
 
-The studio: a wizard's steps as a flow with its branches, next to the conversation that changes them.
+The studio: a wizard’s steps as a flow with its branches, next to the conversation that changes them.
 
 <p align="center">
-  <img src="docs/assets/studio.png" alt="The studio of engenty wizards: the flow of a wizard that collects a month's receipts for bookkeeping — two pages of questions, AI steps that branch to the inbox and to customer portals, a review and the result — with the conversation beside it">
+  <img src="docs/assets/studio.png" alt="The studio of engenty wizards: the flow of a wizard that collects a month's receipts for bookkeeping – two pages of questions, AI steps that branch to the inbox and to customer portals, a review and the result – with the conversation beside it">
 </p>
 
 A wizard in use: it asks on one page, then on the next, and ends with the result to download or share.
@@ -46,14 +42,14 @@ A wizard in use: it asks on one page, then on the next, and ends with the result
 
 ## Get started
 
-Create an account at [engenty.ai](https://engenty.ai): it is in a closed beta, so "Get started"
-takes your e-mail for an invitation, or your invitation code. Signed in, the studio asks who
+Create an account at [engenty.ai](https://engenty.ai): it is in a closed beta, so “Get started”
+takes your email for an invitation, or your invitation code. Signed in, the studio asks who
 your team is, reads your website into your space, takes first documents, and you build your
-first wizard in the browser. Links run day and night on the team's credits.
+first wizard in the browser. Links run day and night on the team’s credits.
 
 ## Install it on your computer
 
-The same account on your own machine: it thinks with your Claude, ChatGPT, Gemini or Cursor
+The same account on your own machine: it runs on your Claude, ChatGPT, Gemini or Cursor
 subscription, reads your local files and browses for you, and what you publish keeps running in
 the cloud behind the same links. On macOS or Linux, in a terminal:
 
@@ -65,19 +61,23 @@ It needs nothing but `curl` and `tar` and asks for no password. It brings its ow
 Node you already have is left alone), installs engenty wizards into `~/.engenty/wizards` and
 then walks you through the rest:
 
-- **Your engenty account.** A code and the browser for the sign-in; your team's space comes
-  down to this computer. "Later" skips it, `wizards account sign-in` does it any time.
+- **Your engenty account.** “Sign in now?”: a code and the browser for the sign-in; what you
+  publish on this computer then runs in the cloud too. Say no, and `wizards account sign-in`
+  does it any time.
   `--local` leaves the account out: nothing leaves the computer, links answer on it only
   ([local only](https://engenty.ai/docs/user/local-only)).
-- **Something to think with.** It looks for Codex, Claude Code, Gemini CLI and Cursor Agent and
-  offers to install one if there is none — first the one whose app (Claude, ChatGPT, Cursor) is
+- **An AI client.** It looks for Codex, Claude Code, Gemini CLI and Cursor Agent and
+  offers to install the missing ones – first the one whose app (Claude, ChatGPT, Cursor) is
   on your Mac, as its subscription is most likely yours already. The first page of the studio
-  installs them too. Or use your account's credits, an API key or [Ollama](https://ollama.com).
-- **Google Chrome and ffmpeg** (optional): Chrome for PDF and PNG exports and for steps that use
-  a browser, ffmpeg for MP4 videos of animated widgets.
+  installs them too. Or use your account’s credits, an API key, [Ollama](https://ollama.com) or,
+  on a Mac with Apple silicon and macOS 26, Apple Intelligence.
+- **A browser and ffmpeg** (optional): Chrome, Edge or Chromium (on a Mac also Brave) for PDF
+  and PNG exports and for steps that use a browser, ffmpeg for MP4 videos of animated widgets.
 - **Start at login** (optional): engenty wizards starts in the background when you log in (a
   LaunchAgent on a Mac, a systemd user service on Linux). Links and AI clients then always
   reach it. `wizards autostart on` or `off` switches it later.
+- **Your AI apps** (optional): adds your wizards to the AI apps it finds, such as Claude
+  Desktop, Cursor or Codex. `wizards connect` and `wizards disconnect` do it later.
 
 It starts nothing. Afterwards:
 
@@ -86,6 +86,7 @@ wizards start
 ```
 
 starts it and opens the studio; it runs while that terminal is open, Ctrl-C stops it.
+`wizards start -s` starts it in the background instead.
 `wizards` opens a menu with all of it, `wizards status` says what is installed and what runs,
 `wizards setup` runs the guided setup again, and `wizards --help` lists the rest.
 
@@ -99,29 +100,30 @@ You need Node.js 24.11 or newer and pnpm 10 (`corepack enable`).
 
 ```bash
 git clone https://github.com/engenty/wizards.git
-cd engenty-wizards
+cd wizards
 pnpm install
 pnpm build
 pnpm wizards
 ```
 
-pnpm may list "Ignored build scripts" — that's expected, nothing to do.
+pnpm may list “Ignored build scripts” – that’s expected, nothing to do.
 
 Code steps (shell, Node, Python) run in a sandbox when Docker and the sandbox image are on the
 machine; a checkout brings its own sandbox, the installed version has none yet.
 
 ## First start
 
-The setup shows your account at the top and asks what engenty should think with. Pick an AI
-client that is installed on your computer — engenty uses your existing subscription and signs
-it in for you in a terminal right on the page — your account's credits, or enter your own keys.
+The setup shows your account at the top and asks how the AI should run. Pick an AI
+client that is installed on your computer – engenty uses your existing subscription and signs
+it in for you in a terminal right on the page – your account’s credits, Apple Intelligence on a
+Mac that has it, or your own keys.
 It stays until a test call works, then the studio opens.
 
-Change it later under Settings.
+Change it later under Settings → Models.
 
 ## Using it
 
-- **Make a wizard:** describe it in the studio's chat, or start from one of the starters.
+- **Make a wizard:** describe it in the studio’s chat, or start from one of the templates.
   You see the steps as a diagram and can change any of them.
 - **Run and share:** try it yourself, then share the link. Shared results are kept for 7 days
   for people without an account.
@@ -129,8 +131,9 @@ Change it later under Settings.
   GitHub, HubSpot and S3 are built in; any other service can be added from its API description
   or MCP server through the [integrations.sh](https://integrations.sh) registry. Services that
   sign in with OAuth need a few settings first: [Connectors](docs/development.md#connectors).
-- **Build from Claude Code or Codex:** Settings → "Build with Claude Code & co." creates a key
-  and shows the command to add engenty wizards to your AI client.
+- **Build from Claude Code or Codex:** Settings → Integrate adds engenty wizards to your AI
+  apps (Claude Desktop, Claude Code, Codex, Cursor and others), or `wizards connect` from a
+  terminal.
 
 Your machine only answers on `localhost`. To let others open shared wizards, run it on a server.
 
@@ -149,12 +152,12 @@ Back up the folder; delete it to start over. Settings go into `~/.engenty/wizard
 wizards update
 ```
 
-This runs the installer again without its questions. The studio says when a newer release is
-out and can run the same update from its footer.
+This runs the installer again without its questions. The studio says in a banner at the top
+when a newer release is out and can run the same update from there or from its About dialog.
 From source: `git pull`, `pnpm install`, `pnpm build`. Your data is brought up to date at the
 next start.
 
-To remove engenty wizards, run `wizards autostart off`, then delete `~/.engenty/wizards` (your data is in its `data` folder) and
+To remove engenty wizards, run `wizards stop`, `wizards autostart off` and `wizards disconnect`, then delete `~/.engenty/wizards` (your data is in its `data` folder) and
 `~/.local/bin/wizards`.
 
 ## Run it on a server
@@ -163,24 +166,24 @@ With Docker, behind an https proxy (Caddy, Traefik, Coolify):
 
 ```bash
 git clone https://github.com/engenty/wizards.git
-cd engenty-wizards
+cd wizards
 cp .env.example .env    # set APP_URL to your https address and add a model key
 docker compose up -d --build
 docker compose logs     # shows the link to open once
 ```
 
-Point the proxy at port 8891. On a server, engenty thinks with your keys or Ollama; the
-AI clients' subscriptions live on your own computer. The code sandbox is off in this image.
+Point the proxy at port 8891. On a server, engenty uses your keys or Ollama; the
+AI clients’ subscriptions live on your own computer. The code sandbox is off in this image.
 
 ## Troubleshooting
 
 | | |
 |---|---|
-| "This link is no longer valid" | The link works once. `wizards open` gives this browser a new one. |
+| “This link is no longer valid” | The link works once. `wizards open` gives this browser a new one. |
 | `wizards`: command not found | Open a new terminal, or run `~/.local/bin/wizards`. |
 | You open it under another address | Set `APP_URL` in `~/.engenty/wizards/.env` to the address you open. |
-| An AI client shows as not signed in | Sign it in on the setup page, or in your own terminal (e.g. `claude`, `codex login`), then "Check again". |
-| PDF or PNG export fails | Install Google Chrome, or set `CHROME_PATH` to Chrome or Chromium. |
+| An AI client shows as not signed in | Sign it in on the setup page, or in your own terminal (e.g. `claude`, `codex login`), then “Check again”. |
+| PDF or PNG export fails | Install Chrome, Edge or Chromium (on a Mac also Brave), or set `CHROME_PATH` to one. |
 | Port 24368 is taken | The next free port is used. To fix one, set `API_PORT` in `~/.engenty/wizards/.env`. |
 | Something else | `wizards doctor` checks the install. |
 
@@ -194,12 +197,12 @@ Development server, checks, how it is built, the managed mode:
 Plugins add tools for steps, routes with their own tables and pages in the studio, without
 changing the runtime: [docs/content/dev/plugins](docs/content/dev/plugins/index.md).
 
-The documentation — a user guide and the developer docs — is in [docs/content](docs/content)
+The documentation – a user guide and the developer docs – is in [docs/content](docs/content)
 and is a site of its own: `pnpm dev:docs`.
 
 ## License
 
-[FSL-1.1-MIT](LICENSE): use it for yourself and your company, run it, change it — just don't
+[FSL-1.1-MIT](LICENSE): use it for yourself and your company, run it, change it – just don’t
 offer it to others as a competing product or service. Each release becomes MIT two years
 after it is published. [COPYRIGHTS.md](COPYRIGHTS.md) names the owner, the marks, what is not ours and the
 third-party software with its licences.

package/apps/runtime/dist/agents/studio-assistant.js

@@ -42,9 +42,9 @@ THE PAGE
 - fill_field never saves: say that the person checks and saves. You never press buttons for the person.
 
 THE SPACE
-- Where a space's tools are there, you also fill the space in: what every wizard of the space draws on — who they are (title, about), the brand (logos, colours), assets (images, graphics, videos), documents, and facts (label → value: address, VAT id, phone, opening hours — anything). The space as it is now comes with every message then; you change it ONLY through tools.
-- A website: read_website it first. You get the page's text, colours from its stylesheet, logo candidates and the links to imprint / contact / about. Read those pages too (at most four more) for address, VAT id, register number, phone, email, bank details, who runs it.
-- Facts: one fact per thing, a short label in the person's language ("Adresse", "UID", "Telefon"), the value on one line where it fits. Only what a source or the person states — never guess, never invent. Keep the facts that are there; a fact with a known label is updated.
+- Where a space's tools are there, you also fill the space in: what every wizard of the space draws on — who they are (title, about), the brand (logos, colours), assets (images, graphics, videos), documents, and facts (label → value: address, VAT ID, phone, opening hours — anything). The space as it is now comes with every message then; you change it ONLY through tools.
+- A website: read_website it first. You get the page's text, colours from its stylesheet, logo candidates and the links to imprint / contact / about. Read those pages too (at most four more) for address, VAT ID, register number, phone, email, bank details, who runs it.
+- Facts: one fact per thing, a short label in the person's language ("Adresse", "USt-IdNr.", "Telefon"), the value on one line where it fits. Only what a source or the person states — never guess, never invent. Keep the facts that are there; a fact with a known label is updated.
 - About: two to five sentences — what they do, for whom, what sets them apart, the tone they write in. Rewrite it only when you learned something new or the person asks.
 - Colours: two to six, the main one first, each with a name that says what it is for ("Primär", "Hintergrund", "Text"). Take them from the stylesheet's variables or its most used colours, never from photos. set_colors replaces the list: pass all colours that should remain. Colours in no section are the standard ones; the first of them is the accent. Colour sections are optional like logo sections: only for a further palette a brand guide or the person names for its own use ("Illustration – drawings and charts"), never for the standard colours. A brand's gradients (set_gradients, as CSS) only where a brand guide or the site's stylesheet has them; patterns and background fills are pictures the person uploads.
 - Logos: save the best candidate (an SVG or a large PNG rather than a favicon); a second one only if it truly differs (for dark ground, a signet). A few images that show the business (header, team, products) may be saved as assets — a handful, never everything.

package/apps/runtime/dist/app.js

@@ -23,7 +23,7 @@ import { PLUGIN_NAME, pluginArchive, pluginMarketplace } from "./plugin.js";
 import { apiRoutes } from "./routes/api.js";
 import { browserReport, localDebugRoutes } from "./routes/debug.js";
 import { internalRoutes } from "./routes/internal.js";
-import { inLang, requestLang } from "./routes/lang.js";
+import { inLang, notFoundAnswer, requestLang } from "./routes/lang.js";
 import { marketplaceStudio } from "./routes/marketplace.js";
 import { publicPluginRoutes } from "./routes/plugin-public.js";
 import { pluginRoutes } from "./routes/plugins.js";
@@ -67,7 +67,7 @@ const ticketedRun = /^\/api\/runs\/([^/]+)(\/|$)/;
 app.use("*", async (c, next) => {
     if (!managed && !hostAllowed(c.req.header("host") ?? new URL(c.req.url).host)) {
         // Says where it does answer: the studio opened under another name shows the way there.
-        return c.json({ error: "Forbidden host", code: "host", appUrl: env.appUrl }, 403);
+        return c.json({ error: "This address isn’t allowed.", code: "host", appUrl: env.appUrl }, 403);
     }
     const origin = c.req.header("origin");
     const path = c.req.path.startsWith(`${basePath}/`)
@@ -201,7 +201,10 @@ if (serves.studio) {
     app.use("/api/studio/*", async (c, next) => {
         const user = await principalOf(c);
         if (!user) {
-            return c.json({ error: "unauthorized" }, 401);
+            return c.json({
+                error: inLang(c, "Du bist nicht angemeldet.", "You’re not signed in."),
+                code: "unauthorized",
+            }, 401);
         }
         if ((await tenantStatus(user.tenantId)) === "suspended") {
             return c.json({
@@ -257,7 +260,7 @@ if (serves.studio) {
         return c.body(new Uint8Array(zip), 200, { "content-type": "application/zip" });
     });
 }
-app.all("/api/*", (c) => c.json({ error: "not found" }, 404));
+app.all("/api/*", (c) => c.json(notFoundAnswer(c), 404));
 /**
  * `/w/<token>/<runner>`: a plugin's page runner, where the tenant has it and the wizard offers
  * it; otherwise the next handler (the app's page, which knows `steps`, `chat` and run ids).

package/apps/runtime/dist/auth/index.js

@@ -184,7 +184,7 @@ export const authRoutes = new Hono()
         usedTickets.set(ticket, expires);
     }
     else if (managed || !accessKey || !sameValue(given, accessKey)) {
-        return c.text("This link is no longer valid. Start the app again.", 403);
+        return c.text("This link is no longer valid. Run wizards open to get a new one.", 403);
     }
     else {
         accessKey = null;
@@ -285,7 +285,7 @@ export const authRoutes = new Hono()
         }
         catch (err) {
             console.error("[account]", err);
-            return c.html(closePage("The sign-in did not work. Please try again."), 400);
+            return c.html(closePage("The sign-in didn’t work. Try again."), 400);
         }
     }
     const state = unseal(getCookie(c, STATE_COOKIE) ?? "");

package/apps/runtime/dist/authoring/guide.js

@@ -243,7 +243,7 @@ type ResultStep = { type: "result", message?: string, deliverables: { from: step
 
 Templates (in instructions/prompt): {{fieldId}} · {{steps.stepId}} (whole output) · {{steps.stepId.key}} (json key)
   · {{itemsField}} (line items as a table WITH computed net/VAT/total) · {{itemsField.net|vat|gross}} · {{today}}
-  · the project (its settings): {{brand.name}} {{brand.about}} {{brand.colors}} · {{facts.key}} (one fact: address, VAT id, …) · {{facts}} (all facts)
+  · the project (its settings): {{brand.name}} {{brand.about}} {{brand.colors}} · {{facts.key}} (one fact: address, VAT ID, …) · {{facts}} (all facts)
     — every AI step already knows them, name one only where the text must carry it; agent steps also search the space's Knowledge
       and are told its categories: say in a step's instructions which category to filter by when the task names one
   · {{lists.listId}} (the stored list as a table, as it is when the step starts) · {{fileField}} (the names of the uploads, for read_document)

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

@@ -4,9 +4,9 @@ import { DeviceSignInError, requestDeviceCode, waitForDeviceSignIn } from "../au
 import { migrateControlDb } from "../db/client.js";
 import { env } from "../env.js";
 import { featuresFile, fileFeatures, writeFeature } from "../features.js";
-import { command, readInstallNote, writeInstallNote } from "./home.js";
+import { readInstallNote, writeInstallNote } from "./home.js";
 import { openBrowser, runningRuntime, settings } from "./start.js";
-import { bold, busy, cyan, dim, tilde } from "./ui.js";
+import { bold, busy, cmd, cyan, dim, tilde } from "./ui.js";
 /**
  * The account of this install, from the terminal. `wizards account` says where it stands,
  * `sign-in` runs the device flow (auth/device.ts), `sign-out` ends the link the way the
@@ -73,7 +73,7 @@ export function described(account, team, credits = true) {
 export function describeAccount(state) {
     switch (state.kind) {
         case "local":
-            return "local only";
+            return "only on this computer, no account";
         case "none":
             return "not signed in";
         default:
@@ -86,16 +86,18 @@ const host = () => new URL(env.local.accountUrl).host.replace(/^account\./, "");
 async function status() {
     const state = await accountState();
     if (state.kind === "local") {
-        console.log(`Local only (no account). ${dim(`\`${command()} account sign-in\` connects one.`)}`);
+        console.log(`Only on this computer, no account. ${dim(`To connect one: ${cmd("account sign-in")}`)}`);
         return 0;
     }
     if (state.kind === "none") {
-        console.log(`Not signed in. ${dim(`\`${command()} account sign-in\``)}`);
+        console.log(`Not signed in. ${dim(`To sign in: ${cmd("account sign-in")}`)}`);
         return 0;
     }
     const overview = await accountOverview();
     const team = overview?.tenant ?? state.team;
-    console.log(`Signed in as ${described(state.account, team)} · ${host()}${overview ? "" : dim(`  (${host()} did not answer${team ? "; this is from last time" : ""})`)}`);
+    console.log(`Signed in as ${described(state.account, team)} · ${host()}${overview
+        ? ""
+        : dim(`  (${host()} didn’t respond${team ? ", so this is from last time" : ""})`)}`);
     return 0;
 }
 /**
@@ -112,21 +114,21 @@ async function deviceSignIn() {
         return null;
     }
     const link = code.verificationUriComplete ?? code.verificationUri;
-    p.log.message(`Open ${cyan(link)} and type ${bold(code.userCode)}`);
+    p.log.message(`Open ${cyan(link)} and enter the code ${bold(code.userCode)}.`);
     if (openBrowser(link)) {
         p.log.message(dim("The page opens in your browser."));
     }
-    const spinner = busy("Waiting for you to allow it in the browser");
+    const spinner = busy("Waiting for you to confirm in the browser…");
     try {
         const account = await waitForDeviceSignIn(code);
         const overview = await accountOverview();
-        spinner.stop(`Signed in as ${described(account, overview?.tenant ?? null)}`);
+        spinner.stop(`Signed in as ${described(account, overview?.tenant ?? null)}.`);
         return account;
     }
     catch (err) {
         spinner.fail(err instanceof DeviceSignInError
             ? err.message
-            : `The sign-in did not work. ${err.message}`);
+            : `The sign-in didn’t work. ${err.message}`);
         return null;
     }
 }
@@ -139,29 +141,28 @@ async function pickUp(paths, interactive, why) {
     if (!(await runningRuntime(settings(paths).dataDir))) {
         return;
     }
-    const how = `${command()} restart`;
     if (!interactive) {
-        p.log.info(`The studio that runs ${why} after ${cyan(how)}.`);
+        p.log.info(`Run ${cmd("restart")} so ${why}.`);
         return;
     }
     const answer = await p.confirm({
-        message: `Restart the studio that runs, so it ${why}?`,
+        message: `Restart engenty wizards now, so ${why}?`,
         initialValue: true,
     });
     if (p.isCancel(answer) || !answer) {
-        p.log.info(dim(`Later: ${how}`));
+        p.log.info(dim(`To do it later: ${cmd("restart")}`));
         return;
     }
     // status.ts shows the account; loaded here when needed, so neither module waits on the other.
     const { restart } = await import("./status.js");
     await restart(paths);
 }
-const SIGNED_IN = "fetches the Pro modules of your plan and sends what is published to the cloud";
+const SIGNED_IN = "your plan’s Pro modules load and your published wizards arrive in the cloud";
 async function signIn(paths, interactive) {
     await ready();
     const linked = await linkedAccount();
     if (linked) {
-        p.log.info(`Already signed in as ${described(linked, await knownTeam(), false)}. ${dim(`To switch: \`${command()} account sign-out\` first.`)}`);
+        p.log.info(`Already signed in as ${described(linked, await knownTeam(), false)}. ${dim(`To switch accounts, run ${cmd("account sign-out")} first.`)}`);
         return 0;
     }
     const account = await deviceSignIn();
@@ -176,10 +177,12 @@ async function signIn(paths, interactive) {
 async function signOut(paths, interactive) {
     const state = await accountState();
     if (state.kind !== "linked") {
-        console.log(state.kind === "local" ? "Local only: there is no account to sign out." : "Not signed in.");
+        console.log(state.kind === "local"
+            ? "No account is connected, so there’s nothing to sign out of."
+            : "Not signed in.");
         return 0;
     }
-    const spinner = busy(`Signing out ${state.account.name || state.account.email}`);
+    const spinner = busy(`Signing out ${state.account.name || state.account.email}…`);
     await unlink();
     // The same as the studio's sign-out (DELETE /api/studio/account): what was sent to the cloud
     // is forgotten, the entitlement goes with the account's plan, and models that ran on its
@@ -197,7 +200,7 @@ async function signOut(paths, interactive) {
         await models.saveLocalModels({ source: "own" });
     }
     spinner.stop("Signed out. Your wizards and results stay on this computer.");
-    await pickUp(paths, interactive, "lets go of the account");
+    await pickUp(paths, interactive, "it disconnects from the account");
     return 0;
 }
 /** `wizards account [sign-in|sign-out]`. */
@@ -215,7 +218,7 @@ export async function accountCommand(paths, value, options) {
         case "logout":
             return signOut(paths, interactive);
         default:
-            console.error(`${command()} account [sign-in|sign-out]`);
+            console.error(`Usage: ${cmd("account [sign-in|sign-out]")}`);
             return 2;
     }
 }
@@ -250,37 +253,37 @@ export async function accountMenu(paths) {
 export async function accountStep(paths, options, interactive) {
     if (options.local) {
         localOnly(paths);
-        p.log.warn(`Local only. No account, nothing leaves this computer. Wizards, the space and results stay in ${tilde(settings(paths).dataDir)}. Links answer on this computer only.`);
-        p.log.message(dim(`Connect an account any time: ${command()} account`));
+        p.log.warn(`No account: nothing leaves this computer. Your wizards, your space and results stay in ${tilde(settings(paths).dataDir)}. Links work only on this computer.`);
+        p.log.message(dim(`To connect an account any time: ${cmd("account sign-in")}`));
         return;
     }
     const state = await accountState();
     if (state.kind === "local") {
-        p.log.info(`Local only (no account). ${dim(`\`${command()} account sign-in\` connects one.`)}`);
+        p.log.info(`Only on this computer, no account. ${dim(`To connect one: ${cmd("account sign-in")}`)}`);
         return;
     }
     if (state.kind === "linked") {
         const overview = await accountOverview();
-        p.log.success(`Signed in as ${described(state.account, overview?.tenant ?? state.team)}`);
+        p.log.success(`Signed in as ${described(state.account, overview?.tenant ?? state.team)}.`);
         return;
     }
     p.note(INTRO, "Your engenty account");
     if (!interactive) {
-        p.log.info(dim(`Sign in later: ${command()} account sign-in`));
+        p.log.info(dim(`To sign in later: ${cmd("account sign-in")}`));
         return;
     }
     const answer = await p.confirm({ message: "Sign in now?", initialValue: true });
     if (p.isCancel(answer)) {
-        p.cancel(`Setup stopped. Run it again with \`${command()} setup\`.`);
+        p.cancel(`Setup stopped. To run it again: ${cmd("setup")}`);
         return "cancelled";
     }
     if (!answer) {
-        p.log.info(dim(`Later: ${command()} account`));
+        p.log.info(dim(`To sign in later: ${cmd("account sign-in")}`));
         return;
     }
     const account = await deviceSignIn();
     if (!account) {
-        p.log.info(dim(`Later: ${command()} account sign-in`));
+        p.log.info(dim(`To sign in later: ${cmd("account sign-in")}`));
         return;
     }
     joinedAccount(paths);

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

@@ -82,16 +82,18 @@ async function systemdHere() {
 }
 export async function autostartState(paths) {
     if (process.platform !== "darwin" && process.platform !== "linux") {
-        return { unavailable: `not on ${process.platform}` };
+        return {
+            unavailable: process.platform === "win32" ? "not on Windows" : `not on ${process.platform}`,
+        };
     }
     if (!installedByScript(paths)) {
-        return { unavailable: "only for an install made by install.sh" };
+        return { unavailable: "only for installs made with the install script" };
     }
     if (process.platform === "darwin") {
         return { on: existsSync(LOGIN_ITEM), how: MAC_HOW };
     }
     if (!(await systemdHere())) {
-        return { unavailable: "this Linux has no systemd user session" };
+        return { unavailable: "this system has no systemd user session" };
     }
     try {
         await run("systemctl", ["--user", "is-enabled", "--quiet", UNIT], { timeout: 10_000 });

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

@@ -28,7 +28,7 @@ export function installClient(client, paths, onLine) {
     }
     const npm = findOnPath("npm", [dirname(process.execPath), process.env.PATH ?? ""].join(delimiter));
     if (!npm) {
-        return Promise.resolve({ code: 127, tail: "npm was not found next to this Node." });
+        return Promise.resolve({ code: 127, tail: "npm wasn’t found next to this Node.js." });
     }
     mkdirSync(paths.clients, { recursive: true });
     return runLogged(npm, [