Skip to content

Update documentation content and add quick-start guide #82

Update documentation content and add quick-start guide

Update documentation content and add quick-start guide #82

Triggered via push March 27, 2026 03:51
Status Failure
Total duration 40s
Artifacts

release.yml

on: push
Web UI Gates
36s
Web UI Gates
Matrix: build
Publish GitHub release (tags only)
0s
Publish GitHub release (tags only)
Publish to public repo (tags only)
0s
Publish to public repo (tags only)
Fit to window
Zoom out
Zoom in

Annotations

2 errors and 1 warning
Web UI Gates
Process completed with exit code 1.
src/ci/workflow-gates.test.ts > web gui release workflow gates > documents multi-binary release artifact contract in README: crates/orchestrator-web-server/web-ui/src/ci/workflow-gates.test.ts#L184
AssertionError: expected '<div align="center">\n\n![header](htt…' to contain 'always builds release archives for `a…' - Expected + Received - always builds release archives for `ao`, `agent-runner`, `llm-cli-wrapper`, `ao-oai-runner`, `ao-workflow-runner` + <div align="center"> + + ![header](https://capsule-render.vercel.app/api?type=waving&color=0:0d1117,50:161b22,100:1f6feb&height=200&section=header&text=AO&fontSize=90&fontColor=f0f6fc&animation=fadeIn&fontAlignY=35&desc=Autonomous%20Agent%20Orchestrator&descAlignY=55&descSize=22&descColor=8b949e) + + <br/> + + [![Typing SVG](https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=500&size=20&duration=3000&pause=1500&color=58A6FF&center=true&vCenter=true&multiline=true&repeat=true&random=false&width=700&height=80&lines=Define+your+engineering+team+as+YAML.;Dispatch+tasks+to+AI+agents+across+isolated+worktrees.;Review%2C+merge%2C+and+ship+%E2%80%94+while+you+sleep.)](https://github.com/launchapp-dev/ao) + + <br/> + <br/> + <br/> + + + <a href="https://github.com/launchapp-dev/ao/releases/latest"><img src="https://img.shields.io/github/v/release/launchapp-dev/ao?style=for-the-badge&color=1f6feb&labelColor=0d1117&logo=github&logoColor=f0f6fc" alt="Release" /></a> + &nbsp; + <img src="https://img.shields.io/badge/rust-100%25-f0f6fc?style=for-the-badge&labelColor=0d1117&logo=rust&logoColor=f0f6fc" alt="Rust" /> + &nbsp; + <img src="https://img.shields.io/badge/macOS%20%7C%20Linux%20%7C%20Windows-f0f6fc?style=for-the-badge&labelColor=0d1117&logo=apple&logoColor=f0f6fc" alt="Platforms" /> + + </div> + + <br/> + + ## Install + + ```bash + curl -fsSL https://raw.githubusercontent.com/launchapp-dev/ao/main/install.sh | bash + ``` + + The upstream installer currently targets macOS. On Linux and Windows, use a release archive or build from source. + + <details> + <summary><kbd>options</kbd></summary> + + ```bash + # Specific version + AO_VERSION=v0.0.11 curl -fsSL https://raw.githubusercontent.com/launchapp-dev/ao/main/install.sh | bash + + # Custom directory + AO_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/launchapp-dev/ao/main/install.sh | bash + ``` + + </details> + + <details> + <summary><kbd>prerequisites</kbd></summary> + + You need at least one AI coding CLI: + + ```bash + npm install -g @anthropic-ai/claude-code # Claude (recommended) + npm install -g @openai/codex # Codex + npm install -g @google/gemini-cli # Gemini + ``` + + </details> + + --- + + ## What is AO? + + AO turns a single YAML file into an autonomous software delivery pipeline. + + You define agents, wire them into phases, compose phases into workflows, schedule everything with cron — and AO's daemon handles the rest: dispatching tasks to AI agents in isolated git worktrees, managing quality gates, and merging the results. + + ``` + ┌──────────────────────────────────────────────────┐ + │ AO Daemon (Rust) │ + │ │ + ┌────────┐ │ ┌───────────┐ ┌───────────┐ ┌────────┐ │ ┌────────┐ + │ Tasks │───▶│───▶│ Dispatch │───▶│ Agents │───▶│ Phases │─│──▶│ PRs │ + │ │ │ │ Queue │ │ │ │ │ │ │ │ + │ TASK-1 │ │ │ priority │ │ Claude │ │ impl │ │ │ PR #42 │ + │ TASK-2 │ │ │ routing │ │ Codex │ │ review │ │ │ PR #43 │ + │ TASK-3 │ │ │ capacity │ │ Gemini │ │ test │ │ │ PR #44 │ + └────────┘ │ └───────────┘ └───────────��
Web UI Gates
Node.js 20 actions are deprecated. The following actions are running on Node.js 20 and may not work as expected: actions/checkout@v4, actions/setup-node@v4, actions/upload-artifact@v4. Actions will be forced to run with Node.js 24 by default starting June 2nd, 2026. Node.js 20 will be removed from the runner on September 16th, 2026. Please check if updated versions of these actions are available that support Node.js 24. To opt into Node.js 24 now, set the FORCE_JAVASCRIPT_ACTIONS_TO_NODE24=true environment variable on the runner or in your workflow file. Once Node.js 24 becomes the default, you can temporarily opt out by setting ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION=true. For more information see: https://github.blog/changelog/2025-09-19-deprecation-of-node-20-on-github-actions-runners/