Repository navigation
docs: represent shipped capabilities in README and manual - #6915
AgentWrapper wants to merge 19 commits into
Conversation
Lead with the orchestrator agent, PR loop and AO review; document artifacts, side chats, Tab suggestions, Stay Awake, themes, accounts, mobile fleet and Remote hosts; fix stale agent counts and npm version; add remote-host, render, session top and spawn --output to the CLI docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🏆 Review leaderboardOct 12–19, 2026 · UTC
Ranked by distinct external PRs reviewed, then review rounds, then PR comments. Self-activity and bot activity are excluded. Show 8 more reviewers
|
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head 85eb399. Checked against the code, most claims hold:
- the Open orchestrator shortcut ⌘⇧O / Ctrl+Shift+G (
frontend/src/shared/shortcuts.ts) - the board zones Working / Needs you / In review / Ready to merge
- 20 palettes in
packages/shared/theme/palettes.ts - Stay Awake is its own settings section
ao remote-host status|enable|disablewith mutually exclusive--tunnel/--tunnel-onlyao session top,ao spawn --effortand--output artifact- codewhale is Terminal-UI-only, so its catalog row is correct
- npm
latestis 0.10.3
Two blocking issues (inline): side chats are documented as a plain General setting but are a Developer-mode experiment, and the new ao render section leaves out the required --title.
Optional, non-blocking: the mobile "several computers" and "same color themes" claims cite PRs only. I could not check them against the mobile source in this pass, so confirm they are in the released mobile build before merge.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…sage Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head 6f2ffb9 (new: the Cloud guide rewrite). These new labels match en.json: Developer mode, the Cloud toggle with its Enable Cloud confirm, the sidebar AO Cloud sign-in, Settings → Updates → Updates channel / Nightly (Pre-release), Clone to the cloud, and Cloud sandbox provider. Two new blocking issues: Cloud is described as nightly-only, but stable ships it; and the billing page is labeled Upgrade, not Billing.
The three findings from review 5567121227 (side chats need Developer mode, twice, and ao render needs --title) are not addressed in this head and have no replies, so they are posted again inline.
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head 6dff7a6. The three earlier findings are fixed and match the code: side chats are now a Developer-mode preview in the dashboard and README (developerMode && sideChats), and ao render documents the required --title plus --height/--artifact and the check-only --width/--out (render.go). Dropping the unverified mobile color-themes claim is also good.
The two Cloud findings from review 5567152222 are not addressed in this head and have no replies, so they are posted again inline: Cloud is described as nightly-only although stable v0.14.2 ships it behind Developer mode, and the billing page is labeled Upgrade, not Billing.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head 5d5b117. The nightly finding is fixed. The Cloud guide intro, step 1, the troubleshooting row, the FAQ, the dashboard and the docs index now describe Cloud as a Developer-mode preview in current stable and nightly builds, which matches the code. Side chats and ao render were fixed earlier.
One finding from reviews 5567152222 and 5567159527 is still unaddressed and has no reply, so it is posted again inline: the billing page is labeled Upgrade, not Billing.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head 45341df. The new "available now in the latest nightly" lead-in is accurate, and the intro still says current stable builds include Cloud too. The section renames (Get started, Troubleshooting) are fine, and the one in-repo link to the old anchor was updated to #get-started.
One finding is still unaddressed after three reviews (5567152222, 5567159527, 5567174534) and has no reply, so it is posted again inline: the billing page is labeled Upgrade, not Billing. It is the only thing blocking approval.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head d987f60. Fixed: the billing page is now Settings → Upgrade. The Limits section matches the usage view. Three new blocking issues (inline), the same as on #6912: the GA claim contradicts the in-app Enable Cloud warning, Bring your own Coder is listed under Pro but is an Enterprise feature, and the plan limits are not the dimensions the app enforces or displays.
Optional, non-blocking: the app's Free card lists "Claude Code, Codex and Cursor" while the table says "any supported harness".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head b2ece7f (new: prices plus device and connectivity tiers in Plans and the FAQ). The three findings from review 5567235665 are unchanged and have no replies, so they are posted again. A fourth is new: the device and relay tiers contradict the Upgrade page and the remote-access docs. If these come from a product decision that the app has not caught up with yet, reply on each thread and link the app change.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Approved. Reviewed head 802fb7e, which merges main including #6907. The Plans table now matches the app: Coder on Pro, cloud projects and simultaneous cloud agents, Free with 2 devices and no relay, Starter with relay and unlimited devices, Enterprise unlimited, so the plan findings from review 5567256527 are resolved by the app. The Free row keeps free remote access via Tailscale or the managed tunnel, and the sandbox caution is restored.
The nightly-preview markers in 8a81e32 match stable v0.14.2. The Open orchestrator shortcut, Stay Awake, spawn --effort and artifact version history are all absent there. Features left unmarked are all in v0.14.2: side chats, 20 themes, ao render, session top, remote-host, spawn --output, Tab suggestions and codewhale.
Non-blocking notes:
- "Generally available" (guides/cloud.mdx L6) still disagrees with the in-app Enable Cloud dialog ("early, highly unstable preview ... Only enable it if you are actively testing") and the Developer mode gate. Fix that dialog in a follow-up app PR.
- The $20 and $40 prices come from Stripe at runtime, not the repo. Keep them in sync.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head 508e8cd. The early-preview wording in the Cloud guide and the docs index now agrees with the in-app Enable Cloud dialog. One new blocking issue (inline): the new pricing link is a 404.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Changes requested. Reviewed head ad3f69d. The relay is now marked coming soon in the Plans intro and the Starter row, consistent with the code. One blocking issue remains: the pricing link is still a 404 (inline).
Non-blocking: the 1/1 and 5/15 limits come from Stripe at runtime and are not in the repo, so I could not verify them. Keep them in sync.
…aitlist Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Approved. Reviewed current head a38fe69 (the queued 3fafbb8 plus one follow-up). The dead pricing link is gone from the Cloud guide. The waitlist link resolves (200). The Cloud guide intro, FAQ and docs index use neutral availability wording with the real Developer mode, then Cloud, steps and the sandbox caution. The unenforced 2-device limit is dropped from Free. The plan figures come from Stripe at runtime and are not verifiable from the repo, so keep them in sync.
AgentWrapper
left a comment
There was a problem hiding this comment.
Approved. Head a38fe69 is unchanged since review 5567371053, which approved this exact commit. Rechecked: the waitlist link still returns 200. No new findings.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Approved, with a merge gate. Reviewed head 55ec70a. The Cloud guide Plans table drops the relay and device claims except the coming-soon relay note on Starter, consistent with the code. The waitlist link returns 200.
Merge gate: https://orchestrator.inc/pricing still returns 404 as of this review. Do not merge until landing PR #64 publishes it and the URL returns 200; if #64 slips, drop the link.
AgentWrapper
left a comment
There was a problem hiding this comment.
Approved, with a merge gate. Head 55ec70a is unchanged since review 5567410053, which approved this exact commit. No new findings. Merge gate (still applies): https://orchestrator.inc/pricing still returns 404 as of this review. Do not merge until landing PR #64 publishes it and the URL returns 200; if #64 slips, drop the link.
…/dont-undersell # Conflicts: # frontend/src/docs/content/cli.mdx
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper
left a comment
There was a problem hiding this comment.
Approved, no changes needed. I checked the two new commits since 55ec70a against the v0.14.4 tag, which is a stable release, not a prerelease, published 2026-10-21. Every former nightly-only feature is in the tag, and I found no nightly gate on any of them:
- Open orchestrator shortcut:
shared/shortcuts.tsbinds ⌘⇧O on Mac and Ctrl+Shift+G elsewhere. - Stay Awake:
AwakeControl.tsxandservice/awake. spawn --effort: incli/spawn.go.- Artifact version history:
useArtifactVersions. - SVG, audio and video previews in Files:
SvgFileViewandFileMediaPreview.
The per-folder accounts wording keeps its Developer mode requirement, which is right.
Merge order: merge #7027 first or together with this PR. The README table and the plugins/agents catalog on this branch still list 36 agents with no memcode row, so the new "37" claims only match once #7027 lands.
The pricing gate is cleared: https://orchestrator.inc/pricing returns 200 now.
Summary
This is the "don't undersell" pass on the README Product highlights section and the docs manual (
frontend/src/docs/content). Each capability below was checked against code onmain; the evidence is listed further down. It's a follow-up to #6912, kept separate because it touches seven files. The two branches merge cleanly in either order.AO Cloud: updated per the founder's decisions and checked against the code. Cloud is generally available (anyone can sign in), the gating language is removed, and the Cloud guide has the real getting-started steps plus a Plans table (Free $0, Starter $20/month, Pro $40/month, Enterprise custom, matching
settings.billing.*). The Starter cloud relay is listed as a plan feature only. It is not a connection option inremote-access.mdx: no relay endpoint exists in code yet (the daemon advertises only lan, tailscale and tunnel). See Docs · Cloud below.Before → after claims
README · Product highlights (new list above the screenshot table)
Docs · Introduction (
index.mdx)Docs · FAQ
0.10.0is its final release and it will not receive updates" (wrong: npm has 0.10.3). After: "it trails the desktop app: its latest release is0.10.3." I left out any statement about future npm releases until the founder decides.Docs · Quickstart
Docs · Dashboard (main feature page). Before, none of these were described. Added:
/btwand/side, native forks with a reconstruction fallback, not kept across app restartsao spawn --output artifactSettings line:
Docs · Cloud (
guides/cloud.mdx, plus mentions in the introduction, Dashboard and FAQ)settings/service.goCloudEnabled= (Cloud toggle orAO_CLOUD_OFFERING) and a control-plane URL.config.godefaults the control-plane URL tohttps://api.aoagents.dev.GeneralSettingsSection.tsxshows the Cloud toggle only in Developer mode, with an "early, highly unstable preview" confirmation.HarnessSettingsSection.tsxhas the Cloud segment.TaskComposer.tsxrejects Cloud attachments.self_serveincloud/internal/config.Docs · Cloud GA and Plans (founder update, 18 October 2026)
guides/cloud.mdx:settings.billing.*after fix(billing): show plan limits apply only to cloud agents #6907). Prices are founder-confirmed: $0 / $20/month / $40/month / Custom. Free lists 2 devices on the same network (no cloud relay). Starter lists the cloud relay and unlimited devices, as on the app's plan cards. Plans are chosen in Settings → Upgrade (the actual nav label, not "Billing"), and Enterprise uses Talk to founder.remote-access.mdx, because no relay endpoint exists in code yet.Docs · CLI reference
remote-host,renderandsession top. After: all three are in the tree, with new sections forao remote-hostandao render <file.html> --title <name>(--titleis required), and a row forao session top.ao spawnflags: added--effortand--output artifact.Docs · Agent catalog
codewhalewas missing even though it ships in v0.14.2. After: 36 rows.Nightly markers removed (21 October 2026)
Every feature this PR earlier marked "nightly preview" now ships in stable v0.14.4. Checked with
git merge-base --is-ancestor <commit> v0.14.4:ao spawn --effort, memcodeSo the README and docs describe them as shipped, with no "nightly" wording. Per-folder accounts are still labeled a Developer mode preview, because v0.14.4 still gates them behind Developer mode.
Verification
frontend/src/shared/shortcuts.ts(#6854)configuration/lifecycle-automation.mdx, built-in rulesusing-aoreview guide,ao review trigger --agentmainalso hasmemcode(#6515, nightly only), not counted yet.SessionChatSurface.tsxhas no setting gatelib/side-chats.ts(developerMode && sideChats); #6481, #6616SessionArtifactsView.tsx(HTML opens in Browser)AwakeControl.tsx(isMacPlatform),StayAwakeSection.tsx, #6838settingsCatalog.tsxpackages/shared/theme/palettes.ts,GeneralSettingsSection.tsxpackages/mobile/app/settings/environments.tsxremote-host,render,session top,--output,--effortbackend/internal/cli/*Tests
npm ci && npm run buildinfrontend/src/docspasses, and the new Dashboard and CLI sections render.Known gaps / follow-ups
memcode(feat: add memcode TUI harness with verified native restore #6515) is registered onmainand in nightly, but isn't in the README table or the docs catalog yet. Add it with an icon once it reaches stable; the counts then become 37.🤖 Generated with Claude Code