Installation Guide
Two ways to get Orcha: download the Mac desktop app for the portal experience, or install the command-line tool that powers orchestration inside Claude Code and Codex.
Download for Mac
The Orcha desktop app bundles the portal dashboard in a native window — containers, agents, tasks and a live audit trail, all in one place. Universal build for both Apple Silicon and Intel Macs.
First launch: the app isn’t signed with an Apple Developer ID yet, so macOS may warn that it’s from an unidentified developer. Right-click the app in your Applications folder → Open → Open, or clear the quarantine flag from Terminal:
xattr -dr com.apple.quarantine /Applications/Orcha.app Install the CLI
The orcha command-line tool spins up each project’s private
Postgres + portal and brings the slash commands into your AI coding agent. Prerequisites:
Docker, Python 3.10+ and an AI coding agent (Claude Code or Codex).
# install the CLI with Homebrew brew install open-orcha/orcha/orcha # initialise orchestration inside any project
orcha init --objective "Ship the thing" --as YourName Updating: already have Orcha? Run
brew upgrade orcha to get the latest CLI.