vibe64 0.1.35 → 0.1.37

package/docs/colleague-usage/lesson-step-bar.md

@@ -0,0 +1,99 @@
+# The lesson step bar
+
+The yellow lesson step bar above the project page plays the current lesson
+step: its position, beats, **Step**, **Open** and **Courses**. The rest of
+Learn mode is in [The Learning environment](learning-environment.md).
+
+In Learn mode, while your lesson is loaded, a yellow bar above the project page
+names the lesson and shows **Step N of M** with the step's title and status.
+**Previous step** and **Next step** (arrow buttons) move through the steps.
+**Step** (the ≡ button) opens the whole current step right under the bar, in
+place, with everything the Lesson tab offers for it: its text, diagram and
+**Play**, **Done**, **Mark as done**, its question or **Check now**, **Show me**,
+**Teach me** and **Previous step**/**Next step**. It covers the top of the page
+(at most about two thirds of the screen, scrolling inside); **Step** again or
+Escape closes it, and **Show me** closes it so the place it shows is in view.
+This tab remembers whether it is open. **Open** shows the step in the page's
+**Lesson** tab (see [The Lesson tab](learning-environment.md#the-lesson-tab)); **Open** is hidden while the Lesson tab is showing. **Courses**, at its right end (a book icon
+on a phone), opens the Courses overlay to choose another lesson; it stays
+there when the bar is collapsed. The chevron at its left collapses it to one
+line (**Hide the lesson step**) and expands it again (**Show the lesson step**);
+this tab remembers the choice. On a phone the lesson name is hidden, and
+**Open** shows the project side of the page (instead of the chat) on the Lesson
+tab, also when the page is already on the Lesson tab, for example after
+pressing **L** twice or **Show chat**.
+
+### Steps with beats
+
+Some steps walk you through the real page from the bar itself, one short line
+(a *beat*) at a time, while the lesson stays where it is. The bar then shows
+the lesson name, **N/M** (the step) and a dot per beat (the filled dot is the
+current one), then the beat's line:
+
+- A *show* line rings the place it names (for example the **Preview** tab or the
+  coding chat) and moves on by itself after a few seconds; a thin line under
+  the bar shows the time left. **Pause** (and **Play**) stops and resumes it;
+  it also waits while your pointer or keyboard focus is on the bar, while
+  Courses is open, while the bar is collapsed or the tab is hidden. With
+  reduced motion turned on in your system it never moves by itself: press
+  **Next**.
+- A *do* line waits for you to do what it says, in this lesson's practice
+  project: be at a place (for example open **Files**), send a message in the
+  coding chat, wait for the agent to finish, open a file, press the practice
+  App's button, open or minimise Colleague, press **Save** or **Reload
+  preview**, or press **L** (it counts once you are back in Learn). When the
+  page sees you do it, the line says **✓ Done.** (or **✓ You're already here.**
+  when you already are) and the next beat plays after a moment. **Next** skips
+  it. Only what you do after the line appears counts.
+- **Do it for me** on a *do* line does it through the page's own controls:
+  it opens the place (or the file), reveals and focuses the coding chat, opens
+  Courses or Colleague (without asking it anything), reloads the Preview, or
+  sends the line's quoted prompt as your next message in the practice
+  project's Main chat. That message shows a **Sent by the lesson** chip under
+  it. On a **Save** line it only points at **Save**: saving stays yours. On a
+  line about waiting for the agent, pressing the App's button, minimising
+  Colleague or pressing **L** there is no Do it for me (for **L** it shows
+  where the button is). If it cannot be done here (for example the chat cannot take a
+  message now), the bar says so; do it yourself or press **Next**, or, with
+  no AI connected, **Set up your AI**.
+- While the lesson waits for your AI (its practice project could not be
+  prepared without one), the bar plays no beats and says so instead, with
+  **Set up your AI**; see `learning-mode-ui`.
+- On a step you would finish with **Done**, doing every *do* line of it marks
+  the step done by itself.
+- **Back** and **Next** (arrows) move one beat, and into the previous or next
+  step at either end.
+- After the last beat the bar shows the step's own control: **Done**, **Mark as
+  done**, **Check my work** (an automatic check, or a review; a check that does
+  not pass says why under the line) or **Answer in Step** for a question, which opens the
+  step under the bar. When the step has passed it shows **Next step**. **I'm stuck**
+  (on a *do* line, and after the last beat of a step that **Check my work**
+  decides, until the step passes; also in **Step** beside **Teach me**) opens
+  Colleague and asks it for help with this step (see `learning-with-colleague`).
+  On a phone a *do* line keeps only **Do it for me** on the bar; **I'm stuck**
+  is then in **Step**.
+  A step never moves on by itself.
+- **Show me** on such a step (in the bar's step or the Lesson tab) plays its
+  beats again from the first one.
+
+**Check my work on a reviewed step.** Some steps are checked by a review of
+your work: the bar's line (and the step under **Step**) shows what the review
+looks for. **Check my work** uses your own AI (the Lesson review route in AI
+Accounts → Model routing) to look at the changes in your practice project
+(and, when the step says so, your coding chat); the line says **Checking your
+work with your AI…** for up to about a minute, without a Cancel. **Passed ✓**
+with the reviewer's comment passes the step for good. **Not yet:** says what
+is missing, often with a **Hint:**; change your work and press **Check
+again**. Checking unchanged work again repeats the saved answer without using
+your AI. With no changes yet it says so and uses nothing. If the review cannot
+run (the agent is still working, no AI route, a provider error), the bar says
+why, nothing is recorded, and you can press **Check again**. Colleague never
+runs a review or passes a step for you.
+
+This tab remembers the beat and the pause; another tab or device starts the
+step at its first beat. Collapsing the bar leaves only the step position and
+its dots. On a phone the bar has two lines: the position and arrows above,
+the beat's line and its one button below; **Step** and **Courses** show only
+their icons, **Open** is left out (**Step** shows the whole step, and the
+**Lesson** tab is one tap away), and the open step fills the width. A step without beats shows its title
+and status as before, and **Show me** when it can point at a place.

package/docs/colleague-usage/managed-app-access.md

@@ -26,6 +26,13 @@ account creation and browser sign-in have distinct effects. If the application
 cannot resolve an identity, check that account and the declared exchange rather
 than inventing another selector type. A failed save retains recoverable feedback.
 
+The coding agent can also save this list for you in its session. Tell it which
+existing accounts to use, or confirm the names and accounts it proposes from the
+application's existing accounts. It saves only what you asked for or confirmed,
+never creates application accounts or changes roles, and then signs in as each
+name in Preview to verify access. The saved list appears here and in Preview's
+identity menu; use the session's normal Save to keep it.
+
 Colleague can read the available identity metadata and make an explicitly requested
 configuration change, including a selective removal, through the native owner.
 It can open App access and delegate application-account investigation to a coding

package/docs/colleague-usage/message-delivery-recovery.md

@@ -37,12 +37,13 @@ unknown delivery or claim a failed request was delivered.
 
 ## When a turn finishes while you send
 
-Sending a new instruction while Claude works uses its targeted **Send now**
-control when supported by the installed Claude version. Background agents and
-background tasks continue; foreground work may be interrupted to read your
-instruction. This also applies to **Set goal** and **Resume goal** during active
-work. **Stop** keeps its cancellation behavior. Older Claude versions retain
-their previous interruption behavior. These controls work on desktop and mobile.
+Sending a new instruction while Claude works never interrupts it. Claude queues
+the message, lets the running command finish (for example a long deploy or test
+run), then reads your instruction before continuing. Background agents and
+background tasks also continue. A short question such as "status?" therefore
+gets its answer once the current command completes, not immediately. This also
+applies to **Set goal** and **Resume goal** during active work. Use **Stop** when
+you want to cancel the current work. These controls work on desktop and mobile.
 
 If you send a steering message just as Claude or Codex finishes, the queue can
 submit those same words and attachments as the next ordinary request. This happens

package/docs/colleague-usage/preview-browser-checks.md

@@ -39,11 +39,19 @@ Other tool dependencies still need their own declared runtime support. A fixture
 setup failure does not count as a failed application assertion or a passing check.
 
 The coding agent can read `vibe64-helper playwright --help` before a project has
-browser tests or a matching test runtime. Help starts neither Preview nor a browser.
+browser tests or a matching test runtime. `vibe64-helper preview --help` (also
+`preview browser --help`) works even while the assistant's Preview control is
+disconnected; it lists every browser command, including `browser storage-state`,
+and the fields of the status, screenshot and eval JSON. Help starts neither
+Preview nor a browser.
 An actual suite still requires the project's installed Playwright version and a
 matching managed runtime. A version error is a test-runtime blocker; interactive
 checks can use the existing managed Preview browser. Report the exact required
 version to the platform operator instead of installing a separate browser.
+On a computer without managed browser runtimes, the agent runs the project's own
+Playwright (`npx playwright test`). If that browser is missing, the agent reports
+it and asks you before running `npx playwright install chromium`; installing it
+is your decision.
 
 Before a suite, the coding agent can run `vibe64-helper playwright readiness`.
 It distinguishes absent tests, uninstalled dependencies, an unsupported exact

package/docs/colleague-usage/preview-starting-application.md

@@ -64,7 +64,6 @@ The same diagnostic record family separates slow conversation access checks into
 fresh user lookup, saved learning-attempt validation, practice scope, project
 access and project-context resolution. It records the elapsed phases even when
 access fails; repeated checks keep their existing authorization behavior.
-These access timings also apply to standalone Learning conversations.
 Concurrent Learning readers share verification of the same pinned course files
 while that verification is running. Completed results are not cached: later
 reads still reject missing or changed installed files, with the same reinstall

package/docs/colleague-usage/preview.md

@@ -53,6 +53,17 @@ If the previewed application shows its own login screen, enter that application'
 credentials. Its login and realtime connection run through the Preview address.
 HTTPS previews retain the HTTPS scheme for applications that use it to set
 secure login cookies and redirects.
+Preview tells the application its browser-facing address through the standard
+forwarded headers. An application configured to trust its local proxy then
+builds absolute links, asset URLs and callbacks on the Preview address. If pages
+load without styles or links point to `127.0.0.1`, the application does not
+trust the proxy yet; ask the agent to configure trusted proxies for its
+framework. A page returned by a form post also keeps its links on the Preview
+address. Preview tells the application the visitor's address in
+`X-Forwarded-For`; a value the browser sends itself is not passed on. Form posts
+and realtime connections from the Preview page reach the application on its
+local address, so its allowed hosts must include that local address as well as
+the Preview address.
 In the local editor, Preview keeps the editor's loopback hostname through login
 and page navigation, so opening the editor on `localhost` also works. If a tab
 shows an expired Preview access error after a restart, use **Reload preview**
@@ -168,6 +179,6 @@ controller.
 For managed browser checks, test ownership and recovery, read
 [Browser checks from chat](preview-browser-checks.md).
 
-For lesson diagrams shown over Preview, see [Lesson presentation in Preview](preview-lesson-presentation.md).
+Lesson diagrams play in the Learning environment, not over Preview; see [The Learning environment (L)](learning-environment.md).
 
 To choose which application Preview starts, see [Choose a starting application](preview-starting-application.md).

package/docs/colleague-usage/project-messages.md

@@ -9,7 +9,7 @@ review the changes, publish if already authorized, and ping this project with
 the package versions.” The coding assistant uses:
 
 ```sh
-vibe64-helper session message-project jskit-ai "Review the changes, then ping vibe64-online with the result and published versions."
+vibe64-helper session message-project jskit-ai "Review the changes, then ping my-app with the result and published versions."
 ```
 
 Without `--session`, the destination's **currently selected session** receives the
@@ -98,7 +98,7 @@ Host-specific guidance shares the same bounded instruction budget; adding it mus
 not prevent either conversation from starting.
 
 Installed host instructions reach coding assistants through the host environment
-filter. On a configured VPS they include the local update and SSH restore commands;
+filter. A host that offers its own update or restore commands includes them there;
 hosts without that facility do not advertise it.
 
 If the destination has a pinned source session, that is its server-selected

package/docs/colleague-usage/project-setup.md

@@ -16,6 +16,11 @@ You need access to the project and an available coding assistant for delegated w
 4. When output controls replace setup, select the intended output and use its
    normal Run control. A successful setup request alone does not mean it is running.
 
+The agent writes the setup and output declarations in the project's
+`genesis/stack.md`. Their exact grammar comes from Vibe64 itself: the agent reads
+it with `vibe64-helper spec workspace-setup` and `vibe64-helper spec outputs`
+(see [coding agents](coding-agents.md)). A setup error names the spec to read.
+
 The existing source and Git history are retained. If preparation fails, read the
 reported step and use the offered retry after addressing its cause. Do not apply
 a starter over an existing repository to repair it.
@@ -30,8 +35,10 @@ The agent should reuse answers you already gave and wait for your choices.
 Choosing a name such as “admin” does not grant that account administrator rights.
 
 The coding agent can implement the application's Preview identity adapter after
-you accept that work. To configure named accounts, open **Dashboard > App access**
-and use **Managed app access > Add identity**. Enter **Name**, **App identifier**
+you accept that work. It can also save the named accounts you give or confirm
+(for example `admin` and `user` with their emails) and then verify each in Preview;
+it never creates accounts or changes roles for this. To configure them yourself,
+open **Dashboard > App access** and use **Managed app access > Add identity**. Enter **Name**, **App identifier**
 and **Application value**, choose **Make default** if needed, then **Save**.
 On mobile, use **Show project** to reach Dashboard. Colleague can explain these
 fields and, when asked, save the supported identity settings; application code

package/docs/colleague-usage/running-vibe64-on-your-computer.md

@@ -0,0 +1,61 @@
+# Running Vibe64 on your computer
+
+Start Vibe64 from a terminal in the folder you want to work on:
+
+```sh
+npx vibe64
+```
+
+Vibe64 opens in your browser. To start it for a different folder, run
+`npx vibe64 --project /path/to/folder`. To start it without opening a browser,
+run `PORT=3001 npx vibe64 --no-open` and open `http://127.0.0.1:3001` yourself.
+
+Nothing needs configuring. Vibe64 runs as you, with your own tools and folders.
+
+## Tools Vibe64 uses
+
+Vibe64 runs the tools already installed on your computer: the ones your
+terminal finds on its `PATH`, plus Homebrew's `/opt/homebrew/bin` on macOS.
+That includes Node.js, npm, Git and any language tools your projects need.
+Install or upgrade them the way you normally would; Vibe64 uses the new version
+the next time it runs a command.
+
+- **AI agents.** Claude Code, Codex and opencode are used through their own
+  commands, so each must be installed on this computer before you can use it.
+  See [AI accounts](ai-accounts-and-routing.md) for what to install and how to
+  check again.
+- **npm global installs** go wherever your own npm configuration puts them.
+- **Playwright** uses its own browser cache. If **Health** reports that
+  Playwright or its Chromium is missing, install Playwright, then run
+  `playwright install chromium`.
+
+## Where Vibe64 keeps things
+
+| What | Linux | macOS |
+|---|---|---|
+| Projects Vibe64 creates for you | `~/Vibe64` | `~/Vibe64` |
+| Vibe64's own data (sessions, settings, history) | `~/.local/state/vibe64` (or `$XDG_STATE_HOME/vibe64`) | `~/Library/Application Support/Vibe64` |
+
+Vibe64 creates its data folder (private to you) when it starts, unless you
+set `VIBE64_SYSTEM_ROOT` to a folder of your own, which must already exist.
+A folder you open with `npx vibe64` stays where it is; Vibe64 does not move it.
+
+### Moving data from an earlier version on macOS
+
+Earlier versions kept data in `~/.local/state/vibe64` on macOS too. If that
+folder exists and the new one does not, Vibe64 stops at startup and prints the
+exact command to move it, for example:
+
+```sh
+mv ~/.local/state/vibe64 ~/Library/Application\ Support/Vibe64
+```
+
+Run the printed command, then start Vibe64 again. Vibe64 never moves the folder
+itself. To keep using the old location instead, start Vibe64 with
+`VIBE64_SYSTEM_ROOT` set to it.
+
+## Colleague
+
+Colleague can explain where Vibe64 keeps things and which tools it uses, and can
+open **Health** to check them. Installing tools, moving folders and restarting
+Vibe64 happen in your own terminal; Colleague cannot run them for you.

package/docs/colleague-usage/sessions.md

@@ -1,14 +1,22 @@
 # Create and switch sessions
 
 Use **New session** (+), or **Create session** when there are no open sessions,
-to open **Start an AI session**. Choose an available orchestrator, review any
-branch choice, then select **Create session** (or **Create branch & session**).
-While **Creating session…** is shown, the dialog shows a progress bar and
-explains that it is copying the project source. It stays open: clicking outside,
+to open **Start an AI session**. It lists **Claude Code** first, then **Codex**,
+then **OpenCode**, and preselects the first available one. Choose an available
+orchestrator, review any branch choice, then select **Create session** (or
+**Create branch & session**). While **Creating session…** is shown, the dialog
+shows a progress bar and explains that it is copying the project source. It stays open: clicking outside,
 pressing Escape, Close and Cancel cannot dismiss it. On success it closes and
 opens the new session. If creation fails, review the error and retry or dismiss
 the dialog. This works the same way on desktop and mobile.
 
+On a phone the session's header controls (**New session** (+), a local
+project's Git branch button and the session's GitHub account) sit beside the
+project name while the chat pane is shown. With Preview or Dashboard shown they
+make room for that pane's controls; choose **Show chat** to reach them again.
+On a phone the GitHub account shows only its GitHub icon; on a computer hover
+it to see which account the session's GitHub commands run as.
+
 For a project with connected projects, the dialog closes once the session's own
 source is ready. The session then shows **Preparing workspace…** while Vibe64
 prepares the connected projects together, naming those still in progress (for
@@ -83,34 +91,18 @@ address. If the error persists, report the project, session and exact error.
 On phones, open the chat pane to find the same control. Colleague can explain
 recovery and open the session; the person selects **Reload chat**.
 
-## Working and Learning session navigation
-
-The prepared mode filter uses the same session tabs and chat panel for Working
-and Learning sessions. Older sessions without a purpose remain Working. Hiding
-a session from navigation preserves its running work, mounted conversation and
-draft; it does not stop or archive anything. A selected session of the other
-purpose is hidden without opening a different session automatically. The yellow
-**L** plate in the app header switches the filter (see
-[Choosing lessons and Learning conversations](learning-mode-ui.md)). The filter does not create a lesson, authorize an
-attempt or turn an ordinary session into a teacher. Desktop and mobile use the
-same navigation contract. Colleague can explain the mode; changing it does not
-authorize starting or ending a lesson.
-
-Each mode remembers
-its own selected conversation. A Working conversation that finishes opening
-while you view Learning stays with its original project and does not replace the
-lesson you are viewing. Switching modes preserves hidden conversations and
-unsent drafts; it does not stop their work.
-
-If Learning updates fail temporarily, the last confirmed lesson conversations
-remain visible. Wait for a successful refresh before selecting another lesson.
-If access is denied or your account changes, another learner's conversations
-must not remain available. If a conflicting-conversation error appears, retain
-your work and ask the owner to inspect it. Colleague can explain these states;
-it cannot grant access or repair saved identities. Ordinary **New session** and
-**Archive session** are Working operations, not ways to start or end a lesson.
-These rules apply on desktop and mobile. Start, resume and end lessons through
-Learning → **Courses** and Colleague instead.
+## Lessons and session navigation
+
+The session tabs and chat panel list the project's ordinary sessions. The **L**
+button opens the Learning environment above the page without changing the
+selected session (see [Choosing lessons and courses](learning-mode-ui.md)).
+
+A lesson's practice sessions are ordinary sessions of its practice project and
+appear with its other sessions. **New session** and **Archive session** are
+ordinary session operations, not ways to start or end a lesson: start, resume
+and end lessons through Learning → **Courses** and Colleague. Colleague can
+explain this; it cannot grant access or repair saved identities. These rules
+apply on desktop and mobile.
 
 ## Keep the fresh session's link after renewal
 
@@ -233,7 +225,7 @@ the reported error; it cannot grant another learner's access or silently replace
 the saved lesson with newer content.
 
 Start such a lesson from Learning → **Courses** (see
-[Choosing lessons and Learning conversations](learning-mode-ui.md)); the ordinary
+[Choosing lessons and courses](learning-mode-ui.md)); the ordinary
 **New session** control still creates a working session with source.
 
 ## Pin a source session

package/docs/colleague-usage/teaching-content.md

@@ -11,25 +11,11 @@ The internal orientation check reads the lesson's exact installed check and runs
 it against the current App server. It does not run a mutable copy from the
 learner's project and is not a Colleague shell tool. A successful check confirms
 only that server's matching button response; the lesson still requires the
-learner's own observed interaction and explanation before assessment. If the App
+learner's own observed interaction. If the App
 restarts or the response expires, repeat the actual button interaction. If native
 execution cleanup is uncertain, report that failure for operator recovery rather
 than claiming success or resending an old observation.
 
-Opening or minimising Colleague during workspace-navigation is ordinary chat
-use, not an assessment step; it preserves the question and accepted steps. Only
-return-to-Colleague collects actual minimise/restore gestures. After its saved
-pass is confirmed against the native accepted-answer and evaluation receipt,
-normal launcher use no longer arms that completed question, including after a
-restart. Explicitly requested practice uses a new delivered question; earlier
-passes stay saved. Unconfirmed current tasks still require the original order.
-Continue project → Main coding conversation → Preview under the same question.
-
-On a phone, after minimising Colleague, **Show project** counts as the workspace
-step when it reveals the selected **Preview**. Reopen Colleague with its dedicated
-avatar launcher under the same pending question. Dashboard, automatic attention,
-swipes and programmatic navigation do not create Preview evidence.
-
 A lesson version must remain pinned to the content the learner started. If its
 content is reported missing or invalid, ask the workspace owner to restore that
 exact verified revision. A newer bundle or a draft is not a substitute for the
@@ -55,16 +41,9 @@ loader, and leaves placement to the existing Preview host. It does not by itself
 authenticated learner control, a Colleague tool or saved learner progress. Colleague
 must not claim an animation played or obtain controller source or screenshots.
 
-In a prepared lesson, the Preview host saves the real diagram's semantic state
-after a completed command or a confirmed pause. Reopening that same attempt
-restores its last confirmed state, paused flag and labels into a new player; it
-does not replay motion, narration or a completed cue. Snapshot reads alone save
-nothing. If **Retry diagram checkpoint** appears, retry the retained exact save.
-**Save current diagram** captures a fresh state after a rejected revision conflict.
-Keep the diagram open until confirmation; a hard reload can recover only the last
-confirmed checkpoint. These saves preserve the question and earlier assessments,
-and never grant a pass. If a concurrent assessment conflicts, read its saved
-result and retry its existing operation with the current revision.
+A lesson diagram plays from its beginning with **Play** in the Learning
+environment; diagram states saved by earlier-format lessons stay in the lesson
+record.
 
 The application also has a server-side verified-snapshot installation facility.
 For official catalogue courses it is reached through **Install** and **Update**
@@ -140,25 +119,20 @@ neither catalogue failure nor publishing a newer release resets the reservation.
 An unconfirmed catalogue save requires reading its actual current revision before
 the owner deliberately retries. It is not evidence that enablement changed.
 
-The private lesson record can now retain a pending question, teaching position,
-diagram state and assessment results for the saved lesson version. These storage methods alone add no
-quiz/start/resume control or Colleague grading tool. A pass requires an admitted actual learner answer or a native
-practical observation tied to that learner's prepared project/session. An assistant
+The private lesson record retains step results, the reader position and, for
+earlier-format lessons, their assessment results for the saved lesson version. Colleague has no grading tool. A pass requires the
+learner's own step action: a choice answer, **Done** on a self-check step,
+**Mark as done** on a reading step, an
+automatic check tied to that learner's practice project, or **Check my work**
+on a review step (the learner's own AI reviewing their practice work against
+the author's rubric; Colleague can read that work with `step.evidence.read`
+but never runs a review). An assistant
 paraphrase, demonstration or animation is not evidence of a learner pass. Completion
-requires every required pinned assessment to pass; preparation alone does not count.
+requires every required pinned step (or, for an earlier lesson, assessment) to
+pass; preparation alone does not count.
 Colleague can explain this boundary and offer supported assistance, but cannot
 assert trusted observations, fabricate results or erase history by retrying.
 
-After starting or resuming, Colleague must read the fresh teaching brief, recap
-its exact pinned passed and remaining assessment IDs, and normally continue a
-remaining task. The saved `resume.pendingQuestion` is the last checkpoint; it may
-belong to an assessment that already passed. Explicitly requested practice or
-reassessment remains supported and keeps the earlier pass. A request to resume,
-open the project, inspect setup or navigate is not an answer to grade. A fresh
-conversation must prepare and actually deliver its next question before assessing
-a new learner answer; it cannot reattach old messages or infer missing provenance.
-These read-only progress facts preserve the checkpoint, visual state and history.
-
 If a future result/resume save is unconfirmed, read or retry its exact submission
 or current checkpoint identity. A changed revision requires reading current state
 before another write. A reused evidence reference or conflicting identity requires

package/docs/colleague-usage/temporary-chats.md

@@ -14,6 +14,24 @@ Ordinary temporary chats offer **Custom**, **Senior** and **Junior**. Choose
 an available connection and model, then **Apply**. The next message uses that
 choice and the existing conversation history. Main chat's selection is unchanged.
 
+## Rename a temporary chat
+
+New temporary chats are named **Temporary 1**, **Temporary 2** and so on. Each
+number is given once, when the chat is created, and is not reused while the
+session keeps that chat; closing a chat or reloading does not renumber others.
+
+To rename a chat, select its tab, then select the pencil (**Rename …**) beside
+its name. Enter a name of up to 80 characters and select **Rename**, or press
+Enter. Line breaks and extra spaces become single spaces. Leave the name empty
+to return to its numbered name. **Cancel** or Escape keeps the current name.
+The new name is saved immediately, survives reload and appears in the session's
+other open tabs. Renaming works while the assistant is working and does not send
+a message or change the conversation. The pencil appears only on the selected
+tab, on desktop and on a phone.
+
+Colleague can rename a temporary chat through its temporary-conversation update
+action when you ask it to.
+
 ## Send and steer
 
 Temporary chat uses Main's round Send arrow and square Stop control. While a
@@ -29,8 +47,9 @@ so other viewers and a later reopen see them with their actual timing.
 The same controls remain available in narrow layouts. Goals are not offered in
 Temporary chat.
 
-Steering can interrupt an unfinished reply. Any partial reply remains attached
-to its original request; the follow-up response belongs to the new request.
+Guidance sent to a working Claude chat does not interrupt it: Claude reads the
+guidance after its current command finishes. Output already shown remains
+attached to its original request; the follow-up response belongs to the new request.
 Reloading the chat preserves that relationship and the recorded AI labels.
 After **Stop** confirms a Claude reply has stopped, text already shown remains
 under **Show all … progress updates** on its original request. It is an
@@ -107,6 +126,8 @@ again; do not resend a message whose delivery is uncertain.
 A temporary chat opened in one browser tab or window appears in the session's
 other open tabs once it is saved, which happens when it is created or its first
 message is sent. A tab that lost its connection catches up when it reconnects.
+Every open tab shows the same progress: when the reply arrives, “AI is working…”
+clears in each tab, including tabs that did not send the message.
 
 Leaving the view does not stop work or close a chat. Use **Stop** to interrupt
 work while retaining the conversation, or **Close** to remove that chat after

package/docs/colleague-usage/voice-chat.md

@@ -50,8 +50,9 @@ Main's microphone and speaker controls sit with the expanded face, outside the
 original message buttons. Before speech is connected, the speaker button opens
 Main's speech connection and changes spoken replies without recording.
 Main defaults to spoken replies on when no choice is saved; Colleague defaults
-off. An explicit saved choice takes precedence. In Vibe64 Online, the speaker
-choice is personal and separate for Colleague and coding assistants. Both idle controls stay available while
+off. An explicit saved choice takes precedence. A host with saved speech
+preferences keeps the speaker choice personal and separate for Colleague and
+coding assistants. Both idle controls stay available while
 Talk is connecting. The fourth small round button, the minus after microphone,
 speaker and settings, tucks away the face; speech continues. The collapsed anonymous icon in the
 top-right corner is **Show avatar** and restores it. While hidden, a passive
@@ -159,14 +160,8 @@ Open voice for a different conversation to switch. Unfinished words require
 completion or **Discard and switch**; **Stay here** keeps the original target.
 There is only one voice window and one active capture/playback owner.
 
-On installations with speech configured, a source-less Learning conversation
-uses Main's same microphone, spoken replies and review controls; it does not
-require an invented project. Its voice target is labelled **Lesson** and the
-actual conversation name. Capture stays attached to that person's saved attempt
-and conversation. Switching attempts does not resend or redirect words. Reading
-lesson history does not authorize new teaching work: each Send still checks the
-current saved lesson and access. Without a speech service, use the same typed
-Main conversation; voice availability is optional.
+Lessons have no voice of their own: use Colleague's voice to learn with a
+lesson.
 
 Signing out, losing access to the target, or leaving the page releases its
 resources. A project agent remains the selected voice target even if its text

package/docs/colleague-usage/voice-face-and-speaking-voice.md

@@ -6,7 +6,7 @@ This is part of [Voice chat with Colleague or a project agent](voice-chat.md).
 
 Colleague and the project agent show an illustrated face that blinks, moves and
 animates its mouth while listening, thinking and speaking. Colleague starts with
-**Merc · male**; project agents, including the Learning teacher, start with
+**Merc · male**; project agents start with
 **Yu · female**. To change one, open that assistant's **Voice settings** cog
 beside the microphone and speaker controls (below its face when expanded) and
 choose **Avatar**. Colleague and project agents keep separate choices. A project
@@ -25,13 +25,11 @@ Open the same **Voice settings** cog and choose **Speaking voice**.
 Opening settings loads the installed choices without recording. The
 change applies to the next spoken reply. In standalone Vibe64 it lasts for the
 current voice session; a host with saved speech preferences can replace this
-selector and retain the choice across sessions. Vibe64 Online saves your avatar
-and voice personally, separately for Colleague and coding assistants across
-projects. Its Management → **Speech and Colleague** page changes only the shared
-Colleague name; use each assistant's cog for your own avatar and voice.
-The personal cog's **Speak replies** choice controls output for that target.
-In Vibe64 Online, older browser-only speaker choices are not copied into personal
-settings; check **Speak replies** when first using your personal controls.
+selector and retain the choice across sessions, saving your avatar and voice
+personally, separately for Colleague and coding assistants. On such a host the
+personal cog's **Speak replies** choice controls output for that target; check
+it when first using your personal controls, because older browser-only speaker
+choices are not copied into personal settings.
 While that choice saves, the speaker control briefly waits; microphone capture
 and typed chat remain available.
 For coding assistants, **Read thinking**, **Read progress** and **Thinking sounds**

package/docs/colleague-usage/voice-recovery.md

@@ -40,11 +40,12 @@ started speaking, including after navigation or a failed-send retry. The normal
 default still sends completed speech automatically, and input and playback stay
 independent. There is no new settings control for this retained choice.
 
-Online waits for your saved settings before opening a new voice target. An existing
+A host with saved speech preferences waits for your saved settings before
+opening a new voice target. An existing
 voice target stays owned while those settings load. If loading fails, retry opening
 voice or use typed chat; your words are not automatically submitted. Reopening an
 already active target does not add a new microphone readiness gate.
 
-A temporary Online settings refresh error keeps an already loaded saved review
+A temporary settings refresh error keeps an already loaded saved review
 choice for the same account. It does not silently switch that active microphone
 to automatic sending. A new voice target still waits for its settings to load.