onsystem
Flags hardcoded colours and unknown components in agent-written React UI code
- Pricing
- Open source
- Platforms
- CLI, vscode, self-hosted
- Runs
- Locally
- Version
- 0.12.1
- Listing updated
- 3 days ago
About onsystem
onsystem is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Coding agents write UI from training data, so a settings card tends to arrive with bg-[#ef4444], p-[13px], a native button and a variant your Button never had. onsystem reads your design-system package with the TypeScript compiler and checks the agent's .tsx and .jsx output against what actually exists.
Its MCP server shows the agent your components, cva and tv variants, parts and tokens before it writes, and a check_ui call returns findings with a rule id, a location and a fix. Rules named on the site include no-hardcoded-color, no-hardcoded-spacing, no-unknown-component, no-unknown-prop, no-unknown-variant, icon-button-accessible-name and prefer-design-system-component. Tokens can come from stylesheets, DTCG files or a DESIGN.md.
Checks run locally with no model calls; the site cites 1.8 ms on its demo file. A Claude Code plugin adds a hook that checks every edit, and a GitHub Action checks only the lines a pull request changes. Setup is done once in the design-system package so each app in a monorepo inherits it. It works with shadcn/ui, a custom package or MUI.
Install
Run in a terminal
claude mcp add onsystem -- npx -y onsystemAdd to claude_desktop_config.json
{
"mcpServers": {
"onsystem": {
"command": "npx",
"args": [
"-y",
"onsystem"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"onsystem": {
"command": "npx",
"args": [
"-y",
"onsystem"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"onsystem": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"onsystem"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"onsystem": {
"command": "npx",
"args": [
"-y",
"onsystem"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"onsystem": {
"command": "npx",
"args": [
"-y",
"onsystem"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- check_ui
- Check a file against the design system and return findings with fixes
What it does
- check_ui tool
- Returns findings with a rule id, location and suggested fix for a file.
- Design-system lookup
- Shows the agent your components, variants, parts and tokens before it writes UI.
- Edit-time hook
- The Claude Code plugin checks each edit the agent makes.
- Pull request check
- A GitHub Action checks only changed lines and fails on errors.
- Token sources
- Reads stylesheets, DTCG files or a DESIGN.md, and can export tokens back out.
- Runs locally
- No model calls; the check is a local static analysis.
Good for
- Stop agents from writing hex colours and arbitrary spacing in React components
- Catch invented variants or props before review
- Enforce a shared design system across every app in a monorepo
- Fail a pull request when agent-written UI bypasses the design system
Pricing
Open source
Free; runs locally. A licence badge is shown in the README.
Prices change. Check onsystem.vercel.app before you buy.
onsystem FAQ
Does it send my code to a model?
No. The site says it runs locally with no model calls.
Which design systems does it support?
The site names shadcn/ui, your own package or MUI.
How do I install it?
Run npx -y onsystem as a stdio server, or install the Claude Code plugin from the dgesteves marketplace.
Can it run in CI?
Yes, through the dgesteves/onsystem GitHub Action, which checks the lines a pull request changes.
Is onsystem free?
Yes. onsystem is open source, so you can use and self-host it for free.
How do I add onsystem to Claude Code?
Run this command in your terminal: claude mcp add onsystem -- npx -y onsystem
What are the best alternatives to onsystem?
The closest alternatives to onsystem are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to onsystem

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools