Skip to content

docs: state AO facts plainly for search and AI answers - #6912

Open
AgentWrapper wants to merge 22 commits into
mainfrom
ao/ao-discoverability/readme-mobile-faq
Open

AgentWrapper wants to merge 22 commits into
mainfrom
ao/ao-discoverability/readme-mobile-faq

Conversation

@AgentWrapper

@AgentWrapper AgentWrapper commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator

Latest Cloud wording (agent-orchestrator-401, 19 October 2026)

  • Status is neutral pending the founder's GA decision: "Orchestrator Cloud is available now in the desktop app (turn on Settings → General → Developer mode, then Cloud)". "Generally available" is not used. The factual caution about losing uncommitted work stays.
  • Prices: Free $0, Starter $20/month, Pro $40/month, Enterprise custom, monthly only. Links to orchestrator.inc/pricing, which landing Refactor: Replace magic strings with constants for status enums #64 publishes; 401 is making sure Refactor: Replace magic strings with constants for status enums #64 merges first. Plans are chosen in Settings → Upgrade.
  • The Teams & Enterprise waitlist is linked next to Enterprise and in the FAQ.
  • Cloud limits are the enforced ones: Starter has 1 cloud project and 1 simultaneous cloud agent; Pro has 5 cloud projects and 15 simultaneous cloud agents.
  • The cloud relay doesn't exist, so it's never presented as included. Free has no device count and no relay mention. Starter is "Everything in Free, plus cloud agents… Coming soon: a cloud relay for access across devices." remote-access.mdx has no relay row.
  • Agent count is now 37 (21 October 2026): memcode ships in stable v0.14.4. Exact counts changed from 36 to 37; "35+" is unchanged. The memcode table row is in docs: list memcode in the supported agents #7027, which should merge first or together with this PR, so the README never claims 37 while the table lists 36.

Summary

Makes the facts that search engines and AI assistants pull from easy to extract, with every claim checked against the code.

README.md

  • The first prose paragraph is now a plain-text summary: Orchestrator.inc (formerly Agent Orchestrator, AO; formerly github.com/ComposioHQ/agent-orchestrator), open source (Apache-2.0), Claude Code, Codex and 35+ agents, parallel agents in isolated git worktrees, an orchestrator agent that plans work and spawns workers, the PR loop that sends CI failures and review comments back to the owning agent, desktop on macOS/Windows/Linux, and iPhone/iPad/Android apps.
  • New Mobile and cross-device section with App Store and Google Play links. It covers pairing, how the phone connects (LAN, Tailscale, managed HTTPS tunnel), what the phone can do, desktop-to-desktop remote hosts (which need Developer mode), and AO Cloud. Founder decision (anyone can sign in), checked against the code: the README uses the framing "AO Cloud is available now in the latest nightly: sign in from the desktop app and run agents in the cloud", and adds that it's an early preview turned on in Developer mode. Current stable builds include it too (stable v0.14.2 and nightly both ship it; nothing checks the update channel), with its real enable steps (Developer mode, then Cloud, then sign in to AO Cloud). The only waitlist mentioned is the Teams & Enterprise waitlist at orchestrator.inc. The FAQ pricing answer uses the same wording and gives no Cloud prices. The docs index Cloud card also moved here; the rest of the Cloud docs change is in docs: represent shipped capabilities in README and manual #6915.
  • New FAQ section: license, supported agents (36 entries in the Supported agents table, stated as "36 (35+)"), platforms, mobile, pricing, and "formerly github.com/ComposioHQ/agent-orchestrator".
  • "Apache-2.0" now appears in visible text, not only in the badge.

