README

Chrome

Orchestra MCP Chrome plugin — a build orchestrator that assembles plugin views into a Chrome Manifest V3 extension with side panel and full-page IDE.

Features

Build Orchestrator — Collects ChromeViewContribution from all active plugins and builds a unified Chrome extension
Plugin-Aware UI — Side panel and IDE dynamically render views contributed by other plugins via React.lazy()
Vite Build Pipeline — Multi-entry build (background, sidepanel, ide) with dynamic alias resolution for plugin directories
Deep Ocean Theme — Material Design theme with Tailwind CSS v4 integration
WebSocket Transport — OrchestraClient connects to the Desktop tray app with auto-reconnect
3 MCP Tools — Extension version, build status, and build trigger
2 Artisan Commands — php artisan chrome:install and php artisan chrome:build

Requirements

PHP 8.2+
Laravel 12.x
orchestra-mcp/plugins package
Node.js 20+ and pnpm

Installation

composer require orchestra-mcp/chrome

The service provider is auto-discovered. Run the install command to publish config and install Node dependencies:

php artisan chrome:install

Quick Start

Build the Extension

php artisan chrome:build

Load in Chrome

Open chrome://extensions/
Enable "Developer mode"
Click "Load unpacked"
Select the chrome-extension/ directory

How Plugins Contribute Views

Other plugins push views to the Chrome extension by:

Implementing HasChromeViews (declares TSX directory path)
Registering ChromeViewContribution (declares view ID, panel target, component path)

use OrchestraMcp\Plugins\Contracts\HasChromeViews;
use OrchestraMcp\Plugins\Plugin\Plugin;

class GitPlugin extends Plugin implements HasChromeViews
{
    public function chromeViewsConfig(): array
    {
        return [
            'path' => __DIR__ . '/../extension-views',
            'namespace' => 'git',
        ];
    }
}

Views target specific panels: sidepanel, ide.sidebar, ide.editor, ide.statusbar.

MCP Tools

Tool	Annotation	Description
`chrome-extension-version`	`#[IsReadOnly]`	Extension manifest metadata
`chrome-extension-build-status`	`#[IsReadOnly]`	Build status and file list
`chrome-extension-build`	—	Trigger full build pipeline

Artisan Commands

Command	Description
`chrome:install`	Publish config and install Node dependencies
`chrome:build`	Build the Chrome extension (collect views, generate manifests, Vite build)

Configuration

Publish the config:

php artisan vendor:publish --tag=orchestra-chrome-config

Key	Default	Env Variable	Description
`extension_path`	`chrome-extension/src`	—	Path to extension source
`websocket_port`	`3001`	`ORCHESTRA_WS_PORT`	WebSocket port for client
`http_port`	`3000`	`ORCHESTRA_HTTP_PORT`	HTTP port for health checks

Documentation

Full documentation is available in the docs/ directory:

Getting Started — Installation, configuration, quick start
Architecture — Build pipeline, plugin views, Vite aliases
Tools — MCP tool reference
Commands — Artisan command reference
Extension — TypeScript structure, side panel, IDE, transport
Configuration — Full config key reference
API Reference — Facades, services, plugin class

Development

# Install dependencies
composer install

# Run tests
composer test

# Format code
composer format

# Static analysis
composer check

# Lint
composer lint

License

MIT

orchestra-mcp / chrome

Maintainers

Details