What can you do with OrchestrUI?

OrchestrUI inspects a structured project profile, preserves compatible owners, and returns the smallest admissible UI composition with evidence for every decision.

Quick start

Requires Node.js 20+. Add the published read-only server to an MCP host:

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": ["-y", "orchestrui@latest"]
    }
  }
}

git clone --depth 1 https://github.com/ECD5A/OrchestrUI.git
cd OrchestrUI
bash scripts/install-codex.sh

git clone --depth 1 https://github.com/ECD5A/OrchestrUI.git
Set-Location OrchestrUI
powershell -ExecutionPolicy Bypass -File scripts\install-codex.ps1

git clone https://github.com/ECD5A/OrchestrUI.git
cd OrchestrUI
npm ci && npm run check
npm run benchmark

Use them from a frontend project:

$ui-library-router plan the smallest compatible UI stack.
$ui-orchestrator implement the approved plan.
$ui-quality-audit audit the rendered result.

What it returns

{
  "input_mode": "structured-profiles",
  "selected": ["bklit-ui"],
  "owners": {
    "base-system": "host:shadcn-ui",
    "data-visualization": "bklit-ui"
  },
  "rejected": [{ "id": "daisyui", "rule": "base-system-conflict" }]
}

The committed suite passes 50/50 structured scenarios, 8/8 independently specified adversarial goldens, and three project fixtures in CI.

Skills and MCP

ui-library-router — inspects the host and assigns role ownership.
ui-orchestrator — integrates approved pieces into one visual contract.
ui-quality-audit — checks coherence, accessibility, responsiveness, motion, performance, and licensing.
Read-only MCP — list_libraries, recommend_stack, get_library_guidance, search_components, get_install_instructions, and audit_plan.

Published through npm, the official MCP Registry, and versioned GitHub Releases. Local plugin configuration is in .mcp.json; setup, architecture, security, licensing, and contribution details live in docs/, SECURITY.md, THIRD_PARTY.md, and CONTRIBUTING.md.

The MCP surface is read-only and uses public upstream metadata; implementation code and third-party assets remain in the host project.

Ecosystems

Ecosystem	Role
Kokonut UI	selective React/shadcn product polish
React Bits	one signature creative effect
daisyUI	intentional Tailwind semantic base
Bklit UI	charts and data visualization
Anime.js	bespoke timeline, SVG, or scroll motion
Rive	licensed interactive vector/state-machine graphics
Magic UI	animated marketing enhancement

OrchestrUI is independent and is not affiliated with or endorsed by these upstream projects.

Support

If OrchestrUI helps your work, you can support its ongoing maintenance:

TON: pointoncurve.ton
Bitcoin (BTC): 1ECDSA1b4d5TcZHtqNpcxmY8pBH1GgHntN
USDT (TRC20): TUF4vPdB6QkjCvZq18rBL4Qj4dK5ihCN75

Contact

For questions about OrchestrUI, integration, consulting, or collaboration:

Install

Add OrchestrUI to your client. Pick the one you use.

claude mcp add orchestrui -- npx -y orchestrui

codex mcp add orchestrui -- npx -y orchestrui

amp mcp add orchestrui -- npx -y orchestrui

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"orchestrui","command":"npx","args":["-y","orchestrui"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "orchestrui": {
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "orchestrui": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "orchestrui"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "orchestrui": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "orchestrui"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y orchestrui

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation25/25
Maintenance19/25
Trust13/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 9 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.3.0Latest	Aug 22, 2026
0.2.1	Aug 22, 2026