# windcraft

**Design coherence layer for AI-assisted code generation.** Cursor, Claude Code, and friends write the code — `windcraft` keeps every page speaking the same design language by checking generated UI against your design tokens.

Runs **free and local** — no account, no cloud, no API key.

```bash
# scaffold tokens + config from a bundled starter theme (offline)
npx windcraft init --local

# scan your code against those tokens (exits non-zero on violations → CI gate)
npx windcraft check
```

## What's here

This is the open-source CLI, static analyzer, and MCP server:

- **`windcraft check`** — 8 design-drift rules (hard-coded colors, off-scale spacing, non-token fonts, missing empty/loading states, …), runs locally.
- **`windcraft mcp`** — a local MCP server so Cursor / Claude Code read your tokens and rules before they generate (`get_design_tokens`, `get_design_rules`, `validate_component_code`).
- **GitHub Action + pre-commit hook** — drop-in CI enforcement.

## MCP (Cursor / Claude Code)

```bash
claude mcp add windcraft -- npx windcraft mcp
```

`init` also writes a Claude skill to `.claude/skills/windcraft.md`.

## Hosted (optional)

[windcraft.io](https://windcraft.io) adds a shared, editable design system for teams: hosted catalog of component contracts and page patterns, token sync across repos, version history, and org-wide enforcement. The local CLI never sends your source code.

## License & trademarks

MIT. Independent and unaffiliated with the companies whose names inspired the bundled theme presets — see [TRADEMARKS.md](./TRADEMARKS.md).