From 40964716cb53101cc49ebe9bd3f5f6188e17b08f Mon Sep 17 00:00:00 2001 From: Harshit Singh Bhandari Date: Tue, 7 Jul 2026 22:15:17 +0530 Subject: [PATCH 1/3] docs: make GitHub Releases the primary install path The @aoagents/ao npm package is frozen and no longer updated. Lead the README and installation guide with the desktop build download; keep npm as a still-works-but-not-recommended fallback. Also fix the from-source clone URL (ComposioHQ -> AgentWrapper). Co-Authored-By: Claude Opus 4.8 --- README.md | 25 +++++++++++-------- .../src/landing/content/docs/installation.mdx | 15 ++++++++++- 2 files changed, 29 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index f361c440b8..620f5bcb4f 100644 --- a/README.md +++ b/README.md @@ -134,16 +134,7 @@ Reviewer agents are configured separately. The current reviewer harnesses are: ## Install -The fastest path is the same flow used by the installation docs: - -```bash -npm install -g @aoagents/ao -ao start -``` - -Run `ao start` from the repository you want AO to manage. See the [installation guide](https://ao-agents.com/docs/installation) for pnpm, yarn, source installs, agent CLI setup, and troubleshooting. - -You can also download the latest desktop build for your platform: +Download the latest desktop build for your platform: | Platform | Download | | -------- | ------------------------------------------------------------------------------------------------- | @@ -151,6 +142,20 @@ You can also download the latest desktop build for your platform: | macOS | [Agent Orchestrator.dmg](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | | Linux | [Agent Orchestrator.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | +After installing, run `ao start` from the repository you want AO to manage. See the [installation guide](https://ao-agents.com/docs/installation) for agent CLI setup and troubleshooting. + +
+Install via npm (still works, but no longer recommended) + +The `@aoagents/ao` npm package is frozen and no longer receives updates. Prefer the desktop build above. + +```bash +npm install -g @aoagents/ao +ao start +``` + +
+ ## Witness AO's Journey on X diff --git a/frontend/src/landing/content/docs/installation.mdx b/frontend/src/landing/content/docs/installation.mdx index 1fffc19c02..401b95dd85 100644 --- a/frontend/src/landing/content/docs/installation.mdx +++ b/frontend/src/landing/content/docs/installation.mdx @@ -43,12 +43,25 @@ If you plan to use GitLab or Linear, install and authenticate their CLIs or cred ## Install AO +The recommended way to install AO is the desktop build from GitHub Releases. Download the latest build for your platform: + +| Platform | Download | +| -------- | ------------------------------------------------------------------------------------------------- | +| macOS | [Agent Orchestrator.dmg](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | +| Windows | [Setup.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | +| Linux | [Agent Orchestrator.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | + + + The `@aoagents/ao` npm package is frozen and no longer receives updates. Prefer the desktop build above. The package + still works if you want the `ao` CLI: + + ```bash npm install -g @aoagents/ao ``` ```bash pnpm add -g @aoagents/ao ``` ```bash yarn global add @aoagents/ao ``` - ```bash git clone https://github.com/ComposioHQ/agent-orchestrator cd agent-orchestrator pnpm install pnpm build + ```bash git clone https://github.com/AgentWrapper/agent-orchestrator cd agent-orchestrator pnpm install pnpm build pnpm --filter @aoagents/ao link --global ``` From 904e93314aa22031b5277f1e4d6b82c6dfdad1f4 Mon Sep 17 00:00:00 2001 From: Harshit Singh Bhandari Date: Wed, 8 Jul 2026 22:58:07 +0530 Subject: [PATCH 2/3] docs: fix release asset links and desktop-vs-CLI install flow Address review on #2495: - Link real stable release assets (darwin zip, win32 exe, linux AppImage) via releases/latest/download, matching what `ao start` fetches. No .dmg asset exists yet. - Desktop build installs no CLI, so the primary flow is 'open the app' (the app owns the daemon), not 'run ao start'. ao start stays documented as the legacy npm-side bridge that fetches and opens the app. - Make installation.mdx internally consistent: reframe the intro callout, gate 'ao --version' behind the CLI path, and give the start step a desktop-app branch. Co-Authored-By: Claude Opus 4.8 --- README.md | 17 +++++---- .../src/landing/content/docs/installation.mdx | 38 ++++++++++--------- 2 files changed, 30 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index 620f5bcb4f..26707e6810 100644 --- a/README.md +++ b/README.md @@ -136,18 +136,19 @@ Reviewer agents are configured separately. The current reviewer harnesses are: Download the latest desktop build for your platform: -| Platform | Download | -| -------- | ------------------------------------------------------------------------------------------------- | -| Windows | [Setup.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | -| macOS | [Agent Orchestrator.dmg](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | -| Linux | [Agent Orchestrator.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | +| Platform | Download | +| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- | +| macOS (Apple silicon) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-arm64.zip) | +| macOS (Intel) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-x64.zip) | +| Windows | [.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-win32-x64.exe) | +| Linux | [.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-linux-x64.AppImage) | -After installing, run `ao start` from the repository you want AO to manage. See the [installation guide](https://ao-agents.com/docs/installation) for agent CLI setup and troubleshooting. +After installing, open Agent Orchestrator and point it at the repository you want AO to manage. The desktop app runs the daemon for you, so no CLI is required. See the [installation guide](https://ao-agents.com/docs/installation) for agent CLI setup and troubleshooting.
-Install via npm (still works, but no longer recommended) +Install via npm (legacy CLI, no longer recommended) -The `@aoagents/ao` npm package is frozen and no longer receives updates. Prefer the desktop build above. +The `@aoagents/ao` npm package is frozen and no longer receives updates. It ships the `ao` CLI for existing users; `ao start` fetches and opens the same desktop build linked above. Prefer the desktop download for a fresh setup. ```bash npm install -g @aoagents/ao diff --git a/frontend/src/landing/content/docs/installation.mdx b/frontend/src/landing/content/docs/installation.mdx index 401b95dd85..d14bf29b7e 100644 --- a/frontend/src/landing/content/docs/installation.mdx +++ b/frontend/src/landing/content/docs/installation.mdx @@ -8,11 +8,12 @@ import { Tab, Tabs } from "fumadocs-ui/components/tabs"; import { Step, Steps } from "fumadocs-ui/components/steps"; import { Accordions, Accordion } from "fumadocs-ui/components/accordion"; -This page gets your machine ready to run Agent Orchestrator. By the end, the `ao` command should be on your `PATH`, your source-control CLI should be authenticated, and `ao doctor` should be able to explain what is ready or missing. +This page gets your machine ready to run Agent Orchestrator. By the end, the desktop app (or the legacy `ao` CLI) should be installed, your source-control CLI should be authenticated, and an agent CLI should be ready to do the coding. - The published package is `@aoagents/ao`. It provides the global `ao` command and includes the built-in CLI, dashboard, - and plugin packages. + The recommended install is the **desktop app** from GitHub Releases. It bundles the daemon, dashboard, and plugins, and + updates itself. The `@aoagents/ao` npm package is the legacy on-ramp: it ships the `ao` CLI, whose `ao start` fetches and + opens the same desktop app. The npm package is frozen and no longer updated. ## Prerequisites @@ -43,17 +44,20 @@ If you plan to use GitLab or Linear, install and authenticate their CLIs or cred ## Install AO -The recommended way to install AO is the desktop build from GitHub Releases. Download the latest build for your platform: +The recommended way to install AO is the desktop build from GitHub Releases. Download the latest build for your platform, then open it: -| Platform | Download | -| -------- | ------------------------------------------------------------------------------------------------- | -| macOS | [Agent Orchestrator.dmg](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | -| Windows | [Setup.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | -| Linux | [Agent Orchestrator.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest) | +| Platform | Download | +| --------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| macOS (Apple silicon) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-arm64.zip) | +| macOS (Intel) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-x64.zip) | +| Windows | [.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-win32-x64.exe) | +| Linux | [.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-linux-x64.AppImage) | - - The `@aoagents/ao` npm package is frozen and no longer receives updates. Prefer the desktop build above. The package - still works if you want the `ao` CLI: +The desktop app owns the daemon, dashboard, and auto-updates, so a desktop install needs no CLI. Skip ahead to [Authenticate Your Tools](#authenticate-your-tools). + + + The `@aoagents/ao` npm package is frozen and no longer receives updates. It ships the `ao` CLI for existing users; + `ao start` fetches and opens the same desktop build above. Use it only if you already run AO from the CLI: @@ -66,7 +70,7 @@ The recommended way to install AO is the desktop build from GitHub Releases. Dow -Confirm the command is available: +If you installed the CLI, confirm it is available (desktop users can skip this): ```bash ao --version @@ -108,16 +112,16 @@ AO launches an agent CLI inside each worker session. Start with the one you alre ### Start AO in a repo -Run `ao start` from a repository you want AO to manage: +**Desktop app:** open Agent Orchestrator and add the repository you want it to manage. The app starts the daemon, dashboard, and an orchestrator session for the project. + +**CLI (legacy):** run `ao start` from a repository you want AO to manage: ```bash cd ~/code/my-repo ao start ``` -If there is no `agent-orchestrator.yaml`, AO creates one. It also starts the dashboard and an orchestrator session for the project. - -You can also start from a path or clone from a URL: +If there is no `agent-orchestrator.yaml`, AO creates one. You can also start from a path or clone from a URL: ```bash ao start ~/code/my-repo From bc91087b285c501e32c184bdbe54cc31b8122b8d Mon Sep 17 00:00:00 2001 From: Harshit Singh Bhandari Date: Wed, 8 Jul 2026 23:33:39 +0530 Subject: [PATCH 3/3] style: apply prettier to install docs Co-Authored-By: Claude Opus 4.8 --- README.md | 10 +++++----- .../src/landing/content/docs/installation.mdx | 20 +++++++++---------- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 26707e6810..f7b3865cdc 100644 --- a/README.md +++ b/README.md @@ -136,12 +136,12 @@ Reviewer agents are configured separately. The current reviewer harnesses are: Download the latest desktop build for your platform: -| Platform | Download | -| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- | +| Platform | Download | +| --------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | macOS (Apple silicon) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-arm64.zip) | -| macOS (Intel) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-x64.zip) | -| Windows | [.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-win32-x64.exe) | -| Linux | [.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-linux-x64.AppImage) | +| macOS (Intel) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-x64.zip) | +| Windows | [.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-win32-x64.exe) | +| Linux | [.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-linux-x64.AppImage) | After installing, open Agent Orchestrator and point it at the repository you want AO to manage. The desktop app runs the daemon for you, so no CLI is required. See the [installation guide](https://ao-agents.com/docs/installation) for agent CLI setup and troubleshooting. diff --git a/frontend/src/landing/content/docs/installation.mdx b/frontend/src/landing/content/docs/installation.mdx index d14bf29b7e..1b419508de 100644 --- a/frontend/src/landing/content/docs/installation.mdx +++ b/frontend/src/landing/content/docs/installation.mdx @@ -11,9 +11,9 @@ import { Accordions, Accordion } from "fumadocs-ui/components/accordion"; This page gets your machine ready to run Agent Orchestrator. By the end, the desktop app (or the legacy `ao` CLI) should be installed, your source-control CLI should be authenticated, and an agent CLI should be ready to do the coding. - The recommended install is the **desktop app** from GitHub Releases. It bundles the daemon, dashboard, and plugins, and - updates itself. The `@aoagents/ao` npm package is the legacy on-ramp: it ships the `ao` CLI, whose `ao start` fetches and - opens the same desktop app. The npm package is frozen and no longer updated. + The recommended install is the **desktop app** from GitHub Releases. It bundles the daemon, dashboard, and plugins, + and updates itself. The `@aoagents/ao` npm package is the legacy on-ramp: it ships the `ao` CLI, whose `ao start` + fetches and opens the same desktop app. The npm package is frozen and no longer updated. ## Prerequisites @@ -46,18 +46,18 @@ If you plan to use GitLab or Linear, install and authenticate their CLIs or cred The recommended way to install AO is the desktop build from GitHub Releases. Download the latest build for your platform, then open it: -| Platform | Download | -| --------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| macOS (Apple silicon) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-arm64.zip) | -| macOS (Intel) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-x64.zip) | -| Windows | [.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-win32-x64.exe) | +| Platform | Download | +| --------------------- | ------------------------------------------------------------------------------------------------------------------------------ | +| macOS (Apple silicon) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-arm64.zip) | +| macOS (Intel) | [.zip](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-darwin-x64.zip) | +| Windows | [.exe](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-win32-x64.exe) | | Linux | [.AppImage](https://github.com/AgentWrapper/agent-orchestrator/releases/latest/download/agent-orchestrator-linux-x64.AppImage) | The desktop app owns the daemon, dashboard, and auto-updates, so a desktop install needs no CLI. Skip ahead to [Authenticate Your Tools](#authenticate-your-tools). - The `@aoagents/ao` npm package is frozen and no longer receives updates. It ships the `ao` CLI for existing users; - `ao start` fetches and opens the same desktop build above. Use it only if you already run AO from the CLI: + The `@aoagents/ao` npm package is frozen and no longer receives updates. It ships the `ao` CLI for existing users; `ao + start` fetches and opens the same desktop build above. Use it only if you already run AO from the CLI: