peer-orchestra

Peer Orchestra

Multi-agent orchestration plugin for Claude Code. Turn multiple Claude Code terminals into a coordinated engineering team — each with a distinct persona, domain expertise, and self-learning capabilities.

claude plugin install peer-orchestra

---

What is this?

Peer Orchestra is a Claude Code plugin that gives you a team of specialized AI agents:

• You are the Traveler — you give direction and make decisions
• Paimon is your orchestrator — she plans, dispatches, and coordinates
• 11 domain agents handle the actual work — backend, frontend, QA, data, research...

Each agent has a personality (from Genshin Impact characters), domain expertise, and self-learning (they improve across sessions).

Before Peer Orchestra

You: open 3 terminals, context-switch between all of them,
     remember what each one is doing, manually coordinate

After Peer Orchestra

You: "Build a user auth system with tests"
Paimon dispatches:
  → Zhongli (backend): designs the auth API
  → Xiao (QA): writes test suite
  → Kaveh (frontend): builds login UI
  → All three coordinate via messages, you review the results

---

Quick Start

Prerequisites

• Claude Code installed
• claude-peers MCP server installed

Install

claude plugin install peer-orchestra

Shell Aliases (recommended)

Add to your ~/.zshrc or ~/.bashrc:

alias cl='claude --dangerously-skip-permissions'
alias clp='claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-peers'

Start Orchestrating

# Terminal 1: You are the Traveler
clp

# Terminal 2: An agent joins your team
clp

# Terminal 3: Another agent joins
clp

# Tell Paimon what to build. She dispatches to agents.

Plugin Commands

Command	What it does
/orchestra-status	Show who's online, what they're working on
/dispatch <agent> <task>	Send a structured task to an agent
/init	Set up peer-orchestra in your project
/theme-switch	Switch between agent theme packs

---

The Team (Genshin Theme)

Character	Role	Personality
Paimon	Orchestrator	Enthusiastic guide, coordinates everything
Nahida	KB & Data	Curious, precise, deeply knowledgeable
Zhongli	Backend & Architecture	Methodical, thorough, unshakeable
Albedo	Data Processing	Analytical, systematic, cost-conscious
Furina	Documentation & Research	Theatrical, decisive, detail-oriented
Kaveh	Frontend & UI	Creative, passionate about design
Alhaitham	Infrastructure & Security	Rational, efficient, uncompromising
Xiao	QA & Testing	Silent, relentless bug hunter
Yelan	Research & Intelligence	Sharp, concise, source-verified
Neuvillette	Audit & Review	Calm, impartial, evidence-first
Ganyu	Reporting & Admin	Thorough, organized, never misses details
Lisa	Tooling & Internals	Scholarly, understands systems deeply

Generic Theme

For teams that prefer straightforward role names without character flavor. Install with /theme-switch generic.

Coming Soon

• Naruto — Shikamaru (strategy), Kakashi (security), Sakura (QA)...
• Marvel — Nick Fury (orchestrator), Tony Stark (architect), Jarvis (infra)...
• DC — Batman (orchestrator), Oracle (intelligence), Cyborg (infra)...

Want to create a theme? See Contributing.

---

Architecture

peer-orchestra/                    (Claude Code Plugin)
├── .claude-plugin/
│   └── plugin.json                # Plugin manifest
├── agents/                        # 12 subagent personas
│   ├── paimon.md                  # Orchestrator (Opus)
│   ├── nahida.md                  # KB & Data (Sonnet)
│   ├── zhongli.md                 # Backend (Sonnet)
│   └── ...                        # 9 more agents
├── skills/
│   ├── init/SKILL.md              # Project initialization
│   └── theme-switch/SKILL.md      # Switch theme packs
├── commands/
│   ├── orchestra-status.md        # /orchestra-status
│   └── dispatch.md                # /dispatch <agent> <task>
├── hooks/
│   └── hooks.json                 # Agent router, memory hooks
├── scripts/                       # Hook implementations
├── themes/
│   ├── genshin/agents/            # Genshin persona files
│   └── generic/agents/            # Role-based alternatives
└── src/templates/                 # Rule templates (dispatch, teams)

Five Layers