Integration
Gemini CLI does the work. Windcraft keeps the design language fixed.
The Gemini CLI brings an agentic coder to your terminal with a large context window. Big context is not the same as your design values — it still guesses radii and colors. Windcraft gives it a local MCP server to read them from.
Why a big context window is not a design system
It is tempting to think a million-token window removes the need for structure — just show the model everything. But more context does not make a guess into a value: the model still has to infer "our blue" from examples, and inference varies run to run. Worse, dumping your whole UI into context to keep it consistent is expensive and noisy. Windcraft serves the exact values on demand instead.
How Windcraft plugs into Gemini CLI
The Gemini CLI reads MCP servers from its settings file. Declare Windcraft and Gemini can fetch the precise tokens, contract, and pattern for what it is building, rather than re-deriving them from a large but lossy context.
- Run npx windcraft init in your repo to generate the config.
- Add the Windcraft server under mcpServers in ~/.gemini/settings.json.
- Gemini calls get_design_tokens / get_component_contract / get_page_pattern as it works.
- Run npx windcraft check to flag any drift before you commit.
Gemini CLI MCP config (~/.gemini/settings.json)
{
"mcpServers": {
"windcraft": {
"command": "npx",
"args": ["windcraft", "mcp"]
}
}
}FAQ
- Why use MCP when Gemini has a huge context window?
- Because retrieval beats inference for exact values. A large window lets the model see your code, but it still infers the design language from examples — and inference drifts. Windcraft returns the literal radius and hex deterministically, and costs no context to do it.
- Does it work in scripted / non-interactive runs?
- Yes. The server launches on demand via npx, and npx windcraft check --json gives a machine-readable report you can gate automated runs on.
- Does my source code leave my machine?
- No. The server and analyzer run locally. Only metadata — tokens, contracts, rule violations — is synced to the cloud.