An AI-agentic IDE framework with 290+ MCP tools across 39 plugins. MCP protocol 2025-06-18 with tools, prompts, resources, and logging. Single-process in-process architecture — 4 core plugins bundled, 35 optional plugins installable separately.
# npm (recommended)
npm install -g @orchestra-mcp/cli
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/orchestra-mcp/framework/master/scripts/install.sh | sh
# Windows (Git Bash)
curl -fsSL --ssl-revoke-best-effort https://raw.githubusercontent.com/orchestra-mcp/framework/master/scripts/install.sh | sh
# From source
git clone https://github.com/orchestra-mcp/framework.git
cd framework && make installSupported platforms: macOS (amd64, arm64), Linux (amd64, arm64), Windows (amd64 via Git Bash)
# 1. Initialize Orchestra in your project (auto-detects your IDE)
cd your-project
orchestra init
# 2. That's it — your AI IDE now has 290+ tools + 5 promptsorchestra init detects your IDE and writes the correct MCP config:
| IDE | Config File |
|---|---|
| Claude Code | .mcp.json |
| Claude Desktop | claude_desktop_config.json (global) |
| Cursor | .cursor/mcp.json |
| VS Code / Copilot | .vscode/mcp.json |
| Cline | .vscode/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Codex (OpenAI) | .codex/config.toml |
| Gemini Code Assist | .gemini/settings.json |
| Zed | .zed/settings.json |
| Continue.dev | .continue/mcpServers/orchestra.yaml |
# Configure a specific IDE
orchestra init --ide=cursor
# Configure Claude Desktop (global config)
orchestra init --ide=claude-desktop
# Configure ALL supported IDEs at once
orchestra init --allmake mcpb
# Produces: dist/orchestra.mcpbThe .mcpb bundle packages cross-compiled binaries for all platforms. Users install it through Claude Desktop's extension installer — it extracts the correct binary, prompts for the workspace directory, and configures the MCP server automatically.
Agent (Claude, GPT, Gemini, etc.)
│ MCP protocol 2025-06-18 (JSON-RPC over stdin/stdout)
│ Capabilities: tools, prompts, resources, logging
▼
orchestra serve (single process)
├── storage.markdown (in-process, disk storage)
├── tools.features (in-process, 34 workflow tools)
├── tools.marketplace (in-process, 15 tools + 5 prompts)
├── transport.stdio (in-process, JSON-RPC bridge)
│
├── WebSocket :9201 (for browser/web clients)
├── TCP server :50101 (for desktop apps — Swift, Windows, Linux)
│
└── External plugins (QUIC + mTLS, optional)
├── bridge.claude (5 tools — AI provider)
├── bridge.openai (5 tools — AI provider)
├── bridge.gemini (5 tools — AI provider)
├── agent.orchestrator (20 tools — multi-agent)
├── devtools.* (80+ tools — git, docker, ssh, terminal, etc.)
├── bridge.discord (5 tools — Slack bot)
├── bridge.slack (5 tools — Discord bot)
└── 29 more plugins...
Single-process — 4 core plugins run in-process via direct Go function calls. Optional plugins connect over QUIC with mTLS and Protobuf framing.
| Capability | Description |
|---|---|
| Tools | 290+ tools with listChanged notifications (dynamic tool updates) |
| Prompts | 5 prompts (setup-project, recommend-packs, audit-packs, search-marketplace, onboard-project) |
| Resources | Project features, notes, and docs exposed via orchestra:// URI scheme |
| Logging | Server-side log messages with RFC 5424 severity levels and threshold filtering |
orchestra init # Initialize MCP configs for your IDE(s)
orchestra serve # Start the MCP server
orchestra version # Print version info
orchestra update # Self-update to latest release
orchestra plugin install <name> # Install an optional plugin
orchestra plugin remove <name> # Remove a plugin
orchestra plugin list # List installed plugins
orchestra plugin search <query> # Search available plugins
orchestra pack install <repo>[@ver] # Install a content pack (skills/agents/hooks)
orchestra pack remove <name> # Remove an installed pack
orchestra pack list # List installed packs
orchestra pack search <query> # Search available packs
orchestra pack recommend # Recommend packs for your project| Plugin | Tools | Description |
|---|---|---|
storage.markdown |
— | File storage with YAML frontmatter + Markdown body |
tools.features |
34 | Feature-driven workflow (11-state lifecycle) |
tools.marketplace |
15+5p | Pack management and marketplace |
transport.stdio |
— | MCP JSON-RPC bridge (stdin/stdout) |
| Category | Plugins | Tools |
|---|---|---|
| AI Bridges | bridge.claude, bridge.openai, bridge.gemini, bridge.ollama, bridge.firecrawl | 25 |
| Chat Bridges | bridge.discord, bridge.slack | 10 |
| Agent | agent.orchestrator | 20 |
| DevTools | devtools.git, devtools.docker, devtools.terminal, devtools.ssh, devtools.file-explorer, devtools.database, devtools.debugger, devtools.test-runner, devtools.log-viewer, devtools.services, devtools.devops, devtools.components | 110+ |
| AI Awareness | ai.screenshot, ai.vision, ai.browser-context, ai.screen-reader | 25 |
| Tools | tools.agentops, tools.sessions, tools.workspace, tools.hooks, tools.notes, tools.docs, tools.markdown, tools.extension-generator | 58 |
| Services | services.voice, services.notifications | 16 |
| Integration | integration.figma | 6 |
| Transport | transport.quic-bridge, transport.webtransport | — |
# Install a plugin
orchestra plugin install bridge-claude
# Search plugins
orchestra plugin search "ai"Packs are installable bundles of skills (slash commands), agents (specialized sub-agents), and hooks (shell scripts). 25 official packs:
| Pack | Stacks | Contents |
|---|---|---|
pack-essentials |
all | project-manager, qa-testing, docs, scrum-master, devops |
pack-go-backend |
go | go-backend skill, go-architect + qa-go agents |
pack-rust-engine |
rust | rust-engine skill, rust-engineer + qa-rust agents |
pack-react-frontend |
react, ts | typescript-react, ui-design, tailwind skills |
pack-database |
all | database-sync skill, dba + postgres/sqlite/redis agents |
pack-ai |
all | ai-agentic skill, ai-engineer + lancedb agents |
pack-proto |
go, rust | proto-grpc skill, quic-protocol agent |
pack-desktop |
go, swift | wails, macos, native-widgets skills |
pack-mobile |
react | react-native skill, mobile-dev agent |
pack-chrome |
typescript | chrome-extension skill |
pack-infra |
all | gcp-infrastructure skill, devops agent |
pack-extensions |
all | native-extensions, raycast, vscode skills |
pack-analytics |
all | clickhouse-engineer agent |
pack-native-swift |
swift | swift-plugin agent |
pack-native-kotlin |
kotlin | kotlin-plugin agent |
pack-native-csharp |
csharp | csharp-plugin agent |
pack-native-gtk |
c | gtk-plugin agent |
pack-powersync |
react, rn, ts, flutter | powersync skill, powersync-engineer agent |
pack-laravel |
php | laravel skill, laravel-engineer + qa-laravel agents |
pack-inertia |
php, react, ts | inertia skill, inertia-engineer agent |
pack-tailwind |
react, ts, php | tailwindcss skill, tailwind-designer agent |
pack-gcp |
docker, go, ts | gcp skill, gcp-architect agent |
pack-docker |
docker | docker skill, docker-engineer agent |
pack-go-adk |
go | go-adk skill, go-adk-engineer agent |
pack-flow |
all | 18 FLOW methodology skills + telemetry hook |
orchestra pack install github.com/orchestra-mcp/pack-go-backend
orchestra pack recommend # Auto-detect stacks and suggest packs
orchestra pack search "react"The tools.features plugin implements an 11-state feature lifecycle with full project management capabilities:
backlog → todo → in-progress → ready-for-testing → in-testing →
ready-for-docs → in-docs → documented → in-review → done
│
needs-edits ◄───────────┘
| Category | Count | Tools |
|---|---|---|
| Project | 4 | create_project, list_projects, delete_project, get_project_status |
| Feature | 6 | create_feature, get_feature, update_feature, list_features, delete_feature, search_features |
| Workflow | 6 | advance_feature, reject_feature, get_next_feature, set_current_feature, get_workflow_status, get_gate_requirements |
| Custom Workflows | 5 | create_workflow, get_workflow, update_workflow, delete_workflow, list_workflows |
| Review | 3 | request_review, submit_review, get_pending_reviews |
| Dependencies | 4 | add_dependency, remove_dependency, get_dependency_graph, get_blocked_features |
| WIP Limits | 3 | set_wip_limits, get_wip_limits, check_wip_limit |
| Reporting | 3 | get_progress, get_review_queue, get_blocked_features |
| Metadata | 8 | add_labels, remove_labels, assign_feature, unassign_feature, set_estimate, save_note, list_notes |
| Plans | 8 | create_plan, approve_plan, breakdown_plan, complete_plan, delete_plan, get_plan, list_plans, update_plan |
| Persons | 6 | create_person, get_person, update_person, delete_person, list_persons, get_person_workload |
| Delegations | 5 | delegate_feature, respond_delegation, get_delegation, list_delegations, get_pending_delegations |
| Requests | 6 | create_request, get_request, list_requests, dismiss_request, convert_request, get_next_request |
| Experiments | 8 | create_experiment, start_experiment, complete_experiment, abandon_experiment, update_experiment, get_experiment, list_experiments, spawn_feature_from_experiment |
| Discovery | 10 | create_discovery_cycle, get_discovery_cycle, update_discovery_cycle, complete_discovery_cycle, delete_discovery_cycle, list_discovery_cycles, create_discovery_review, get_discovery_review, record_review_decisions, get_discovery_status |
setup-server.sh provisions an Ubuntu 24.04 server with:
- Go backend (Fiber v3 + GORM) via systemd
- Next.js frontend (SSR) via systemd + pnpm
- PowerSync (self-hosted, Docker) for offline-first mobile sync
- PostgreSQL 16 with WAL logical replication
- Caddy reverse proxy with Cloudflare DNS-01 TLS
- UFW firewall, swap, SSH hardening, daily backups
# First-time setup (run as root)
bash scripts/deploy/setup-server.sh
# Deploy updates (run as deploy user)
/opt/orchestra/deploy.sh all # Deploy everything
/opt/orchestra/deploy.sh web # Go backend only
/opt/orchestra/deploy.sh next # Next.js frontend only
/opt/orchestra/deploy.sh powersync # PowerSync onlyThe script is idempotent — safe to re-run on existing servers (preserves credentials).
framework/
├── libs/ # All packages (each is a separate GitHub repo)
│ ├── proto/ # Protobuf definitions (plugin.proto)
│ ├── gen-go/ # Generated Go code from proto
│ ├── sdk-go/ # Plugin SDK (QUIC, mTLS, framing, helpers)
│ ├── orchestrator/ # Central hub (config, loader, router, server)
│ ├── cli/ # CLI binary (init, serve, version, pack, plugin)
│ ├── plugin-storage-markdown/ # Core: Markdown storage
│ ├── plugin-tools-features/ # Core: 34 feature workflow tools
│ ├── plugin-tools-marketplace/ # Core: pack management + marketplace
│ ├── plugin-transport-stdio/ # Core: MCP JSON-RPC bridge
│ ├── plugin-bridge-claude/ # Optional: Claude AI provider
│ ├── plugin-bridge-openai/ # Optional: OpenAI provider
│ ├── plugin-bridge-gemini/ # Optional: Gemini provider
│ ├── plugin-agent-orchestrator/ # Optional: Multi-agent orchestration
│ ├── plugin-devtools-*/ # Optional: 12 devtools plugins
│ ├── plugin-ai-*/ # Optional: 4 AI awareness plugins
│ └── ... (38 plugins total)
├── packs/ # 24 installable content packs
├── scripts/
│ ├── install.sh # curl | sh installer (macOS/Linux/Windows)
│ ├── npm-postinstall.js # npm postinstall binary downloader
│ ├── deploy/setup-server.sh # Ubuntu 24.04 server provisioning
│ ├── deploy/deploy.sh # Deploy script (web/next/powersync)
│ ├── mcpb/ # MCPB bundle packaging
│ │ ├── manifest.json # MCPB v0.3 manifest
│ │ ├── build-mcpb.sh # Cross-compile + package script
│ │ ├── test-mcpb.sh # Validation tests (26 checks)
│ │ └── icon.png # Bundle icon
│ ├── new-plugin.sh # Plugin generator
│ ├── sync-repos.sh # Push libs/ to individual GitHub repos
│ ├── release.sh # Tag + create GitHub releases
│ ├── ship.sh # Full ship pipeline (build, test, sync, release)
│ └── test-e2e.sh # End-to-end integration test
├── .github/workflows/
│ ├── ci.yml # CI: build + test + vet on push/PR
│ ├── release.yml # Release: 5-platform cross-compile on tag push
│ └── publish.yml # Publish @orchestra-mcp/cli to npm after release
├── package.json # npm package (@orchestra-mcp/cli)
├── orchestra.json # Package manifest
├── orchestra.lock # Pinned versions (48 packages)
├── go.work # Go workspace
└── Makefile # Build, test, install, release
make build # Build all binaries to bin/
make test # Run all unit tests
make test-e2e # Build + run end-to-end integration test
make install # Install binaries to /usr/local/bin
make release # Cross-compile for darwin/linux × amd64/arm64 + windows/amd64
make mcpb # Build .mcpb bundle for Claude Desktop one-click install
make clean # Remove build artifacts and certs
make proto # Lint + generate proto codeBuild a plugin in ~50 lines of Go:
package main
import (
"context"
"github.com/orchestra-mcp/sdk-go/plugin"
"google.golang.org/protobuf/types/known/structpb"
)
func main() {
p := plugin.New("my.plugin").
Version("0.1.0").
Description("My custom plugin").
ProvidesTools("hello").
BuildWithTools()
p.Server().RegisterTool("hello", "Say hello", nil,
func(ctx context.Context, args *structpb.Struct) (string, error) {
return `{"message": "Hello from my plugin!"}`, nil
})
p.ParseFlags()
ctx, cancel := context.WithCancel(context.Background())
defer cancel()
p.Run(ctx)
}./scripts/new-plugin.sh my-plugin tools # Tools plugin
./scripts/new-plugin.sh my-plugin storage # Storage plugin
./scripts/new-plugin.sh my-plugin transport # Transport plugin# Ship a release (build, test, sync, tag, release)
./scripts/ship.sh v1.0.0
./scripts/ship.sh v1.0.0 --skip-pr --message "Release v1.0.0"
./scripts/ship.sh v1.0.0 --dry-run
# Sync local libs/ to individual GitHub repos
./scripts/sync-repos.sh # Sync all 48 packages
./scripts/sync-repos.sh sdk-go cli # Sync specific packages
# Release all packages
./scripts/release.sh v1.0.0 # Tag + release all 48 repos
./scripts/release.sh v1.0.0 --force # Re-tag existing versionMCP protocol version 2025-06-18 over stdio (JSON-RPC 2.0). Supports:
tools/list,tools/call— 290+ tools withlistChangednotificationsprompts/list,prompts/get— 5 promptsresources/list,resources/read,resources/templates/list— project resourceslogging/setLevel— server-side log filtering
Length-delimited Protobuf over QUIC with mTLS:
[4 bytes big-endian uint32 length][N bytes Protobuf PluginRequest/Response]
- mTLS: Auto-generated ed25519 CA + per-plugin certificates at
~/.orchestra/certs/ - In-process: Core plugins bypass QUIC entirely — direct Go function calls
- WebSocket: Browser/web clients connect on port 9201 (JSON-RPC)
- TCP: Desktop apps (Swift, Windows, Linux) connect via length-delimited Protobuf on port 50101
- Storage format: YAML frontmatter (
---delimiters) + Markdown body
All 48 packages are published as independent Go modules under github.com/orchestra-mcp/:
See CONTRIBUTING.md for development setup, coding standards, and PR process.
MIT