---
title: "Introducing Onboarding: one member chat to start a mind"
summary: "A focused page for the mind’s owner to ask for help, using the same durable agent runtime as the main workbench."
created: "2026-11-15"
updated: "2026-11-15"
revision: "1"
previous: ""
reviewedThrough: "b0b2ed37708d39699ee3007262c65b822b04790b"
sourceDigest: "5ee64e539ed96dda75838d966b136e847ef33fdf9477f9f39123af23739d362e"
---

With this, your mind can greet a new member with one conversation instead of a catalog of unfinished agents. The page removes navigation choices, not security checks or the agent’s privileges. It is for members of this mind, not public account signup; the public install wizard is a different app with a different authority model.

## One fixed thread

`apps/onboarding/app.ts` exports an app factory like the other member apps. In the publication hook, its `install` calls `itx.agents.create` for the fixed `/agents/onboarding` path. Creating an already existing agent is harmless and creating it does not start a model turn. Every member who opens the page sees the same thread; this is not private storage per person.

```ts
// Publish hook, after the Agents runtime is installed:
await onboarding.install(itx);
// Host dispatch:
case "onboarding":
  return onboarding.open?.(request) ||
    this.auth.require(request) || onboarding.fetch(request, this);
```

`index.html` and `public/app.js` provide the chat and `public/app.css` its styling. The guarded `/itx` socket is `host.auth.itx(request)`, just as in [Agents](/introducing/agents). The app also answers the shell’s session, one-mind and sign-out endpoints. A tiny shared `apps/open-files.ts` helper lets an allowlisted icon and web-app manifest load before authentication; it does not make chat assets or actions public.

## Instructions are code-adjacent, not pasted forever

The agent’s standing guide is `apps/onboarding/onboarding.md`. `apps/agents/backend.ts` selects that file for this agent and reads it afresh for model requests. Updating the guide changes the next answer without duplicating a long prompt into every message. The conversation remains in the agent’s durable context, so a member can leave and return.

## Adapting the pattern

Install the normal Agents runtime, choose a fixed agent path, point its standing files at a guide of your own, and build the focused member page using the same authenticated socket contract. This needs the mind’s normal model funding, not a new vendor account just for onboarding. Test repeat publication, an empty thread, a returning member, a signed-out visitor and a signed-in nonmember. Do not use an ordinary full-mind onboarding agent as an isolated public helper: [the install wizard](/introducing/cloud2) explains why its end-user chat has a jail and bounded tools instead. [The blog](/introducing/blog) keeps this recipe current when the app’s code changes.
