About OrchestrUI
OrchestrUI provides deterministic UI policies, library discovery, and quality audits for coding agents. It uses structured project profiles to recommend a minimal compatible UI composition and provides evidence for its decisions.
Key features
- 01Inspect structured project profiles
- 02Assign UI library roles and ownership
- 03Recommend compatible UI compositions
- 04Search components and install guidance
- 05Audit plans and UI quality
- 06Provide coding-agent skills
Use cases
- 01Plan a frontend project's UI stack
- 02Integrate approved UI libraries
- 03Audit interface accessibility and responsiveness
MCP support
Its read-only MCP server offers project inspection, library listing, stack recommendations, library guidance, component search, installation instructions, and plan audits. It uses public upstream metadata.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
7Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| relative_path | string | No |
Details
From the project README
Deterministic UI policy and quality gates for coding agents.
Quick start · Output · Skills & MCP · Ecosystems · Docs
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"]
}
}
}
Install skills on macOS / Linux
git clone --depth 1 https://github.com/ECD5A/OrchestrUI.git
cd OrchestrUI
bash scripts/install-codex.sh
Install skills on Windows
git clone --depth 1 https://github.com/ECD5A/OrchestrUI.git
Set-Location OrchestrUI
powershell -ExecutionPolicy Bypass -File scripts\install-codex.ps1
Develop from source
git clone https://github.com/ECD5A/OrchestrUI.git
cd OrchestrUI
npm ci && npm run check
npm run benchmark
Contributions are welcome — see CONTRIBUTING.md for the short path from fork to PR.
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 —
inspect_project,list_libraries,recommend_stack,get_library_guidance,search_components,get_install_instructions, andaudit_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:
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.