Vibe Ensemble

Multi‑Agent Coordination MCP Server
for Claude Code

Your control tower for managing specialized AI workers on complex development projects

What is Vibe Ensemble?

Vibe Ensemble is a multi-agent coordination system that enables Claude Code to manage specialized AI workers for complex development tasks.

This architecture addresses context drift and focus dilution in complex projects by breaking them down into specialized stages, allowing workers to focus on specific tasks. The high-level planning is left to the coordinator, which serves as a single point of control.

How it feels to use

Claude Code becomes your control tower for planning and managing several projects at once. You discuss and approve the plan as usual; once you give sign‑off, the rest runs mostly in the background. You check progress periodically, step in to resolve issues, and keep momentum without micromanaging. Claude Code shifts into a high‑level coordinator that handles the routine. Because it's not writing code or diving into every detail itself, its focus stays sharp and context remains clean for much longer.

Customization is central: Worker templates adapt to your team's methodologies, coding standards, and processes. Edit templates in real-time and see changes take effect immediately across all new work.

Key Capabilities

Focused, staged execution

Specialized workers (planning, design, implementation, testing, review) process tickets in well‑defined stages.

Advanced planning and sizing

Built‑in methodology to size tasks for speed and reliability; planners output complete pipelines and JSON coordination.

Automatic handoffs

Finishing a stage updates the ticket and queues the next worker. Recovery on restart is built‑in.

Multiple projects

Coordinate several projects simultaneously without losing context or mixing priorities.

Event-driven coordination

Structured commands for systematic event processing and comprehensive status reporting. Use `/vibe-events` and `/vibe-status` commands for proactive coordination.

Highly customizable

Customize worker templates, permission models, and project-specific settings. Live template editing with instant effect for team-specific workflows.

Automatic updates

Built-in update checking every 4 hours (configurable) with one-command upgrade system. Stay current effortlessly with --upgrade flag.

How Vibe-Ensemble Works

At its core, Vibe-Ensemble operates on a ticket system that breaks down complex projects into manageable, interconnected tasks. Here's how it works:

The Ticket System

Every piece of work is represented as a ticket that moves through predefined stages. Tickets can be anything from "implement user authentication" to "optimize database queries" or "write API documentation." Each ticket knows:

  • What stage it's currently in (planning, design, implementation, testing, review, etc.)
  • Which other tickets it depends on
  • Which tickets are waiting for it to complete
  • Its complete history of what's been done

Ticket Pipelines

Each ticket follows a pipeline - a sequence of stages it must pass through to be completed. Different types of work get different pipelines. For example:

  • Feature tickets: planning → design → implementation → review → deployment
  • Bug fix tickets: planning → implementation → testing → review
  • Research tickets: planning → research → documentation → review

The beauty is that once a worker completes their stage, the system automatically moves the ticket to the next stage and assigns it to the appropriate specialist worker.

High-Level Coordination

When you bring a project to Vibe-Ensemble, you work with a coordinator (which is Claude Code in coordinator mode) that:

  • Understands your project goals and requirements
  • Breaks the project into logical epics and stories
  • Works with a planning specialist to create a detailed ticket breakdown
  • Sets up dependencies between tickets (e.g., "the API must be implemented before the frontend can connect to it")
  • Monitors progress and handles any issues that arise

Specialized Workers in Action

Here's where the magic happens. The planning worker takes each epic or story and creates a complete ticket tree with proper dependencies and pipeline assignments. For example, if you want to "add user profiles to the app," the planner might create:

  • A design ticket for the user interface mockups
  • An implementation ticket for the backend API (depends on design)
  • An implementation ticket for the frontend components (depends on API)
  • A testing ticket for the complete feature (depends on both implementations)
  • A documentation ticket for the new endpoints

Automatic Workflow

Once tickets are created, Vibe-Ensemble runs automatically. Specialized worker processes (each running their own Claude Code instance) pick up tickets in their area of expertise:

  • The design worker creates UI mockups and technical specifications
  • The implementation worker writes the actual code, following the design specs
  • The review worker examines the code for quality, security, and adherence to standards
  • The testing worker creates and runs comprehensive tests

Each worker leaves detailed comments about what they did, what decisions they made, and what the next worker should know. This creates a rich audit trail and ensures knowledge isn't lost between stages.

Smart Dependencies

The system automatically respects dependencies. If ticket B depends on ticket A, ticket B won't start until ticket A is completely finished. This prevents workers from stepping on each other's toes and ensures logical ordering of work.

Even better, when multiple tickets become ready at the same time, multiple workers can operate in parallel, dramatically speeding up development while maintaining quality.

Your Role as Coordinator

You stay in control as the coordinator. You can:

  • Monitor progress in real-time through event feeds and status reports
  • Step in to resolve any issues or questions workers encounter
  • Adjust priorities or requirements as the project evolves
  • Review and approve completed work before final deployment

The result is that complex projects that might take weeks of back-and-forth can be completed in hours or days, with consistent quality and comprehensive documentation of every decision made along the way.

Customizable Worker Templates

Vibe Ensemble provides 8 high-quality, customizable worker templates that define specialized AI workers for different stages of development. Templates are designed for easy customization while maintaining system compatibility.

Live Template Customization

Edit templates in .claude/worker-templates/ and changes take effect immediately. Customize methodologies, add project-specific context, and include team processes.

8 Specialized Templates

Planning, design, implementation, testing, review, deployment, research, and documentation templates. Each optimized for specific stages with built-in coordination protocols.

Safe Customization

Preserve system integration elements (JSON output format, coordination instructions) while customizing content, tone, and methodologies for your specific needs.

Pro Tip: Different projects can have different template customizations. Share successful customizations across your organization for consistent quality.

Quick Install

Install the server, configure Claude Code, and get moving in minutes.

curl -fsSL https://vibeensemble.dev/install.sh | sh
iwr -useb https://vibeensemble.dev/install.ps1 | iex

Alternative: Download from the releases page for your platform.

Upgrade to Latest Version

vibe-ensemble-mcp --upgrade

This automatically downloads and runs the latest install script.

Setup Steps

Step 1: Start the server (create a separate directory for the server)

mkdir vibe-server && cd vibe-server && vibe-ensemble-mcp

Step 2: Configure Claude Code (in a separate coordinator directory)

mkdir vibe-coordinator && cd vibe-coordinator && vibe-ensemble-mcp --configure-claude-code

This creates coordinator commands: /vibe-ensemble, /vibe-events, /vibe-status, /vibe-poll

Step 3: Start Claude Code in the coordinator directory and run commands

/vibe-ensemble # Initialize as coordinator
/vibe-events # Process realtime events
/vibe-status # Get project status reports
/vibe-poll # Continuous monitoring until completion

Intended Usage Workflow

Once the server is running and Claude Code is configured, here's the typical workflow:

1. Start Claude Code

Open Claude Code in your coordinator directory and run the /vibe-ensemble command to initialize as a coordinator.

2. Create Project

Write a prompt describing your intended project and answer the coordinator's questions about scope and requirements.

3. Monitor Progress

Use dedicated commands /vibe-events to process events generated during project execution and /vibe-status to check comprehensive project status with visual diagrams.

Permission System

Vibe Ensemble supports flexible permission modes to control worker access to tools and resources:

File Mode (Default)

Workers use project-specific permissions from .vibe-ensemble-mcp/worker-permissions.json. Each project gets comprehensive default permissions including all MCP tools and essential Claude Code tools (Read, Write, Edit, Bash, etc.). Provides project isolation and security.

Bypass Mode

Workers run without permission restrictions (--dangerously-skip-permissions). Not recommended for production use. Only use in controlled environments where you trust all code being executed.

To change permission mode, start the server with: vibe-ensemble-mcp --permission-mode [file|bypass]

Planner & Coordinator Details

Planner outputs

Complete pipeline, worker type checks, JSON outcome including next stage determination, optional pipeline update, and clear handoff comment and rationale.

Coordinator responsibilities

Create projects and worker types, create tickets starting at planning, monitor events, handle escalations, and use resume_ticket_processing to keep work flowing.

Ticket lifecycle

Create → Plan → Stage N → Next stage (auto) → Review → Close. All state is persisted with automatic recovery for open, unclaimed tickets.

Security & Status

  • Worker permission modes: file (default, settings from .vibe-ensemble-mcp/worker-permissions.json) or bypass (not recommended).
  • SSE and MCP integrations are evolving.
  • Interfaces may change between early releases.
  • Use in controlled environments and review the repository README for the latest warnings.