AO Cloud and Plans (founder update, 18 October 2026)

  • Mobile section. Before: "available now in the latest nightly… Teams & Enterprise waitlist". After: "AO Cloud is generally available: sign in from the desktop app and run agents in the cloud…". The real enable steps stay in (Developer mode, then Cloud, then Sign in to AO Cloud).
  • New Plans section above the FAQ, mirroring the in-app Upgrade page (settings.billing.* after fix(billing): show plan limits apply only to cloud agents #6907):
    • Free: unlimited local agents, orchestrator, workers and PR reviews, no cloud agents.
    • Starter: 1 cloud project, 2 simultaneous cloud agents.
    • Pro: bring your own Coder, 5 / 20.
    • Enterprise: custom pricing, unlimited, SSO, SLA.
    • Prices are founder-confirmed: Free $0, Starter $20/month, Pro $40/month, Enterprise custom. Plans are chosen in Settings → Upgrade.
    • Free lists 2 devices with same-network connectivity (no cloud relay). Starter lists the cloud relay and unlimited devices, matching the app's plan cards. The relay is named only as a plan feature, with no encryption claim.
  • FAQ "How much does it cost?" is now "Is it free?": "Yes. The local app is free… Paid AO Cloud plans start at $20/month (Starter); Pro is $40/month and Enterprise has custom pricing." The waitlist line is removed; Enterprise is now a plan with Talk to founder.
  • Not documented as a connection option: the cloud relay. No relay endpoint or device-limit enforcement exists in this repo or ao-cloud yet, so remote-access.mdx still lists only LAN, Tailscale and the HTTPS tunnel.

npm metadata

  • packages/ao/package.json: adds a richer description, keywords, homepage, repository (with directory: packages/ao) and bugs.

  • License fix: the repo has been Apache-2.0 since docs: add Apache License 2.0 #2233, but several manifests still said MIT. These now all declare Apache-2.0:

    • @aoagents/ao and its four platform packages (npm currently shows @aoagents/ao as MIT)
    • the desktop app's frontend/package.json
    • packages/product-ui/package.json
    • the matching root entries in frontend/package-lock.json and packages/product-ui/package-lock.json
    • the Linux .rpm metadata in frontend/forge.config.ts, where MIT was hardcoded

    packages/cloud-client already said Apache-2.0. No package.json in the repo declares MIT anymore.

  • npm publishing appears to have stopped. On npm, @aoagents/ao latest is 0.10.3 (12 July 2026) and nightly is 0.10.4-nightly.202607251158 (25 July 2026). GitHub releases are on 0.14.x: v0.14.2 stable and v0.14.3 nightlies. No workflow in this repo publishes these packages; they were published by hand with npm publish after packages/build-binaries.sh. This PR does not change the publishing pipeline. Reviving or deprecating the npm package is pending a founder decision. Until something is published again, the new npm metadata and license stay in the repo only.

Docs (docs.orchestrator.inc)

  • The docs site is built from frontend/src/docs/content/ and deployed by .github/workflows/deploy-docs.yml.
  • There was already a mobile page at /configuration/remote-access titled "Connect Mobile". I renamed it Remote access and mobile and kept the URL, so existing links still work. I added:
    • a connection comparison table (LAN, Tailscale, managed HTTPS)
    • step-by-step Tailscale setup
    • two troubleshooting rows for Tailscale
  • The page is now linked from the docs index (text link and card), the quickstart (new "Follow from your phone" section and a Next-steps card), and the Configuration index card.

What the code says about pairing

  • mobilebridge.Endpoints puts LAN and Tailscale 100.x addresses in the offer as secure: false. Only the Cloudflare tunnel is secure: true on port 443.
  • packages/mobile/app.json allows cleartext on Android. iOS blocks cleartext to 100.64.0.0/10. So Tailscale is documented as Android-only for now, and iPhone/iPad are pointed to the managed HTTPS tunnel.
  • The desktop tries to set up tailscale serve TLS on its own, but the offer does not include that endpoint yet, so the docs don't claim Tailscale HTTPS pairing works.
  • The primary API stays on 127.0.0.1. The mobile listener is off by default and needs the connection password. The managed tunnel goes through Cloudflare, which terminates TLS, and the README says so.

Tests

  • npm ci && npm run build in frontend/src/docs: passes, and the rendered /configuration/remote-access page includes the new content.
  • No code changes.

Known gaps / follow-ups

  • The translated READMEs under translations/ don't have the new summary, mobile section or FAQ yet.
  • Android over Tailscale isn't verified on a physical device. The README and docs now say so everywhere and point to the HTTPS tunnel as the tested path.

🤖 Generated with Claude Code

@github-actions

Copy link
Copy Markdown
Contributor

🏆 Review leaderboard

Oct 12–19, 2026 · UTC

Rank Reviewer PRs reviewed Review rounds PR comments
🥇 @axisrow @axisrow 298 402 5
🥈 @nikhilachale @nikhilachale 30 54 11
🥉 @ronishrohan @ronishrohan 22 24 7
4 @Prasad-D-Ware @Prasad-D-Ware 19 42 6
5 @illegalcall @illegalcall 18 52 12
6 @Vaibhaav-Tiwari @Vaibhaav-Tiwari 13 17 6
7 @Rishet11 @Rishet11 6 24 25
8 @mohakchakraborty2004 @mohakchakraborty2004 6 6 0
9 @somewherelostt @somewherelostt 5 11 2
10 @Annieeeee11 @Annieeeee11 5 11 1

Ranked by distinct external PRs reviewed, then review rounds, then PR comments. Self-activity and bot activity are excluded.

Show 8 more reviewers
Rank Reviewer PRs reviewed Review rounds PR comments
11 @Pritom14 @Pritom14 4 4 10
12 @harshitsinghbhandari @harshitsinghbhandari 3 5 0
13 @neversettle17-101 @neversettle17-101 3 4 0
14 @wesleymatosdev @wesleymatosdev 2 8 1
15 @codebanditssss @codebanditssss 2 3 0
16 @LaibaFirdouse @LaibaFirdouse 2 3 0
17 @whoisasx @whoisasx 2 2 1
18 @ApexYash11 @ApexYash11 1 1 1

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested. Reviewed head 062fcc1. The license metadata changes in forge.config.ts (rpm), frontend, product-ui, the ao npm packages and the lockfiles all match the Apache-2.0 LICENSE file. The 36-agent count matches the README table. The claims that the QR carries Tailscale 100.x addresses and that tunnel-only hosts drop LAN/Tailscale addresses match backend/internal/mobilebridge/endpoints.go and BridgeService.Status. One blocking issue: the new copy says raw Tailscale works on Android, but the same docs page still says Android behavior is unverified and that no physical Android device was tested (see inline comments).

Optional, non-blocking: nothing in the repo references the App Store id 6792552173 or the Play package aoagents.dev, so please click-check both store links before merge. The README intro now says "formerly Agent Orchestrator, AO" and then keeps calling the product AO, which reads a little oddly. homepage/repository in frontend/package.json, product-ui/package.json and the rpm options still point at github.com/aoagents/agent-orchestrator, while packages/ao now points at OrchestratorInc.

Comment thread README.md Resolved

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Reviewed head b30a7ed. The earlier blocking finding is fixed. Android over Tailscale is now described as allowed (the Android app sets usesCleartextTraffic: true) but not verified on a device, the same way in the README Mobile section, the README FAQ, the remote-access table, the Tailscale steps and the troubleshooting rows, and that matches the existing unverified note. The Developer-mode note for Remote hosts is correct: settingsCatalog.tsx shows the remoteHosts section only when developerMode is on, and useRemoteHosts gates on developerMode && remoteHosts (the second flag defaults to on). The license metadata matches the Apache-2.0 LICENSE file.

Optional, non-blocking: click-check the App Store (id6792552173) and Google Play (aoagents.dev) links, which nothing else in the repo references. The frontend, product-ui and rpm homepage/repository fields still point at github.com/aoagents/agent-orchestrator.

AgentWrapper added a commit that referenced this pull request Oct 19, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested. Reviewed head 38b8ec2 (new: the two AO Cloud wording commits). The setup steps are accurate: Settings → General → Developer mode, then the Cloud toggle (CloudOfferingRow), then sign in to AO Cloud. One blocking issue: the copy says Cloud is available "in the nightly channel", but nothing in the code limits it to nightly, and the current stable release already ships it (inline).

Everything reviewed earlier is still fine.

Comment thread README.md Resolved

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Reviewed head 56b161b. The Cloud finding is fixed. The README Mobile section, the README FAQ and the docs index Cloud card now describe AO Cloud as an early preview in current desktop builds, stable and nightly, turned on in Developer mode. That matches the code: {developerMode && <CloudOfferingRow />}, no update-channel check, and the full flow present in v0.14.2. No nightly-only wording remains in this PR.

Optional, non-blocking (from earlier passes): click-check the App Store and Google Play links. The frontend, product-ui and rpm homepage/repository fields still point at github.com/aoagents/agent-orchestrator.

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Reviewed head 2703c01. The new "available now in the latest nightly" framing is accurate: nightly includes Cloud, and the copy no longer says nightly is required. The setup path (Developer mode, then Cloud, then Sign in to AO Cloud) matches the UI. "Anyone can sign in" is consistent with the code: sign-in creates an org when the account has none, and the cloud control plane has no invite or allowlist gate.

Optional, non-blocking: the README no longer mentions that stable builds also include Cloud. The Cloud guide in #6915 says so, which is enough. Click-check the App Store and Google Play links. The frontend, product-ui and rpm homepage/repository fields still point at github.com/aoagents/agent-orchestrator.

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested. Reviewed head 643ccae (new: AO Cloud generally available, plus a Plans section). What checks out: Settings → Upgrade is the right label, Free / Starter / Pro / Enterprise and Talk to founder match , and "Everything in Free / Starter" matches the cards. Three blocking issues (inline): 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". Local use has no plan check, so the docs are right on behavior, but the two should be aligned.

Comment thread README.md Resolved
Comment thread README.md Resolved
Comment thread README.md Resolved

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested. Reviewed head ad7f273 (new: prices plus device and connectivity tiers in Plans). The three findings from review 5567235492 (GA vs the in-app preview warning, Coder under Pro, plan-limit dimensions) 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 this README's own Mobile section. If the pricing and tiers come from a product decision that the app has not caught up with yet, reply on each thread saying so and link the app change. The docs and the shipped app should not disagree.

Comment thread README.md Resolved
Comment thread README.md Resolved
Comment thread README.md Resolved
Comment thread README.md Resolved

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Reviewed head b2b336b, which merges main including #6907. That billing change moved the app to match this Plans table: Bring your own Coder is now on Pro (settings.billing.proCoder), limits are shown as cloud projects and simultaneous cloud agents, Free lists 2 devices and no cloud relay, Starter adds the relay and unlimited devices, and Enterprise lists unlimited projects and agents plus collaboration. So the Coder, limits and device-tier findings from review 5567256267 are resolved by the app. The Free row now also correctly keeps free remote access over your own Tailscale or the managed HTTPS tunnel, consistent with the Mobile section, and the sandbox caution is back.

Non-blocking notes:

  • "Generally available" is now a product decision the docs carry with a caution, but the in-app Enable Cloud dialog still says "early, highly unstable preview ... Only enable it if you are actively testing" (settings.cloudConfirm.description), and Cloud is still behind Developer mode. Update that dialog in a follow-up app PR so a new user is not told GA by the README and "only if testing" by the app.
  • The $20 and $40 prices are not in the repo (they come from Stripe at runtime). Keep them in sync with the Stripe products.

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested. Reviewed head 2286b2c. "Available now as an early preview" resolves the earlier mismatch with the in-app Enable Cloud dialog. Two new blocking issues (inline): the new pricing link is a 404, and the new Cloud relay row in remote-access.mdx documents a connection method that is not implemented.

Comment thread README.md Resolved

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes requested. Reviewed head 2c40557. The Cloud relay row is gone from the remote-access connection table, and the relay and unlimited devices are now marked coming soon in the Plans intro and the Starter row, which matches the code (Connect Mobile has only lan, tailscale and tunnel endpoints). One blocking issue remains: the pricing link is still a 404 (inline).

Non-blocking: Starter and Pro now say 1/1 and 5/15. Those values come from Stripe at runtime and are not in the repo, so I could not verify them. Keep them in sync with the live Stripe products.

Comment thread README.md Resolved

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Reviewed current head 030e74c (the queued 779d86e plus one follow-up). The dead orchestrator.inc/pricing link is gone; plans now point to Settings → Upgrade. The new Teams & Enterprise waitlist link resolves (200). Cloud availability wording is neutral and still states the Developer mode, then Cloud, steps and the sandbox caution, so it does not conflict with the in-app Enable Cloud dialog. The unenforced 2-device limit is dropped from Free, and the relay stays marked coming soon. The plan figures come from Stripe at runtime and are not verifiable from the repo, so keep them in sync.

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Head 030e74c is unchanged since review 5567370960, which approved this exact commit. Rechecked: the waitlist link still returns 200. No new findings.

@OrcInc OrcInc added comp/docs-site Landing site, documentation content, and docs build. documentation Improvements or additions to documentation labels Oct 19, 2026

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved, with a merge gate. Reviewed head 8d1a66b. The Plans table no longer makes relay or device claims beyond "Coming soon: a cloud relay for access across devices" on Starter, which matches the code (no relay endpoint exists). Free keeps the accurate same-network, Tailscale and managed-tunnel access. The waitlist link returns 200.

Merge gate: https://orchestrator.inc/pricing still returns 404 as of this review. Per the worker reply, landing PR #64 publishes that page. Do not merge this PR until that URL returns 200; if #64 slips, drop the link.

AgentWrapper and others added 9 commits October 21, 2026 10:28
Add an extractable summary, a Mobile and cross-device section and an FAQ
to the README; retitle and extend the Remote access and mobile docs page
with LAN vs Tailscale setup; add homepage, repository, bugs and keywords
to the @aoagents/ao npm package and align npm licenses with Apache-2.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…se waitlist

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AgentWrapper and others added 12 commits October 21, 2026 10:28
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… cloud relay

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…aitlist

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@AgentWrapper AgentWrapper left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved, no changes needed. I checked the two new commits since 8d1a66b against main and the v0.14.4 tag.

  • cloudflared wording is right. frontend/forge.config.ts ships cloudflared only in darwin builds, already in v0.14.4 from #7002, and the package step fails if it is missing. On other platforms systeminstall.planCloudflared installs it with winget on Windows and the system package manager on Linux.
  • The count of 37 is right for what ships (memcode is registered in v0.14.4).

Merge order: merge #7027 first or together with this PR. On this branch the Supported agents table still lists 36 names, so the FAQ line "37 coding agent harnesses ... See the Supported agents table above" only matches once #7027 adds the memcode row.

The pricing gate is cleared: https://orchestrator.inc/pricing returns 200 now.

Not blocking: planLinuxPackage depends on the distro having a cloudflared package. If that turns out to be unreliable, change "one-click install on Linux" to "install from Connect Mobile".

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

comp/docs-site Landing site, documentation content, and docs build. documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants