Skip to content

Onboarding: a cinematic first run, agents installed in the app, file access that comes to you - #48

Open
MasterYoav wants to merge 16 commits into
masterfrom
onboarding
Open

MasterYoav wants to merge 16 commits into
masterfrom
onboarding

Conversation

@MasterYoav

Copy link
Copy Markdown
Owner

A first-run onboarding: full window and cinematic, one idea per screen (spec).

The flow (progress dots, Back / Continue / Skip, ← →, Help › Welcome Tour to see it again):

  1. Welcome: the crew walks into the village at dawn.
  2. Your agents: Claude Code, Codex, Antigravity and GitHub Copilot, each found or not. Install runs the official installer and Sign in the CLI's own login, both in a terminal inside the sheet; then xBot looks again and the card turns green.
    • Claude Code: curl -fsSL https://claude.ai/install.sh | bash, claude auth login
    • Codex: curl -fsSL https://chatgpt.com/codex/install.sh | sh, codex login
    • Copilot: curl -fsSL https://gh.io/copilot-install | bash, copilot login
    • Antigravity: curl -fsSL https://antigravity.google/cli/install.sh | bash, then agy signs in
      3–7. Animated scenes: projects and chats (a reply streaming), plans (unfold, reorder, tick off), changes, files and a terminal, the crew as a company (a CTO hired, work handed down and reported back), notes, abilities and automations.
  3. Files: Allow makes macOS ask for Desktop, Documents and Downloads right there; Or give Full Disk Access opens that pane and docks a floating guide beside System Settings (drag xBot in, an animated switch), notices the grant and brings xBot back.
  4. Your iPhone (optional): the pairing QR, with the same single-use rules as Settings › Devices.
  5. Make it yours: the world and light/dark.
  6. Ready: "Ask HeadMaster anything", then Home with the composer focused.

Skipping leaves a Finish setting up row on Home. Libraries that already have chats or projects aren't sent through it.

Verified: 521 package tests (48 new: model, agent setup and installer, sign-in checks, file access, guide docking); every step walked in a sandboxed debug build and checked on screen (fixed: scene size, a stage card for every scene, clipped scenes, the world names, Ready's layout); the guide panel docked beside System Settings; the install sheet with a harmless fake command. Not verified: a real install or sign-in (nothing was installed), Reduce Motion in the live app.

…me reminder, existing libraries count as done
…isk Access detection and polling, behind a probe
… › Welcome Tour; Home's Finish setting up row
…dy centred, close-only guide panel); a debug-only fake command to look at the install sheet
One clock per scene (30 fps TimelineView that stops under the motion gate and
never starts under Reduce Motion, which draws the final frame), easing as
functions of time, a stage that scales a 720x420 composition to its room, the
founding crew's looks, a mock xBot window, the world's balloon and name tag.
Welcome (the crew walks into the village at dawn and greets; the mark settles),
Crew (HeadMaster on top, a CTO jumps onto the tier below, Forge and Hawk walk
in; a task travels down and Done comes back up), Worlds (five living
postcards) and Ready (the crew gathered, a warm light, one hop each).
A mock xBot window: a folder drops in as a project, a tab opens, tool rows fold
into one line and the reply streams in; a plan unfolds, a step is dragged up
and the steps tick off; the inspector slides in with changes, a diff line
turning green, a terminal running swift test and a pull request's checks.
Three cards flip in (a note writing itself, connectors switching on, an
automation snapping together under a clock); Desktop, Documents and Downloads
turn from locked to allowed in turn; a Mac draws its pairing code, an iPhone
slides up, scans it and a pulse travels between them.
DEBUG only. XBOT_SCENE_SIZE=WxH sets the scene's size (default 720x420). The
RootView change is the marked #if DEBUG branch at the top of body.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant