wizards 0.5.0 → 0.5.2

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

@@ -1,12 +1,12 @@
 ---
 title: Your data
 description: Where wizards, results, files and keys are kept, how to back them up and how to start over.
-version: 0.3.2
+version: 0.5.0
 ---
 
 ## Where it is
 
-Everything of an install on your computer is in one folder:
+Everything engenty wizards keeps on your computer is in one folder:
 
 ```bash
 ~/.engenty/wizards/data
@@ -16,51 +16,51 @@ Everything of an install on your computer is in one folder:
 |---|---|
 | Databases | Your wizards, their versions, runs and results (a run from a website tag also keeps the page it was started on); what wizards keep for people |
 | Files | Uploads, generated media, documents, the files of each wizard |
-| A secret | Signs the studio's sign-in and links, and encrypts what is stored encrypted |
+| A secret | Signs the studio’s sign-in and its links, and encrypts what is stored encrypted |
 
-Keys you enter in the studio, and the sign-in of a linked account, are kept in the Keychain on a
-Mac (as `engenty-wizards`); elsewhere encrypted in the data folder.
+On a Mac, the API keys you enter in the studio and the sign-in of your account are kept in the
+Keychain (as `engenty-wizards`). On other systems they are stored encrypted in the data folder.
 
 ## Back up, move, start over
 
 | To | Do |
 |---|---|
-| Back up | Stop the app (`wizards stop`) and copy the folder |
-| Move to another computer | Install there, stop the app, put the folder in place. On a Mac, enter keys again and link your account again: the Keychain does not move |
-| Start over | Delete the folder. On a Mac, keys in the Keychain stay and are used again; delete the `engenty-wizards` entries in Keychain Access to drop them |
-| Keep it elsewhere | `ENGENTY_HOME` moves the whole install |
+| Back up | Stop engenty wizards (`wizards stop`) and copy the folder |
+| Move to another computer | Install engenty wizards there, stop it and put the folder in place. On a Mac, enter your API keys and sign in to your account again: the Keychain doesn’t move |
+| Start over | Delete the folder. On a Mac, the keys in the Keychain stay and are used again. To remove them, delete the `engenty-wizards` entries in Keychain Access |
+| Keep it elsewhere | Set `ENGENTY_HOME` to another folder. engenty wizards then keeps everything in its `wizards` folder there |
 
-After an update, your data is brought up to date at the next start.
+After an update, engenty wizards brings your data up to date the next time it starts.
 
 ## What leaves your computer
 
-- **Model calls** go to whatever the models run on: your AI client's provider, the provider of
-  your key, or your engenty account. With Ollama, or Apple Intelligence on a Mac, they stay on
-  your computer.
-- **Steps that use the web** send what they search, open or call.
-- **Connected services** get what a wizard's actions send them.
-- **Published wizards**, with an account signed in: the published version, its files, the
-  space's name, description, colours, facts and logo, and the space's own tables and pages go to
-  engenty.ai when you publish ([Test and share](./test-and-share.md#in-the-cloud)). Documents,
-  drafts, runs and connected accounts stay.
-- **Templates** come from the marketplace at engenty.ai; `MARKETPLACE_URL=off` in the settings
+- **Model calls** go to whatever the models run on: your AI client’s provider, the provider of
+  your API key, or your engenty account. With Ollama, or Apple Intelligence on a Mac, they stay
+  on your computer.
+- **Steps that use the web** send what they search for, open or call.
+- **Connected services** get what a wizard’s actions send them.
+- **Published wizards**, with an account signed in: when you publish, engenty.ai receives the
+  published version and its files, the space’s name, title, “About”, colours, facts and main
+  logo, and the space’s own tables and pages ([Test and share](./test-and-share.md#in-the-cloud)).
+  Documents, drafts, runs and connected accounts stay on your computer.
+- **Templates** come from the marketplace at engenty.ai. `MARKETPLACE_URL=off` in the settings
   file turns that off.
 - **The update check** asks GitHub for the newest release.
-- **The studio's typefaces** are loaded by your browser from Google Fonts.
-- **A location** is sent to a geocoder only if you set one. Unset, it stays coordinates.
-- **`wizards report`** sends the status, model settings (never a key) and log lines to your
-  account, only when you run it.
+- **The studio’s typefaces** are loaded by your browser from Google Fonts.
+- **A location** is sent to a geocoder only if you set one up (`GEOCODER_URL`). Without one, it
+  stays coordinates.
+- **`wizards report`** sends the status, the model settings (never a key) and log lines to your
+  account, and only when you run it.
 
-Without an account the app is not connected to an engenty account: wizards, the space and its
-files stay on your computer.
+Without an account, your wizards, the space and its files stay on your computer.
 
 ## How long things are kept
 
 | What | How long |
 |---|---|
 | Your wizards and your test runs | Until you delete them |
-| A real run of a published wizard (over its link or from an AI app), its result and the result's shared link | 7 days |
+| A real run of a published wizard (over its link or from an AI app), its result and the result’s shared link | 7 days |
 | What a wizard keeps for a person: lists, files, connected accounts, sign-ins | Until they delete it, or 400 days after its last use |
-| The space's tables and pages, and what wizards keep for every run: shared lists, pages | Until you delete them, or the wizard they belong to |
+| The space’s tables and pages, and what wizards keep for every run: shared lists, pages | Until you delete them, or the wizard they belong to |
 
-Connected accounts and kept sign-ins are stored encrypted.
+Connected accounts and remembered sign-ins are stored encrypted.

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

@@ -1,57 +1,55 @@
 ---
 title: First start
-description: Choose what engenty wizards thinks with. The studio opens once a test call works.
-version: 0.3.4
+description: Choose how the AI runs on your computer. The studio opens once a test call works.
+version: 0.5.0
 ---
 
-The first page of the studio is the setup, "Choose your Engine". It asks one thing: what should
-engenty think with?
-
-![The setup: choose the engine, an installed AI client or your own keys](../../assets/setup.png)
+The first page of the studio on your computer is the setup, “Choose how the AI runs”. It asks
+one thing: what should engenty wizards run on?
 
 ## 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.
+Your account stands above the choices. If you signed in during the [install](./install.md), it
+shows your name, your team and your credits. If you aren’t signed in yet, “Your engenty account”
+has a “Sign in” button that opens your browser for it. If you set engenty wizards up
+[only for this computer](./local-only.md), the page shows nothing here.
 
-## Choose your engine
+## Choose how the AI runs
 
-| Engine | Runs on | Needs |
+| Choice | Runs on | Needs |
 |---|---|---|
-| engenty credits | Your account's credits, like in the cloud | An account signed in. Shown only then |
+| engenty credits | Your account’s credits, as 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 |
 | Cursor Agent | Your Cursor subscription | The client installed and signed in |
-| Apple Intelligence | The model on this Mac, without an account or the internet | A Mac with Apple silicon on macOS 26 or later, Apple Intelligence switched on. Shown only on such a Mac |
-| Own keys | Vercel AI Gateway, OpenAI or Anthropic, or a model on your computer | One API key, or [Ollama](https://ollama.com) running |
+| Apple Intelligence | The model on this Mac, without an account or the internet | A Mac with Apple silicon on macOS 26 or later, with Apple Intelligence switched on. Shown only on such a Mac |
+| Your own keys | Vercel AI Gateway, OpenAI or Anthropic, or a model on your computer | One API key, or [Ollama](https://ollama.com) running |
 
 - **An AI client that is not installed** installs right on the page, in a terminal shown there.
   It takes about a minute.
-- **Signing in** happens in the same terminal, with the client's own sign-in: your browser opens
-  for it, and the terminal closes once the sign-in is there.
-- **A client signed in with an API key from your shell** is not on your subscription. Sign in on
-  the page so it is.
+- **Signing in** happens in the same terminal, with the client’s own sign-in. Your browser opens
+  for it, and the terminal closes once you are signed in.
+- **A client signed in with an API key from your shell** does not run on your subscription.
+  Click “Sign in here” on the page to change that.
 - **Apple Intelligence** has nothing to connect: the test runs once it is switched on (System
-  Settings → Apple Intelligence & Siri). It thinks short texts and decisions; research, long
-  documents and code stay with a client you picked before it, or need another way, added later
-  under Settings → Models. See [Apple Intelligence](./models.md#apple-intelligence).
+  Settings → Apple Intelligence & Siri). It handles short texts and decisions on this Mac.
+  Research, long documents and code stay with a client you chose before it, or you add another
+  option for them later under Settings → Models. See [Apple Intelligence](./models.md#apple-intelligence).
 
 ## The test
 
-After you connect, one short call shows whether the way to the model is open. The setup stays
-until that call works; then "Open the studio" takes you in.
+After you connect, one short call checks that the model can be reached. The setup stays until
+that call works. Then “Open the studio” takes you in.
 
 ## What an AI client does not cover
 
 An installed AI client writes and reasons. Codex also makes images on your sign-in; with the
-other clients images need a key. Video and audio need a key with every client, or the credits of
-an engenty account; a Mac with Apple silicon on macOS 26 can write voice notes down itself. One
-Vercel AI Gateway key serves text, images, video and web search. You can add it later under
+other clients, images need a key. Video and audio need a key with every client, or the credits
+of an engenty account. A Mac with Apple silicon on macOS 26 can write down voice notes by itself.
+One Vercel AI Gateway key covers text, images, video and web search. You can add it later under
 [Models and account](./models.md).
 
 ## Change it later
 
-Settings → Models. See [Models and account](./models.md).
+You change it under Settings → Models. See [Models and account](./models.md).

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

@@ -1,40 +1,38 @@
 ---
 title: User Guide
 description: Install engenty wizards, build a wizard, run and share it.
-version: 0.3.4
+version: 0.5.0
 ---
 
 engenty wizards turns something you do again and again into a wizard: pages that ask what it
 needs, AI steps that do the work, and a link to share. A post with an image, a research
 briefing, an invoice, a quote, a damage report.
 
-![The studio: the flow of a wizard as a diagram, with the conversation that changes it beside it](../../assets/studio.png)
-
 ## What you do with it
 
 | | |
 |---|---|
-| **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. |
-| **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. |
+| **Describe it** | You say in plain words what the wizard should do. The assistant builds the flow, and you see it as a diagram and can change any step. |
+| **Let AI steps work** | They research the web, write, draw images, render video, read PDFs, scans and emails, build documents and dashboards, and write into other services. Anything that changes an account asks first. |
+| **Share a link** | Anyone can run 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. |
+| **In the cloud, or on your computer** | You sign up and build in the browser, and links run on your team’s credits. Or you install it on your computer: there it runs on Codex, Claude Code, Gemini CLI or Cursor Agent with your own subscription, on your own API keys or on a local model, and your files stay with you. |
 
 ## Where to start
 
 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.
+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 how the AI runs.
 5. Use it from your [AI apps](./ai-apps.md): Claude Desktop, Cursor, Codex and others.
 
 ## Words used here
 
 | Word | Means |
 |---|---|
-| Account | You, signed in at engenty.ai with Google, GitHub or a link by mail |
+| Account | You, signed in at engenty.ai with Google, GitHub or a link by email |
 | 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 |
+| Space | What all your wizards know and produce: name, logo, colours, facts, documents, data, results. A team’s first one in the cloud is “My wizards”; on your computer it is “My computer” (in German: “Meine Wizards”, “Mein Computer”) |
+| Studio | Where you build wizards: engenty.ai/studio, or `/studio` on your computer |
 | 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 |
@@ -42,9 +40,10 @@ briefing, an invoice, a quote, a damage report.
 
 ## Two places it runs
 
-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).
+Your team, its spaces 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:
+you [install](./install.md) engenty wizards there and sign in to the same account. It then uses
+the AI clients and keys on that computer, and what you publish there runs in the cloud as well
+([Test and share](./test-and-share.md#in-the-cloud)). In the cloud studio, that space is marked
+“Edited on your computer.” – you change it on your computer, not there. Without an account,
+engenty wizards stays [only on your computer](./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.4
+version: 0.5.0
 ---
 
 ## Install
@@ -18,40 +18,39 @@ 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 |
+| Your engenty account | Asks “Sign in now?”. If you say yes, it shows a link and a code and opens your browser for the sign-in at account.engenty.ai (if you have no account yet, the page takes an invitation code). Once you are signed in, what you publish on this computer runs in the cloud too. If you say no, `wizards account sign-in` does it any time. `--local` leaves the account out altogether: see [Local only](./local-only.md) |
+| An AI client | Looks for Codex, Claude Code, Gemini CLI and Cursor Agent and offers to install the ones that are missing. It puts first the one whose app (ChatGPT, Claude, Cursor) is on your Mac, as you most likely have that subscription already. You can also use your account’s credits, 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). engenty wizards uses that one; [`CHROME_PATH`](./command-line.md#settings) picks another. It also says whether ffmpeg is there for MP4 videos of animated widgets, and 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 apps can always reach it. It is a LaunchAgent on a Mac and a systemd user service on Linux |
 | Your AI apps (optional) | Offers to add your wizards to the [AI apps](./ai-apps.md) it finds, such as Claude Desktop, Cursor or Codex |
-| The command | If `~/.local/bin` is not on your PATH, offers to add it in your shell's settings file |
+| The command | If `~/.local/bin` is not on your PATH, it offers to add it in your shell’s settings file |
 
-It starts nothing. At the end it says whether it runs and how to start, stop and check it.
-You install once; from then on you use the `wizards` command.
+The installer starts nothing. At the end it says whether engenty wizards is running and how to
+start, stop and check it. You install once; from then on you use the `wizards` command.
 
 ## Start, stop, check
 
-| Command | Does |
+| Command | What it does |
 |---|---|
 | `wizards start` | Starts it and opens the studio. It runs while that terminal is open; Ctrl-C stops it |
-| `wizards start -s` | Starts it as a service: the terminal stays free |
-| `wizards studio` | Opens the studio; starts it as a service first if it does not run |
+| `wizards start -s` | Starts it in the background, so the terminal stays free |
+| `wizards studio` | Opens the studio. If engenty wizards isn’t running, it starts it in the background first |
 | `wizards stop` | Stops it. Your data is kept |
-| `wizards status` | Whether it runs, and where |
+| `wizards status` | Shows whether it is running, 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 |
+| `wizards account` | Shows the account this computer is signed in to; `sign-in` and `sign-out` change it |
+| `wizards` | Opens a menu with all of it |
 
-The studio is at
-`http://localhost:24368/studio/`. The link the command opens signs this browser in; it works
-once. For another browser, see [`wizards open`](./command-line.md).
+The studio is at `http://localhost:24368/studio/`. The link the command opens signs this browser
+in, and it works once. For another browser, see [`wizards open`](./command-line.md).
 
 If the command is not found, open a new terminal or run `~/.local/bin/wizards`.
 
 ## Install it as an app
 
