glyph-ai 0.3.2 → 0.3.3

package/README.md

@@ -2,68 +2,74 @@
 
 Design intelligence for the vibe coding era.
 
+**Vibe coding is design blind.** You can ship a working app in an afternoon. But Claude Code can't tell why your glass nav bar looks off, or why your app looks like Duolingo from Wish. And if you aren't a designer, it's a frustrating and time-consuming part of shipping products people love.
+
+Building beautiful UIs should be native to vibe coding. Glyph gives Claude Code and Cursor a sense of design so that this is possible.
+
+## What it does
+
+Glyph injects a design layer into your existing Claude Code or Cursor workflow. Point at a UI component or page, and it generates **design variations** in your desired aesthetic (minimal, bold, editorial, dashboard, warm) -- rendered live in a browser overlay so you can preview your options and pick your favorite.
+
 ## Install
 
-```
+```bash
 npx glyph init
 ```
 
-## What it does
-
-- Injects a browser overlay into your dev app (Next.js, Vite, CRA)
-- Starts a local server that serves the overlay and talks to Claude Code via MCP
-- Writes `.mcp.json` and `.cursor/mcp.json` so Claude Code and Cursor pick up the MCP server automatically
+That's it. Glyph writes `.mcp.json` and `.cursor/mcp.json` automatically so Claude Code and Cursor pick up the MCP server without any manual config.
 
-## Commands
+## How it works
 
 ```
-glyph init   Set up Glyph in the current project and start the server
-glyph stop   Stop the running Glyph server
+Your app (Next.js / Vite / CRA)
+  └── Glyph overlay (browser)
+        └── Glyph server (local, port 3013)
+              └── MCP → Claude Code / Cursor
+                    └── parallel variation runs
 ```
 
-## Development
+When you ask Claude Code to improve a component, Glyph returns a design brief with an opinionated taste layer, two-pass generation instructions, and a self-evaluation gate. Claude generates variations in parallel -- each with a distinct aesthetic personality -- previews them via screenshot, scores them against a rubric, and iterates before delivering. Results stream into the overlay one by one as they complete. Pick your favorite and click implement.
 
-### Quick start
+## Commands
 
 ```bash
-cd glyph
-pnpm install
-pnpm run dev:e2e
+glyph init   # Set up Glyph and start the server
+glyph stop   # Stop the server
 ```
 
-This starts three processes concurrently:
-- **Overlay** — Vite watch build (`packages/overlay/`)
-- **Server** — Express + WebSocket on `:3013` (`packages/server/`)
-- **Product app** — Next.js demo on `:3000` (`product/`)
+## Requirements
 
-Open `http://localhost:3000` — the overlay loads at the bottom of the page.
+- Node 18+
+- Claude Code or Cursor
 
-### Build only
+## Development
 
 ```bash
-pnpm run build          # builds overlay → server → cli
-pnpm run build:dist     # builds + bundles into packages/cli/bundled/
+cd glyph
+pnpm install
+pnpm run dev:e2e
 ```
 
-### Architecture
+Starts three processes concurrently:
 
-Variations are generated in **parallel** — 4 concurrent `claude -p` CLI calls, each producing 1 variation with a distinct personality (faithful, bold, minimal, creative). Results stream to the overlay one-by-one as they complete.
+| Process  | Location          | Description                                         |
+| -------- | ----------------- | --------------------------------------------------- |
+| Overlay  | packages/overlay/ | React + Tailwind browser overlay (Vite watch build) |
+| Server   | packages/server/  | Express + WebSocket + MCP on :3013                  |
+| Demo app | product/          | Next.js test app on :3000                           |
 
-| Package | Port | Purpose |
-|---------|------|---------|
-| `packages/overlay` | served from server | React + Tailwind browser overlay (IIFE bundle) |
-| `packages/server` | `GLYPH_PORT` or `3013` | Express HTTP + WebSocket + MCP server |
-| `packages/cli` | — | `npx glyph init` scaffolding |
-| `product/` | `3000` | Next.js demo app for testing |
+Open http://localhost:3000 -- the overlay loads at the bottom of the page.
 
-### Environment variables
+**Build:**
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `GLYPH_PORT` | `3013` | Server port |
-| `GLYPH_PROJECT_ROOT` | `process.cwd()` | Root of the user's project |
+```bash
+pnpm run build         # overlay → server → cli
+pnpm run build:dist    # builds + bundles into packages/cli/bundled/
+```
 
-## Requirements
+**Environment variables:**
 
-- Node 18+
-- Claude Code installed (for MCP integration)
+| Variable             | Default         | Description              |
+| -------------------- | --------------- | ------------------------ |
+| `GLYPH_PORT`         | `3013`          | Server port              |
+| `GLYPH_PROJECT_ROOT` | `process.cwd()` | Root of the user's project |

package/bundled/server/index.js

@@ -207,7 +207,7 @@ async function discardVariation() {
 // Routes
 // ---------------------------------------------------------------------------
 app.get('/health', (_req, res) => {
-    res.json({ status: 'ok', version: '0.3.2' });
+    res.json({ status: 'ok', version: '0.3.3' });
 });
 app.get('/overlay.js', (_req, res) => {
     console.log('[Glyph] Serving overlay.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glyph-ai",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "bin": {