Website  ·  Docs  ·  Showcase  ·  Install  ·  Contribute  ·  Book a 20-minute intro call

A free, open-source (MIT) add-on for your AI coding tool. It gives your product one design system and checks every screen against it.

Two ways in

Fix what you built. It audits every button, font, size, color and alignment on your pages, marks each problem with the rule it breaks, and fixes it after your yes.

Build a system. It reads your repo, studies your competitors, proposes a positioning and three directions, then writes the rules your AI follows.

Every round

• A plan you sign off, step by step, written to opendesigner/PROTOCOL.md so any AI follows it.
• Checks before you see it: contrast, tap targets, type scale, letter-spacing, alignment, buttons, text over images.
• Screenshots, before and after. Not a link to open.
• Your notes stick. Say something twice and it becomes a rule.

What lands in your repo

DESIGN.md, PRODUCT.md, design tokens (DTCG), CSS, Tailwind, Figma, Swift and Compose exports, and a log of every choice with its reason.

Quickstart

1. Add OpenDesigner to your AI tool. Pick yours below.
2. Open your project and say: "Create a design system for this project."
3. Answer a few short questions. It reads your files first, so it asks less.

Claude Code

/plugin marketplace add ckryptickunal/OpenDesigner
/plugin install opendesigner@opendesigner

Claude app (claude.ai or Desktop)

Build the skill zip, then upload dist/opendesigner.zip under Customize > Skills. Code execution must be on.

git clone https://github.com/ckryptickunal/OpenDesigner && cd OpenDesigner
python3 tools/build_dist.py        # writes the zip files into dist/

Codex, Cursor, VS Code with Copilot, Gemini CLI and other agents

These tools read skills from .agents/skills/. Copy the OpenDesigner skills into your project. Tools that support Agent Plugins can also read the root plugin.json.

git clone https://github.com/ckryptickunal/OpenDesigner
mkdir -p your-project/.agents/skills
cp -R OpenDesigner/.agents/skills/opendesigner* your-project/.agents/skills/

ChatGPT (web, any plan, nothing to install)

1. Create a Project.
2. Paste chatgpt-project/instructions.md (the part below its line) into the Project instructions.
3. Upload the five files in chatgpt-project/knowledge/.

No AI at all (the engine on its own)

The engine is one Python file (Python 3.10 or newer, nothing to install). It writes DESIGN.md, PRODUCT.md and an opendesigner/ folder with tokens, exports and an overview page.

python3 path/to/OpenDesigner/skills/opendesigner/scripts/engine.py sketch --name "Acme" --feel friendly,minimal

You need your own AI tool and Python 3.10 or newer. The engine makes no network calls (privacy). Help for each tool: install guide.

Component library

82 ready-made parts built only on your tokens. Optional. Browse them.

Status

• Version 0.2.0, the first tagged release, 5 November 2026. One maintainer.
• Engine tests pass locally. No CI runs, and no watched user trials yet.
• Next: choices you can click inside your AI tool (#20).

Changelog · How it works · Research behind the defaults · Showcase

Help it get better

Tell your AI what went wrong. It saves the note and gives you a ready-to-file GitHub link; nothing is posted until you send it. Or open an issue. Contributions: CONTRIBUTING.md. Sponsorship: docs/SPONSORSHIP.md.

Star history

License

Code, skills, templates and data files are under the MIT license. Written research and documentation are under CC BY 4.0, so you can reuse them with credit. That covers research/, benchmarks/, sources/, traces/, synthesis/ Markdown and docs/. Product and design-system names in the research belong to their owners. The tool marks in the "works in" row belong to their owners and only show where OpenDesigner runs (from Simple Icons, CC0). Photos in the README images are from Unsplash: Philipp Hubert (banner), Sean Fahrenbruch (how it works), and Photoholgic, Annie Spratt and Harshal Tandel (examples).

To cite OpenDesigner or its research, use CITATION.cff (GitHub's "Cite this repository" button).