-In Chrome or Edge the studio installs as an app with its own window and its own icon in the Dock
-or taskbar. The studio offers it in a banner at the top; or click the install icon at the right
-of the address bar.
+In Chrome or Edge you can install the studio as an app, with its own window and its own icon in
+the Dock or taskbar. The studio offers it in a banner at the top, or you click the install icon at
+the right of the address bar.
 
 ## Other ways to get it
 
@@ -67,13 +66,15 @@ of the address bar.
 wizards update
 ```
 
-This runs the installer again without its questions. If it runs, `wizards restart` then starts
-the new version; the command says so. "Update" in the `wizards` menu restarts it into the new
-version by itself. The studio also says in a banner at the top when a newer release is out:
-"Update" there installs it and starts the new version. The About dialog, behind the engenty mark
-in the app bar, shows the same, and so does the line at the top of Settings → Account: its
-version number opens the About dialog with what is new. Your data is brought up to date at the
-next start.
+This runs the installer again without its questions. If engenty wizards is running, `wizards
+restart` then starts the new version; the command tells you so. "Update" in the `wizards` menu
+restarts it into the new version by itself.
+
+The studio also tells you in a banner at the top when a new version is out (“Version … of
+engenty wizards is out.”). “Update” there installs it and starts the new version. The About
+dialog behind the engenty mark in the app bar shows the same, and so does the line at the top of
+Settings → Account: its version number opens the About dialog with what is new. Your data is
+brought up to date at the next start.
 
 ## Remove
 

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

@@ -1,11 +1,11 @@
 ---
 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
+description: engenty wizards on your computer without an account. Nothing leaves your computer, and links work only there. The flag, what it means, and how to connect an account later.
+version: 0.5.0
 ---
 
-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.
+During the setup, engenty wizards on your computer normally signs in to your account. What you
+publish then runs in the cloud too. You can also keep it on your computer alone.
 
 ## The flag
 
@@ -13,19 +13,21 @@ the computer, and what you publish runs in the cloud too. An install can also st
 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`.
+`--local` skips the account step of the setup and switches the account off on this computer.
+If engenty wizards is already installed, run `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.
+- There is no account, and nothing leaves this computer. Your wizards, your space and results
+  stay in `~/.engenty/wizards/data` ([Your data](./data.md)).
+- Links work on this computer only: `http://localhost:24368/w/…`. If others should open them,
+  run engenty wizards [on a server](./server.md) of your own.
+- It runs on your AI clients, your own API keys, Ollama or Apple Intelligence
+  ([First start](./first-start.md)). Without an account, video and voice need your own API key.
+- The studio shows nothing about an account: no sign-in, no credits, no copy in the cloud. The
+  feature switch `account` is off in the `.features` file in `~/.engenty/wizards`, and
+  `wizards features` lists it.
+- `wizards status` and the `wizards` menu say “only on this computer, no account”.
 
 ## Connect an account later
 
@@ -33,6 +35,8 @@ On an install that is there already: `wizards setup --local`.
 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.
+The command shows a link and a code and opens your browser for the sign-in. After that,
+engenty wizards is connected to the account and the switch is on again. `wizards account` shows
+where it stands, and `wizards account sign-out` disconnects it. As long as the account is
+switched off, the studio offers no sign-in, so you use the command. Once you are connected,
+Settings → Account in the studio shows the account and can sign you out too.