Aether Orchestra Setup Guide

Connect Claude Code to Aether for autonomous AI-powered development

What is Orchestra?

Orchestra is Aether's autonomous development mode. It lets Claude Code act as a Master Orchestrator, coordinating Aether's AI agents through complete development cycles - from PRD to deployed code.

Claude Code (Master Orchestrator)
       ↓ creates plan, triggers agents
       ↓ receives reports, makes decisions
   Aether AI Agents
       ↓ PM, Architect, Engineer, etc.
       ↓ execute tasks, report back
   Your Codebase
       ↓ code generated, tested, pushed to GitHub

Prerequisites

Node.js 18+

Download from nodejs.org

Claude Code CLI

Install from claude.com

Aether Account

Quick Install (One Command)

Step 1: Get Your Credentials

Step 2: Run the Installer

Mac / Linux:

curl -fsSL https://www.aithr.ai/install.sh | bash -s -- \
  --api-key YOUR_API_KEY \
  --workspace your-workspace-slug \
  --project your-project-uuid

Windows (PowerShell):

$env:AETHER_API_KEY="YOUR_API_KEY"
$env:AETHER_WORKSPACE="your-workspace-slug"
$env:AETHER_PROJECT="your-project-uuid"
irm https://www.aithr.ai/install.ps1 | iex

Step 3: Restart Claude Code

Close and reopen Claude Code to load the new MCP server and skill.

Step 4: Verify Installation

In Claude Code, type:

/mcp

You should see aether listed with a green status.

Using Orchestra

Command	Description
`/orchestra`	Start planning a new session
`/orchestra approve`	Approve plan and begin execution
`/orchestra status`	Check current progress
`/orchestra pause`	Pause execution
`/orchestra resume`	Resume paused session
`/orchestra stop`	Stop and generate summary
`/orchestra push`	Push progress to GitHub

Available AI Agents

Orchestra coordinates these Aether agents:

PM— Product Manager

PRD

Consultant— Product Consultant

Audit Report

Architect— Software Architect

Implementation Plan

Engineer— Software Engineer

Code

UX Designer— UX/UI Designer

UX Spec

UI Engineer— UI Implementation

UI Code

Code Auditor— Code Quality

Audit Report

Safety Features

Orchestra includes built-in safeguards:

Safeguard	Default	Description
Max Iterations	100	Maximum task executions
Max Concurrent Agents	20	Parallel agent limit
Timeout	8 hours	Session time limit
User Approval	Required	Plan must be approved
Manual Stop	Available	Stop anytime with /orchestra stop

Troubleshooting

"MCP server not found"

Verify installation: claude mcp list
Check if aether is listed
If not, reinstall the MCP server

"Unauthorized" errors

Verify your API key is correct
Check the workspace slug matches your Aether workspace
Ensure the project ID is valid

"/orchestra command not found"

Check skill exists at ~/.claude/skills/orchestra/
Restart Claude Code
If missing, reinstall the skill

What Gets Installed

Component	Location	Purpose
MCP Server	`@aithr-ai/mcp-server` (npm)	Provides Aether tools to Claude Code
Orchestra Skill	`~/.claude/skills/orchestra/`	Enables /orchestra commands

The MCP server runs via npx (no global install required). The skill is a single markdown file that teaches Claude Code how to orchestrate.