[devswha]

Change

Docs only: docs/guide.md now matches what 0.4.20 and current main do. I checked each claim against the code that decides it (file:line in the table below) and changed only docs/guide.md.

• Letta Code. The Supported agents cell is short now: it says what Letta needs (herdr integration install letta) and that a turn shows once it ends, with Working… in the meantime. The binding rules moved to a new Letta Code subsection at the end of the section, which also says what a running turn looks like and lists the three known wrong-conversation cases of Letta Chat: bind a pane from a fact Letta or herdr reports, not from per-folder state #2314.
• Subscription usage. Expired Claude and Codex accounts get Sign in again. Hub accounts do not.
• Chat. The faded bubble a sent message shows until its turn is written: the clock after 5 s, the bubble gone after a minute, no bubble for /… and !… commands. Also the Claude Code bash-mode (!) card, with stderr in red.
• Terminal. xterm.js 6 draws only whole frames, and Alt speeds the wheel in a program that reads the mouse.
• Voice input. On a touch screen with the browser's own recognition, you tap to start and tap to finish. An iPhone home-screen app asks for the mic on the first tap, not when Voice input is turned on. When Siri & Dictation is off, the mic says so. A mouse, or an API key, still allows hold-to-talk.
• Quick start. On a slow link, the boot spinner shows while the app downloads.
• Manage sessions. The Ultracode switch in New workspace and New tab, linked to agent-commands.md.

The OpenCode drag text (#2368) was already accurate, so it is unchanged. The agent install flow (changelog.d/agent-install-run.md) is left out: AgentSetupCard is not mounted anywhere yet, so users have no surface for it.

Claim	Code
Letta writes a turn only at its end; cancelled turns are never written	server/letta.ts:1-12
Letta binding: herdr report + project record + start folder	server/letta-store.ts:1-19, lettaRecordOwned :247-258
Working… while a turn runs, no live terminal box	src/components/ChatView.tsx:2265-2277; #2338
Sign in again: expired, Claude/Codex, not hub	src/lib/usage.ts:83; UsageMeters.tsx:55-66; UsageSettings.tsx:40
Faded bubble 5 s clock / 60 s / no bubble for commands	src/lib/sentWaiting.ts (WAITING_HINT_MS, WAITING_SEND_MS, becomesTurn)
xterm.js 6; Alt-only fast wheel	package.json @xterm/xterm 6.0.0; patch per #2357
Touch + browser engine = tap; hold otherwise	src/components/VoiceInput.tsx:258-300
Siri & Dictation off is named	src/lib/voice.ts:302-303; VoiceInput.tsx:22
Boot spinner	index.html:40
! card, stderr in red	server/claude-transcript.ts:94-95; ChatView.tsx:1079-1088
Ultracode switch, Claude Code 2.1.284+	src/components/NewSessionDialog.tsx:398-402

No changelog fragment: each behaviour described here already has its own changelog entry, in 0.4.20 or in changelog.d/, and this PR only brings the guide up to date with them.

Verification

• bun run check fast: green on b16eabc (typecheck, build, generated files, 8666 unit tests pass, 0 fail). Also green on 0d8db7e and d2527fe.
• No test: this is a prose-only change (repo rule: doc text is never pinned by a test).

Reviews

• omo-native-code-reviewer on 0d8db7e: APPROVE, no CRITICAL/HIGH/MEDIUM. Its 5 LOW points were checked against the code and applied in d2527fe: Alt speeds a trackpad wheel; Ultracode's prerequisites; the faded bubble only in a native-session chat; the first Letta Chat: bind a pane from a fact Letta or herdr reports, not from per-folder state #2314 case needs Ovis not to have looked first; the iPhone home-screen mic rule is its own bullet.
• Codex Sol 6.1 fast xhigh, round 1 on 0d8db7e: REQUEST CHANGES with 5 MEDIUM. All five were checked against the code and fixed in d2527fe:
  • Letta: a second pane, or a turn not yet written, clears by itself, without restarting letta (letta-store.ts:195,288).
  • The bubble's clock means the turn is not written yet, not that the agent has not taken it (sentWaiting.ts).
  • xterm.js 6 waits for a synchronized frame for up to a second.
  • The Ultracode switch only asks Claude Code, which ignores it without xhigh and dynamic workflows (agentLaunchMode.ts).
  • Silence is trimmed only where the recorder can pause; otherwise the whole recording is sent (voice.ts:613-620). This was a stale sentence next to the touched text.
    LOWs applied: start letta once before herdr integration install letta (agent-catalog.ts:875); the 2 s record margin; 401/403 also read as expired (usage.ts:1052); the voice level shows only when the server transcribes (voice.ts:491).
• Codex round 2 on d2527fe only: one MEDIUM. A Letta pane in the home folder never binds (letta-store.ts:255), so "until letta starts again" was wrong there. Fixed in b16eabc with Codex's own wording. Under the review cap, there is no further round.
• Left as written (LOW): Codex noted that "rare" for the Letta Chat: bind a pane from a fact Letta or herdr reports, not from per-folder state #2314 cases is a judgment, not something the code shows. Each case needs a Letta folder move plus a conversation switch Ovis did not see, which is why the guide calls them rare.

Docs only, so no CodeRabbit review is requested (AGENTS.md: a docs commit gets none).

[coderabbitai]

Caution

Review failed

The pull request is closed.

Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[devswha]

Merging b16eabc. Docs-only (docs/guide.md): the guide now matches 0.4.20 and current main: Letta chat and its limits, Sign in again, the waiting bubble, xterm 6 and the Alt-only wheel speed-up, iPhone tap dictation, the OpenCode drag, the boot spinner, the ! command card and Ultracode. The lane checked each claim against the code; the merge pass read the diff and found no feature still held in an open PR documented. Docs-only, so the Native Windows install job is skipped and no CodeRabbit review was needed.