@fragments-sdk/cli 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Conan McNicholl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# @fragments-sdk/cli
+
+CLI, MCP server, and dev tools for the Fragments design system. This is the single tool package — it includes the CLI commands, the MCP server for AI agents, the dev viewer, screenshot capture, visual diffing, and migration tools.
+
+## Install
+
+```bash
+npm install @fragments-sdk/cli
+```
+
+## CLI Usage
+
+```bash
+# Start the dev server
+fragments dev
+
+# Build fragments.json
+fragments build
+
+# Validate fragment files
+fragments validate
+
+# Generate AI-ready context
+fragments context
+
+# See all commands
+fragments --help
+```
+
+## MCP Server
+
+The MCP server gives AI agents (Claude Code, Claude Desktop, etc.) access to your design system.
+
+### With Claude Code
+
+Add to your Claude Code MCP settings (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "fragments": {
+      "command": "npx",
+      "args": ["@fragments-sdk/cli", "mcp"]
+    }
+  }
+}
+```
+
+Or run the dedicated binary:
+
+```bash
+npx fragments-mcp
+```
+
+Options:
+
+```
+-p, --project-root <path>  Project root directory (default: cwd)
+-u, --viewer-url <url>     Viewer URL (default: http://localhost:6006)
+```
+
+### How It Works
+
+1. Install a component library that ships `fragments.json` (e.g., `npm install @fragments-sdk/ui`)
+2. Add the MCP server to your AI tool
+3. The server reads `fragments.json` from the installed package and exposes component data to the AI agent
+
+The server searches for `fragments.json` in two places:
+- **Your project directory** (walks upward from cwd) — for library authors running `fragments build`
+- **Your package.json dependencies** — for consumers who installed a fragments-enabled package
+
+### Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `fragments_discover` | List components, suggest by use case, find alternatives, or get a full context summary |
+| `fragments_inspect` | Get detailed component info: props, usage guidelines, code examples — all in one call |
+| `fragments_recipe` | Search composition recipes (e.g., "Login Form", "Settings Page") |
+| `fragments_render` | Render a component screenshot, verify against baseline, or compare to Figma |
+| `fragments_fix` | Generate patches to fix token compliance issues |
+
+### Visual tools
+
+The `render` and `fix` tools require [Playwright](https://playwright.dev/). Install it separately if you need visual tools:
+
+```bash
+npm install playwright
+```
+
+These tools are optional. All other tools work without Playwright.
+
+## Programmatic Usage
+
+```typescript
+import { createMcpServer, startMcpServer } from '@fragments-sdk/cli/mcp';
+
+// Start with stdio transport (default)
+await startMcpServer({ projectRoot: process.cwd() });
+
+// Or create the server instance for custom transports
+const server = createMcpServer({ projectRoot: process.cwd() });
+```
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node