wizards 0.3.8 → 0.4.0

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

@@ -1,6 +1,9 @@
+import "./install-env.js";
+import { accountCommand } from "./account.js";
 import { apps, connectCommand } from "./connect.js";
 import { featuresCommand } from "./features.js";
 import { command, layout, packageVersion, readInstallNote } from "./home.js";
+import { startedIn } from "./install-env.js";
 import { CLIENTS, nodeIsCurrent } from "./machine.js";
 import { mcp } from "./mcp.js";
 import { menu } from "./menu.js";
@@ -16,7 +19,9 @@ const HELP = `engenty wizards ${packageVersion()}
                         (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: an AI client to think with, ffmpeg, start at login
+  ${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
@@ -37,6 +42,7 @@ const HELP = `engenty wizards ${packageVersion()}
                         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
@@ -52,6 +58,7 @@ function parse(argv) {
         paths: [],
         json: false,
         yes: false,
+        local: false,
         open: true,
         service: false,
         print: false,
@@ -62,6 +69,9 @@ function parse(argv) {
         if (arg === "--yes" || arg === "-y") {
             args.yes = true;
         }
+        else if (arg === "--local") {
+            args.local = true;
+        }
         else if (arg === "--no-open") {
             args.open = false;
         }
@@ -90,7 +100,7 @@ function parse(argv) {
         else if (arg.startsWith("-")) {
             return `Unknown option ${arg}.`;
         }
-        else if ((args.command === "autostart" || args.command === "logs") && !args.value) {
+        else if (["autostart", "logs", "account"].includes(args.command) && !args.value) {
             args.value = arg;
         }
         else if (["connect", "disconnect", "features"].includes(args.command)) {
@@ -115,7 +125,7 @@ async function main(argv) {
         return 2;
     }
     const paths = layout();
-    const setupOptions = { yes: args.yes, clients: args.clients };
+    const setupOptions = { yes: args.yes, clients: args.clients, local: args.local };
     if (!args.command) {
         // Without a command: the menu, which needs a terminal. Starting is \`start\`.
         if (args.service || !args.open || args.print) {
@@ -168,6 +178,8 @@ async function main(argv) {
             return update(paths);
         case "autostart":
             return autostart(paths, args.value);
+        case "account":
+            return accountCommand(paths, args.value, { yes: args.yes });
         case "connect":
         case "disconnect":
             return connectCommand(paths, args.apps, args.command === "disconnect");
@@ -176,6 +188,8 @@ async function main(argv) {
         case "features":
             return featuresCommand(args.apps);
         case "validate":
+            // The paths are the person's, from where they typed the command (install-env.ts).
+            process.chdir(startedIn);
             return validateCommand(args.paths, args.json);
         default:
             console.error(`Unknown command ${args.command}.\n\n${HELP}`);

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

@@ -1,5 +1,6 @@
 import * as p from "@clack/prompts";
 import { updateStatus } from "../update.js";
+import { accountMenu, accountState, describeAccount } from "./account.js";
 import { autostartState, setAutostart } from "./autostart.js";
 import { connectCommand } from "./connect.js";
 import { command, packageVersion, readInstallNote } from "./home.js";
@@ -10,14 +11,15 @@ import { badge, cyan, dim, no, ok } from "./ui.js";
 import { update } from "./update.js";
 async function look(paths) {
     const { dataDir } = settings(paths);
-    const [running, atLogin, release] = await Promise.all([
+    const [running, atLogin, release, account] = await Promise.all([
         runningRuntime(dataDir),
         autostartState(paths),
         updateStatus().catch(() => null),
+        accountState(),
     ]);
-    return { running, atLogin, release };
+    return { running, atLogin, release, account };
 }
-function report({ running, atLogin, release }) {
+function report({ running, atLogin, release, account }) {
     const lines = [
         running
             ? `${ok} running  ${cyan(running.url)} ${dim(`pid ${running.pid}, since ${new Date(running.startedAt).toLocaleString()}`)}`
@@ -26,12 +28,15 @@ function report({ running, atLogin, release }) {
     if (!("unavailable" in atLogin)) {
         lines.push(atLogin.on ? `${ok} starts at login` : `${no} does not start at login`);
     }
+    lines.push(account.kind === "linked"
+        ? `${ok} signed in as ${describeAccount(account)}`
+        : `${no} ${describeAccount(account)}`);
     if (release?.newer) {
         lines.push(`${cyan("↑")} ${release.latest} is out ${dim(`(you have ${release.current})`)}`);
     }
     return lines.join("\n");
 }
-function choices({ running, atLogin, release }) {
+function choices({ running, atLogin, release, account }) {
     const options = running
         ? [
             { value: "open", label: "Open the studio", hint: "in your browser" },
@@ -58,7 +63,13 @@ function choices({ running, atLogin, release }) {
             hint: atLogin.on ? "starts at login" : "does not start at login",
         });
     }
-    options.push({ value: "connect", label: "Connect AI apps", hint: "your wizards in Claude, Cursor, Codex …" }, { value: "status", label: "Status", hint: "what is installed, and what is wrong" }, { value: "setup", label: "Setup", hint: "AI client, ffmpeg, start at login" }, { value: "help", label: "Help", hint: "every command" }, { value: "quit", label: "Quit", hint: running ? "it keeps running" : undefined });
+    options.push({ value: "connect", label: "Connect AI apps", hint: "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 });
     return options;
 }
 /** How the service runs: whether it starts at login. Esc goes back to the menu. */
@@ -153,6 +164,9 @@ export async function menu(paths, setupOptions, help) {
             case "connect":
                 await connectCommand(paths, [], false);
                 break;
+            case "account":
+                await accountMenu(paths);
+                break;
             case "status":
                 await status(paths, true);
                 break;

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

@@ -2,6 +2,7 @@ import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { delimiter, join } from "node:path";
 import * as p from "@clack/prompts";
+import { accountStep } from "./account.js";
 import { autostartState, setAutostart } from "./autostart.js";
 import { installClient, installCommand } from "./clients.js";
 import { appStates, connectApps } from "./connect.js";
@@ -9,21 +10,9 @@ import { runLogged } from "./exec.js";
 import { command, installedByScript, isCheckout, packageVersion, readInstallNote, writeInstallNote, } from "./home.js";
 import { CLIENTS, detectClients, findChrome, findFfmpeg, findOnPath, suggestedClient, vendorApp, } from "./machine.js";
 import { runningRuntime, settings } from "./start.js";
-import { badge, cyan, dim, tilde } from "./ui.js";
+import { badge, busy, cyan, dim, tilde } from "./ui.js";
 /** The studio as an app of its own: Chrome (or Edge) installs it from the page. */
 const CHROME_APP = "Tip: in Chrome or Edge the studio installs as an app, in a window of its own with its own icon. The studio offers it at the top; or use the install icon in the address bar.";
-/** A spinner on a terminal; where nobody watches, only what came of it. */
-function busy(message) {
-    if (!process.stdout.isTTY) {
-        return { stop: (text) => p.log.step(text), fail: (text) => p.log.warn(text) };
-    }
-    const spinner = p.spinner();
-    spinner.start(message);
-    return {
-        stop: (text) => spinner.stop(text),
-        fail: (text) => spinner.error(text),
-    };
-}
 function cancelled(value) {
     if (p.isCancel(value)) {
         p.cancel(`Setup stopped. Run it again with \`${command()} setup\`.`);
@@ -298,9 +287,10 @@ async function howToUse(paths) {
     ].join("\n"));
 }
 /**
- * The guided setup: what this machine has, what is missing, and what to install — an AI client
- * to think with, ffmpeg, starting at login. It starts nothing; it ends with what runs and how to
- * start, stop and check it. Returns false when it was stopped.
+ * The guided setup: the account this computer joins, then what this machine has, what is
+ * missing, and what to install — an AI client to think with, ffmpeg, starting at login. It
+ * starts nothing; it ends with what runs and how to start, stop and check it. Returns false
+ * when it was stopped.
  */
 export async function setup(paths, options) {
     const interactive = !options.yes && Boolean(process.stdin.isTTY && process.stdout.isTTY);
@@ -310,6 +300,9 @@ export async function setup(paths, options) {
         `Install  ${tilde(paths.home)}${installedByScript() ? "" : dim(`  (data; the code runs from ${isCheckout() ? "this checkout" : "npm"})`)}`,
         `Node     ${process.version}  ${dim(tilde(process.execPath))}`,
     ].join("\n"));
+    if ((await accountStep(paths, options, interactive)) === "cancelled") {
+        return false;
+    }
     if ((await clientsStep(paths, options, interactive)) === "cancelled") {
         return false;
     }

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

@@ -1,5 +1,6 @@
 import { accessSync, constants, existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
+import { accountState, describeAccount } from "./account.js";
 import { autostartState, setAutostart } from "./autostart.js";
 import { installedByScript, isCheckout, packageRoot, packageVersion } from "./home.js";
 import { detectClients, findChrome, findFfmpeg, nodeIsCurrent } from "./machine.js";
@@ -11,11 +12,12 @@ import { bad, badge, cyan, dim, no, ok, tilde } from "./ui.js";
  */
 export async function status(paths, checks) {
     const { dataDir } = settings(paths);
-    const [running, clients, ffmpeg, atLogin] = await Promise.all([
+    const [running, clients, ffmpeg, atLogin, account] = await Promise.all([
         runningRuntime(dataDir),
         detectClients(paths),
         findFfmpeg(),
         autostartState(paths),
+        accountState(),
     ]);
     const chrome = findChrome();
     const row = (label, value) => console.log(`  ${label.padEnd(9)} ${value}`);
@@ -31,6 +33,7 @@ export async function status(paths, checks) {
     if (!("unavailable" in atLogin)) {
         row("At login", atLogin.on ? `${ok} starts ${dim(`(${atLogin.how})`)}` : `${no} does not start`);
     }
+    row("Account", `${account.kind === "linked" ? ok : no} ${describeAccount(account)}`);
     for (const { client, path, version } of clients) {
         row(client.name.split(" ")[0], path ? `${ok} ${version} ${dim(tilde(path))}` : `${no} not installed`);
     }

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

@@ -1,12 +1,26 @@
 import { homedir } from "node:os";
 import { styleText } from "node:util";
+import * as p from "@clack/prompts";
 const colours = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
 /** The name on engenty's orange. */
 export const badge = (text) => colours ? `\x1b[48;2;224;83;27m\x1b[97m\x1b[1m ${text} \x1b[0m` : text;
 export const dim = (text) => styleText("dim", text);
+export const bold = (text) => styleText("bold", text);
 export const cyan = (text) => styleText("cyan", text);
 export const ok = styleText("green", "✓");
 export const no = styleText("yellow", "–");
 export const bad = styleText("red", "✗");
 /** A path as the person would write it. */
 export const tilde = (path) => path.startsWith(homedir()) ? `~${path.slice(homedir().length)}` : path;
+/** A spinner on a terminal; where nobody watches, only what came of it. */
+export function busy(message) {
+    if (!process.stdout.isTTY) {
+        return { stop: (text) => p.log.step(text), fail: (text) => p.log.warn(text) };
+    }
+    const spinner = p.spinner();
+    spinner.start(message);
+    return {
+        stop: (text) => spinner.stop(text),
+        fail: (text) => spinner.error(text),
+    };
+}

package/apps/runtime/dist/docs/user/command-line.md

@@ -1,7 +1,7 @@
 ---
 title: Command line
 description: The wizards command — start, setup, status, update — and the install's settings file.
-version: 0.3.2
+version: 0.3.4
 ---
 
 ## Commands
@@ -11,7 +11,8 @@ version: 0.3.2
 | `wizards` | What runs, and a menu: open the studio, restart and stop while it runs, "Start as service" or "Start here" (in this terminal) while it does not; update, which restarts what runs into the new version; "Service settings" (start at login); connect AI apps, status, setup, help. The first time, the setup runs first. Needs a terminal |
 | `wizards start` | Starts it and opens the studio. It runs in that terminal; Ctrl-C stops it. The first time, the setup runs first |
 | `wizards studio` | Opens the studio in your browser. When it does not run, it starts as a service first |
-| `wizards setup` | The guided setup again: an AI client to think with, the browser and ffmpeg, start at login, your AI apps |
+| `wizards setup` | The guided setup again: your account, an AI client to think with, the browser and ffmpeg, start at login, your AI apps. `--local` leaves the account out ([Local only](./local-only.md)) |
+| `wizards account` | How the install stands to your account: signed in as whom, which team, the credits. `sign-in` shows a code and opens the browser; `sign-out` disconnects the install |
 | `wizards open` | Lets this browser into the running studio. `--print` only shows the link; it works once, within a minute |
 | `wizards status` | What is installed and what runs, with the browser the app uses for PDF, PNG and websites |
 | `wizards doctor` | Status, and what is wrong |

package/apps/runtime/dist/docs/user/create-account.md

@@ -0,0 +1,47 @@
+---
+title: Create an account
+description: Your team, its space and your wizards live in your account at engenty.ai. Sign up with an invitation code, answer four questions, build.
+version: 0.3.4
+---
+
+engenty wizards is in a closed beta: a new account needs an invitation code. "Get started" on
+[engenty.ai](https://engenty.ai) takes your e-mail and puts you on the list; the code comes by
+mail as soon as a seat is free. With a code, the same step opens the sign-up.
+
+## Sign up
+
+1. Type the code at [account.engenty.ai/sign-up](https://account.engenty.ai/sign-up). The link
+   in the invitation mail has it filled in.
+2. Sign in with Google, GitHub, or a link by mail. There is no password.
+3. The studio opens at [engenty.ai/studio](https://engenty.ai/studio).
+
+Your account is a **team**: it holds your credits, your spaces and, on the Team plan, your
+colleagues. It starts with credits, some of which end on a date; the account pages at
+[account.engenty.ai](https://account.engenty.ai) show them.
+
+## The first visit
+
+The studio asks four things, one per page. Each but the first can be skipped and changed later.
+
+| Page | Asks | Goes to |
+|---|---|---|
+| Who you are | What your team is called: your company, your club, or just your name | The team's name at account.engenty.ai |
+| About you & your brand | Your website. engenty reads your name, what you do, your logo and colours from it; or you write a line about yourself | [Space → Info & brand](./space.md#info--brand) |
+| Knowledge | Documents the wizards may look things up in: price lists, your terms, an FAQ | [Space → Knowledge](./space.md#knowledge) |
+| Your space | Nothing: it explains the space that holds all of this, "Meine Wizards" | — |
+
+Then "Build your first wizard" opens the studio's start: describe a task in a sentence, or pick
+a template. See [Build a wizard](./build-a-wizard.md).
+
+## What the cloud does
+
+- Wizards built here run behind a link that works day and night, on the team's credits.
+- Share links, the tag for your website, QR codes and the channels of [Test and share](./test-and-share.md) work as on an install.
+- What the wizards think with is the team's: [Models and account](./models.md).
+
+## Also on your computer
+
+The same account works on your own computer: [install](./install.md) engenty wizards there and
+sign in during the setup. It thinks with your Claude, ChatGPT, Gemini or Cursor subscription,
+reads your local files and browses for you; what you publish there runs in the cloud too, behind
+the same links. "Also on your computer" on the studio's start page mails you the command.

package/apps/runtime/dist/docs/user/first-start.md

@@ -1,7 +1,7 @@
 ---
 title: First start
 description: Choose what engenty wizards thinks with. The studio opens once a test call works.
-version: 0.3.2
+version: 0.3.4
 ---
 
 The first page of the studio is the setup, "Choose your Engine". It asks one thing: what should
@@ -9,10 +9,18 @@ engenty think with?
 
 ![The setup: choose the engine, an installed AI client or your own keys](../../assets/setup.png)
 
+## Your account
+
+Above the engines stands your account: signed in during the [install](./install.md), it shows
+your name, your team and your credits, and your team's space is on this computer. Not signed in
+yet, "Sign in" opens your browser for it; an install that is [local only](./local-only.md)
+shows nothing here.
+
 ## Choose your engine
 
 | Engine | Runs on | Needs |
 |---|---|---|
+| engenty credits | Your account's credits, like in the cloud | An account signed in. Shown only then |
 | Claude Code | Your Claude subscription | The client installed and signed in |
 | Codex | Your ChatGPT subscription | The client installed and signed in |
 | Gemini CLI | Your Google account | The client installed and signed in |

package/apps/runtime/dist/docs/user/index.md

@@ -1,7 +1,7 @@
 ---
 title: User Guide
 description: Install engenty wizards, build a wizard, run and share it.
-version: 0.3.2
+version: 0.3.4
 ---
 
 engenty wizards turns something you do again and again into a wizard: pages that ask what it
@@ -17,30 +17,34 @@ briefing, an invoice, a quote, a damage report.
 | **Describe it** | Say in plain words what the wizard should do. The assistant builds the flow; you see it as a diagram and change any step. |
 | **Let AI steps work** | They research the web, write, draw images, render video, read PDFs, scans and mails, build documents and dashboards, and write into other services. Anything that changes an account asks first. |
 | **Share a link** | Anyone runs the wizard in a browser, on a phone too. Results download as PDF, Word, HTML, Markdown, PNG, MP4, MP3, CSV, Excel or JSON, or go out as a link. |
-| **Keep it on your machine** | It thinks with Codex, Claude Code, Gemini CLI or Cursor Agent on your own subscription, with your own keys, or with a local model. Wizards and results stay in a folder on your computer. |
+| **In the cloud, or on your computer** | Sign up and build in the browser; links run on your team's credits. Or install it on your computer: it thinks with Codex, Claude Code, Gemini CLI or Cursor Agent on your own subscription, with your own keys, or with a local model, and your files stay with you. |
 
 ## Where to start
 
-1. [Install](./install.md) it: one command on macOS or Linux.
-2. At the [first start](./first-start.md), choose what it thinks with.
-3. [Build a wizard](./build-a-wizard.md) from a sentence or a template.
-4. [Test and share](./test-and-share.md) it.
+1. [Create an account](./create-account.md) at engenty.ai, with an invitation code.
+2. [Build a wizard](./build-a-wizard.md) from a sentence or a template.
+3. [Test and share](./test-and-share.md) it.
+4. Also on your computer: [install](./install.md) it there, signed in to the same account, and at the [first start](./first-start.md) choose what it thinks with.
 5. Use it from your [AI apps](./ai-apps.md): Claude Desktop, Cursor, Codex and others.
 
 ## Words used here
 
 | Word | Means |
 |---|---|
-| Studio | Where you build wizards: `/studio` of your install |
+| Account | You, signed in at engenty.ai with Google, GitHub or a link by mail |
+| Team | What the sign-up creates: it holds your credits, your spaces and, on the Team plan, your colleagues |
+| Space | What all your wizards know and produce: name, logo, colours, facts, documents, data, results. A team's first one is "Meine Wizards" |
+| Studio | Where you build wizards: engenty.ai/studio, or `/studio` of your install |
 | Wizard | A flow of steps a person walks through on a link |
 | Step | One part of the flow: a page, an AI step, a review, the result |
 | Run | One person going through a wizard once |
-| Space | What all your wizards know: name, logo, colours, facts, documents |
 | Model class | The kind of model a step needs. Which model serves a class is a setting, not part of the wizard |
 
 ## Two places it runs
 
-This guide describes the install on your own computer: there you build. engenty.ai is the cloud:
-with an account, what you publish on your computer also runs there, behind a link that works
-while your computer is off, on the account's credits. The studio at engenty.ai shows those
-wizards and their runs and changes nothing ([Test and share](./test-and-share.md#in-the-cloud)).
+Your team, its space and your wizards live in your account. engenty.ai is the cloud: you build
+there in the browser, and links run day and night on the team's credits. Your computer can join:
+[install](./install.md) engenty wizards there, signed in to the same account, and it thinks with
+the AI clients and keys on that machine; what you publish there runs in the cloud as well
+([Test and share](./test-and-share.md#in-the-cloud)). An install without an account is
+[local only](./local-only.md).

package/apps/runtime/dist/docs/user/install.md

@@ -1,7 +1,7 @@
 ---
 title: Install
 description: One command on macOS or Linux. It brings its own Node.js and asks for no password.
-version: 0.3.2
+version: 0.3.4
 ---
 
 ## Install
@@ -18,6 +18,7 @@ command into `~/.local/bin` and then walks you through the rest:
 
 | Step | What it does |
 |---|---|
+| Your engenty account | Shows a code and opens the browser for the sign-in at account.engenty.ai (no account yet? the page takes an invitation code). Signed in, your team's space comes down to this computer, and what you publish here runs in the cloud too. "Later" skips it: `wizards account sign-in` does it any time. `--local` leaves the account out altogether: [Local only](./local-only.md) |
 | Something to think with | Looks for Codex, Claude Code, Gemini CLI and Cursor Agent and offers to install the ones that are missing. It proposes the one whose app (ChatGPT, Claude, Cursor) is on your Mac first, as that subscription is most likely yours already. You can also use an API key, [Ollama](https://ollama.com) or, on a Mac with Apple silicon and macOS 26, Apple Intelligence: the studio's [first page](./first-start.md) offers them |
 | A browser and ffmpeg | Names the browser for PDF and PNG exports and steps on websites: the first of Chrome, Edge and Chromium it finds (on a Mac also Brave). The app uses that one; [`CHROME_PATH`](./command-line.md#settings) picks another. Says whether there is ffmpeg for MP4 videos of animated widgets; with Homebrew it offers to install it |
 | Start at login (optional) | engenty wizards starts in the background when you log in, so links and AI clients always reach it. A LaunchAgent on a Mac, a systemd user service on Linux |
@@ -37,6 +38,7 @@ You install once; from then on you use the `wizards` command.
 | `wizards stop` | Stops it. Your data is kept |
 | `wizards status` | Whether it runs, and where |
 | `wizards restart` | Stops it and starts it again |
+| `wizards account` | How the install stands to your account; `sign-in` and `sign-out` |
 | `wizards` | A menu with all of it |
 
 The studio is at

package/apps/runtime/dist/docs/user/local-only.md

@@ -0,0 +1,38 @@
+---
+title: Local only
+description: An install without an account. Nothing leaves the computer; links answer on it only. The flag, what it means, and how to connect an account later.
+version: 0.3.4
+---
+
+An install normally signs in to your account during the setup: your team's space comes down to
+the computer, and what you publish runs in the cloud too. An install can also stay alone.
+
+## The flag
+
+```bash
+curl -fsSL https://engenty.ai/install.sh | bash -s -- --local
+```
+
+`--local` skips the account step of the setup and switches the account off for this install.
+On an install that is there already: `wizards setup --local`.
+
+## What it means
+
+- No account, nothing leaves this computer. Wizards, the space and results stay in
+  `~/.engenty/wizards/data` ([Your data](./data.md)).
+- Links answer on this computer only: `http://localhost:24368/w/…`. For others to open them,
+  run it [on a server](./server.md) of your own.
+- It thinks with your AI clients, your own keys, Ollama or Apple Intelligence
+  ([First start](./first-start.md)). Without an account, video and voice need a key of your own.
+- The studio shows no account surfaces: no sign-in offer, no credits, no cloud copy. The feature
+  switch `account` is off in the install's `.features` file; `wizards features` lists it.
+
+## Connect an account later
+
+```bash
+wizards account sign-in
+```
+
+The command shows a code and opens the browser for the sign-in; afterwards the install is
+connected, and the switch is on again. `wizards account` says how the install stands,
+`wizards account sign-out` disconnects it. Settings → Account in the studio does the same.

package/apps/runtime/dist/docs/user/meta.json

@@ -1,11 +1,12 @@
 {
   "title": "User Guide",
-  "description": "Install engenty wizards, build a wizard, run and share it.",
+  "description": "Create an account, build a wizard, run and share it, install it on your computer.",
   "root": true,
   "icon": "LifeBuoy",
   "pages": [
     "index",
     "---Start---",
+    "create-account",
     "install",
     "first-start",
     "---Wizards---",
@@ -24,6 +25,7 @@
     "---Your install---",
     "command-line",
     "data",
+    "local-only",
     "server",
     "troubleshooting"
   ]

package/apps/runtime/dist/docs/user/models.md

@@ -1,7 +1,7 @@
 ---
 title: Models and account
 description: Who does what your wizards ask for — an installed AI client, your own API keys, a local model, or credits.
-version: 0.3.2
+version: 0.3.4
 ---
 
 Settings → Models decides who does what your wizards ask for. On your computer it is yours; on
@@ -125,7 +125,8 @@ Text & reasoning) picks what builds your wizards in the editor's conversation:
 
 ## Account
 
-An account is optional. With it you
+An install normally signs in to your account during the setup ([Install](./install.md)); one
+without an account is [local only](./local-only.md). With an account you
 
 - use credits instead of your own keys (the editor's note about missing models says so where
   text, image or video models are missing),

package/apps/runtime/dist/manage.js

@@ -145,6 +145,18 @@ export async function tenantInfo(id, fresh = false) {
 export function forgetTenant(id) {
     tenants.delete(id);
 }
+/** Renames the team at the Manage-App; what it answers is the tenant as it stands now. */
+export async function renameTenant(id, name) {
+    const value = await call("PATCH", `/v1/tenants/${encodeURIComponent(id)}`, {
+        name,
+    });
+    tenants.set(id, { at: Date.now(), value });
+    return value;
+}
+/** The Manage-App mails the install command and the first steps to one of the team's people. */
+export function installMail(email, lang) {
+    return call("POST", "/v1/install-mail", { email, lang });
+}
 export function verifyKey(key) {
     return call("POST", "/v1/keys/verify", { key });
 }