cue-ai 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cue-ai",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "cue — Agent Profile Manager for Claude Code & Codex. Pick a profile, launch with the right skills, MCPs, and plugins.",
   "type": "module",
   "bin": {

package/profiles/_types.ts

@@ -5,7 +5,7 @@
  *   import type { Profile, NpxSkillRef, MCPRef, SkillRef } from "../../profiles/_types";
  */
 
-export type AgentKind = "claude-code" | "codex";
+export type AgentKind = "claude-code" | "codex" | "cursor" | "cline" | "windsurf" | "gemini" | "copilot" | "roo" | "amp" | "aider";
 
 export interface AgentScoped {
   agents?: AgentKind[];

package/profiles/core/profile.yaml

@@ -9,7 +9,10 @@ skills:
     - meta/analyze
     - meta/cue-usage
     - meta/builtin-manager
+    - meta/kiro-powers
     - caveman/caveman
     - caveman/caveman-commit
+mcps:
+  - cue-tty-watch    # Claude's eyes inside X displays / tmux panes (screenshot, capture-pane, send-keys)
 plugins:
   - claude-mem@thedotmack

package/profiles/full/profile.yaml

@@ -6,7 +6,6 @@ skills:
   local:
     - "*/*"
 mcps:
-  - claude-mem
   - Higgsfield
   - colony
   - coolify
@@ -15,7 +14,6 @@ mcps:
   - hostinger-api
   - letsfg
   - marva-blog
-  - medusadocs
   - obsidian-vault
   - polymarket-live
   - recodee

package/profiles/{readme-writer-svg → readme-writer}/profile.yaml

@@ -1,13 +1,14 @@
-name: readme-writer-svg
+name: readme-writer
 icon: "🎨"
 description: "Beautiful README design with SVG diagrams — architecture flows, terminal mockups, and editorial visuals"
 inherits: core
 skills:
   local:
     - design/readme-svg-design
+    - design/headless-gif-demo
   npx:
     - repo: yizhiyanhua-ai/fireworks-tech-graph
       skills: [fireworks-tech-graph]
     - repo: cathrynlavery/diagram-design
       skills: [diagram-design]
-mcps: []
+mcps: []   # cue-tty-watch comes from core via inheritance

package/profiles/threejs/profile.yaml

@@ -0,0 +1,19 @@
+name: threejs
+icon: "🎲"
+description: "Three.js 3D development — geometry, materials, shaders, animation, postprocessing, and interaction"
+inherits: core
+skills:
+  npx:
+    - repo: CloudAI-X/threejs-skills
+      skills:
+        - threejs-fundamentals
+        - threejs-geometry
+        - threejs-materials
+        - threejs-lighting
+        - threejs-textures
+        - threejs-animation
+        - threejs-loaders
+        - threejs-shaders
+        - threejs-postprocessing
+        - threejs-interaction
+mcps: []

package/resources/mcps/configs/claude.sanitized.json

@@ -10,6 +10,9 @@
       "env": {
         "KROSCHUORDER_API_URL": "<redacted>"
       }
+    },
+    "cue-tty-watch": {
+      "command": "/home/deadpool/Documents/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
     }
   },
   "source": "claude",

package/resources/mcps/configs/claude_runtime.sanitized.json

@@ -110,6 +110,9 @@
         "~/Documents/soul/mcps/mcps/soul-skills/server.py"
       ],
       "command": "~/.local/bin/uv"
+    },
+    "cue-tty-watch": {
+      "command": "/home/deadpool/Documents/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
     }
   },
   "source": "claude_runtime",

package/resources/mcps/configs/codex.sanitized.json

@@ -79,6 +79,9 @@
       ],
       "command": "~/.local/bin/uv",
       "enabled": false
+    },
+    "cue-tty-watch": {
+      "command": "/home/deadpool/Documents/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
     }
   },
   "source": "codex",

package/resources/mcps/cue-tty-watch/README.md

@@ -0,0 +1,80 @@
+# cue-tty-watch
+
+> MCP server that gives Claude eyes inside X displays and tmux panes.
+
+Built for the kitty + Xvfb + tmux GIF-capture pipeline ([`scripts/record-demo-kitty.sh`](../../../scripts/record-demo-kitty.sh)) where the only way to know what the headless terminal is doing was to wait for a human to take a screenshot. With this MCP, Claude can `screenshot` and `tmux_pane` directly.
+
+## Tools
+
+| Tool | Purpose | Returns |
+|---|---|---|
+| `screenshot` | PNG of an X display (default `:99`) | Image |
+| `tmux_pane` | Rendered text of a tmux pane | Text |
+| `send_keys_tmux` | `tmux send-keys` into a pane | Text confirmation |
+| `send_keys_xdotool` | `xdotool key` to a window by class | Text confirmation |
+| `list_xwindows` | Windows on a display + their class/geom | Text table |
+
+## Requirements
+
+Already on most Linux dev boxes; install with `apt` if missing:
+
+```bash
+sudo apt install xvfb x11-apps imagemagick xdotool
+# tmux and bun should already be there
+```
+
+The `xwd` binary (from `x11-apps`) is what captures the display; ImageMagick's `convert` turns the XWD blob into PNG.
+
+## Install dependencies
+
+```bash
+cd resources/mcps/cue-tty-watch
+bun install
+```
+
+## Register with Claude Code
+
+Add to your `~/.claude.json` (or `~/.config/claude/claude.json`) under `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "cue-tty-watch": {
+      "command": "/absolute/path/to/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
+    }
+  }
+}
+```
+
+Then **restart Claude Code** for the MCP to load.
+
+## Register with cue profile
+
+Add to any profile's `profile.yaml` that needs it (typically `readme-writer` for demo recording):
+
+```yaml
+mcps:
+  - cue-tty-watch
+```
+
+## Usage from Claude
+
+Once registered, Claude can call:
+
+```
+screenshot(display=":99")                                    # → see what's on Xvfb
+tmux_pane(socket="cue-demo", session="demo")                 # → see what tmux is showing
+send_keys_tmux(socket="cue-demo", session="demo",
+               keys=["cue list", "Enter"])                   # → drive a demo
+list_xwindows(display=":99")                                 # → find a window by class
+```
+
+## Why this exists
+
+Claude Code's built-in tools (`Bash`, `Read`, `Write`, etc.) can run commands and read files but can't *see* a graphical session. When debugging the kitty-graphics GIF capture, every iteration meant: run script (~50 s), wait for a human screenshot, infer what went wrong, patch, repeat.
+
+With this MCP, the loop is: `send_keys → screenshot → adjust → send_keys → screenshot`, all inside one Claude turn.
+
+## License
+
+MIT (same as parent repo).

package/resources/mcps/cue-tty-watch/bin/cue-tty-watch

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# cue-tty-watch — launcher shim for the MCP server
+# Resolves the bun binary at run time so it works from any Claude Code session.
+
+set -e
+
+# Find bun: prefer ~/.bun/bin, then $PATH
+if [ -x "$HOME/.bun/bin/bun" ]; then
+    BUN="$HOME/.bun/bin/bun"
+elif command -v bun >/dev/null 2>&1; then
+    BUN="$(command -v bun)"
+else
+    echo "cue-tty-watch: bun not found — install from https://bun.sh" >&2
+    exit 1
+fi
+
+DIR="$(dirname "$(readlink -f "$0")")/.."
+exec "$BUN" run "$DIR/server.ts"

package/resources/mcps/cue-tty-watch/bun.lock

@@ -0,0 +1,198 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "cue-tty-watch",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.20.0",
+        "zod": "^3.23.0",
+      },
+    },
+  },
+  "packages": {
+    "@hono/node-server": ["@hono/node-server@1.19.14", "", { "peerDependencies": { "hono": "^4" } }, "sha512-GwtvgtXxnWsucXvbQXkRgqksiH2Qed37H9xHZocE5sA3N8O8O8/8FA3uclQXxXVzc9XBZuEOMK7+r02FmSpHtw=="],
+
+    "@modelcontextprotocol/sdk": ["@modelcontextprotocol/sdk@1.29.0", "", { "dependencies": { "@hono/node-server": "^1.19.9", "ajv": "^8.17.1", "ajv-formats": "^3.0.1", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.2.1", "express-rate-limit": "^8.2.1", "hono": "^4.11.4", "jose": "^6.1.3", "json-schema-typed": "^8.0.2", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.25 || ^4.0", "zod-to-json-schema": "^3.25.1" }, "peerDependencies": { "@cfworker/json-schema": "^4.1.1" }, "optionalPeers": ["@cfworker/json-schema"] }, "sha512-zo37mZA9hJWpULgkRpowewez1y6ML5GsXJPY8FI0tBBCd77HEvza4jDqRKOXgHNn867PVGCyTdzqpz0izu5ZjQ=="],
+
+    "accepts": ["accepts@2.0.0", "", { "dependencies": { "mime-types": "^3.0.0", "negotiator": "^1.0.0" } }, "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng=="],
+
+    "ajv": ["ajv@8.20.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA=="],
+
+    "ajv-formats": ["ajv-formats@3.0.1", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ=="],
+
+    "body-parser": ["body-parser@2.2.2", "", { "dependencies": { "bytes": "^3.1.2", "content-type": "^1.0.5", "debug": "^4.4.3", "http-errors": "^2.0.0", "iconv-lite": "^0.7.0", "on-finished": "^2.4.1", "qs": "^6.14.1", "raw-body": "^3.0.1", "type-is": "^2.0.1" } }, "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA=="],
+
+    "bytes": ["bytes@3.1.2", "", {}, "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg=="],
+
+    "call-bind-apply-helpers": ["call-bind-apply-helpers@1.0.2", "", { "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" } }, "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ=="],
+
+    "call-bound": ["call-bound@1.0.4", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "get-intrinsic": "^1.3.0" } }, "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg=="],
+
+    "content-disposition": ["content-disposition@1.1.0", "", {}, "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g=="],
+
+    "content-type": ["content-type@1.0.5", "", {}, "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA=="],
+
+    "cookie": ["cookie@0.7.2", "", {}, "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w=="],
+
+    "cookie-signature": ["cookie-signature@1.2.2", "", {}, "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg=="],
+
+    "cors": ["cors@2.8.6", "", { "dependencies": { "object-assign": "^4", "vary": "^1" } }, "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw=="],
+
+    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "depd": ["depd@2.0.0", "", {}, "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw=="],
+
+    "dunder-proto": ["dunder-proto@1.0.1", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", "gopd": "^1.2.0" } }, "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A=="],
+
+    "ee-first": ["ee-first@1.1.1", "", {}, "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow=="],
+
+    "encodeurl": ["encodeurl@2.0.0", "", {}, "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg=="],
+
+    "es-define-property": ["es-define-property@1.0.1", "", {}, "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g=="],
+
+    "es-errors": ["es-errors@1.3.0", "", {}, "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw=="],
+
+    "es-object-atoms": ["es-object-atoms@1.1.2", "", { "dependencies": { "es-errors": "^1.3.0" } }, "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw=="],
+
+    "escape-html": ["escape-html@1.0.3", "", {}, "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="],
+
+    "etag": ["etag@1.8.1", "", {}, "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg=="],
+
+    "eventsource": ["eventsource@3.0.7", "", { "dependencies": { "eventsource-parser": "^3.0.1" } }, "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA=="],
+
+    "eventsource-parser": ["eventsource-parser@3.0.8", "", {}, "sha512-70QWGkr4snxr0OXLRWsFLeRBIRPuQOvt4s8QYjmUlmlkyTZkRqS7EDVRZtzU3TiyDbXSzaOeF0XUKy8PchzukQ=="],
+
+    "express": ["express@5.2.1", "", { "dependencies": { "accepts": "^2.0.0", "body-parser": "^2.2.1", "content-disposition": "^1.0.0", "content-type": "^1.0.5", "cookie": "^0.7.1", "cookie-signature": "^1.2.1", "debug": "^4.4.0", "depd": "^2.0.0", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "finalhandler": "^2.1.0", "fresh": "^2.0.0", "http-errors": "^2.0.0", "merge-descriptors": "^2.0.0", "mime-types": "^3.0.0", "on-finished": "^2.4.1", "once": "^1.4.0", "parseurl": "^1.3.3", "proxy-addr": "^2.0.7", "qs": "^6.14.0", "range-parser": "^1.2.1", "router": "^2.2.0", "send": "^1.1.0", "serve-static": "^2.2.0", "statuses": "^2.0.1", "type-is": "^2.0.1", "vary": "^1.1.2" } }, "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw=="],
+
+    "express-rate-limit": ["express-rate-limit@8.5.2", "", { "dependencies": { "ip-address": "^10.2.0" }, "peerDependencies": { "express": ">= 4.11" } }, "sha512-5Kb34ipNX694DH48vN9irak1Qx30nb0PLYHXfJgw4YEjiC3ZEmZJhwOp+VfiCYwFzvFTdB9QkArYS5kXa2cx2A=="],
+
+    "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
+
+    "fast-uri": ["fast-uri@3.1.2", "", {}, "sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ=="],
+
+    "finalhandler": ["finalhandler@2.1.1", "", { "dependencies": { "debug": "^4.4.0", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "on-finished": "^2.4.1", "parseurl": "^1.3.3", "statuses": "^2.0.1" } }, "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA=="],
+
+    "forwarded": ["forwarded@0.2.0", "", {}, "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow=="],
+
+    "fresh": ["fresh@2.0.0", "", {}, "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A=="],
+
+    "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="],
+
+    "get-intrinsic": ["get-intrinsic@1.3.0", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", "hasown": "^2.0.2", "math-intrinsics": "^1.1.0" } }, "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ=="],
+
+    "get-proto": ["get-proto@1.0.1", "", { "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" } }, "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g=="],
+
+    "gopd": ["gopd@1.2.0", "", {}, "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="],
+
+    "has-symbols": ["has-symbols@1.1.0", "", {}, "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="],
+
+    "hasown": ["hasown@2.0.3", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg=="],
+
+    "hono": ["hono@4.12.22", "", {}, "sha512-7fvVPbB92zNRsQke+uiRGwtTuef0tB2Dg4hWxYfFNvkQhIltWoyi0ONReM5LWA+jJWS3nfT5lTq+qbsIpX0IQw=="],
+
+    "http-errors": ["http-errors@2.0.1", "", { "dependencies": { "depd": "~2.0.0", "inherits": "~2.0.4", "setprototypeof": "~1.2.0", "statuses": "~2.0.2", "toidentifier": "~1.0.1" } }, "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ=="],
+
+    "iconv-lite": ["iconv-lite@0.7.2", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw=="],
+
+    "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
+
+    "ip-address": ["ip-address@10.2.0", "", {}, "sha512-/+S6j4E9AHvW9SWMSEY9Xfy66O5PWvVEJ08O0y5JGyEKQpojb0K0GKpz/v5HJ/G0vi3D2sjGK78119oXZeE0qA=="],
+
+    "ipaddr.js": ["ipaddr.js@1.9.1", "", {}, "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g=="],
+
+    "is-promise": ["is-promise@4.0.0", "", {}, "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ=="],
+
+    "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
+
+    "jose": ["jose@6.2.3", "", {}, "sha512-YYVDInQKFJfR/xa3ojUTl8c2KoTwiL1R5Wg9YCydwH0x0B9grbzlg5HC7mMjCtUJjbQ/YnGEZIhI5tCgfTb4Hw=="],
+
+    "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
+
+    "json-schema-typed": ["json-schema-typed@8.0.2", "", {}, "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA=="],
+
+    "math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],
+
+    "media-typer": ["media-typer@1.1.0", "", {}, "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw=="],
+
+    "merge-descriptors": ["merge-descriptors@2.0.0", "", {}, "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g=="],
+
+    "mime-db": ["mime-db@1.54.0", "", {}, "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ=="],
+
+    "mime-types": ["mime-types@3.0.2", "", { "dependencies": { "mime-db": "^1.54.0" } }, "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "negotiator": ["negotiator@1.0.0", "", {}, "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg=="],
+
+    "object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="],
+
+    "object-inspect": ["object-inspect@1.13.4", "", {}, "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew=="],
+
+    "on-finished": ["on-finished@2.4.1", "", { "dependencies": { "ee-first": "1.1.1" } }, "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg=="],
+
+    "once": ["once@1.4.0", "", { "dependencies": { "wrappy": "1" } }, "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w=="],
+
+    "parseurl": ["parseurl@1.3.3", "", {}, "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ=="],
+
+    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
+
+    "path-to-regexp": ["path-to-regexp@8.4.2", "", {}, "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA=="],
+
+    "pkce-challenge": ["pkce-challenge@5.0.1", "", {}, "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ=="],
+
+    "proxy-addr": ["proxy-addr@2.0.7", "", { "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" } }, "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg=="],
+
+    "qs": ["qs@6.15.2", "", { "dependencies": { "side-channel": "^1.1.0" } }, "sha512-Rzq0KEyX/w/tEybncDgdkZrJgVUsUMk3xjh3t5bv3S1HTAtg+uOYt72+ZfwiQwKdysThkTBdL/rTi6HDmX9Ddw=="],
+
+    "range-parser": ["range-parser@1.2.1", "", {}, "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg=="],
+
+    "raw-body": ["raw-body@3.0.2", "", { "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", "iconv-lite": "~0.7.0", "unpipe": "~1.0.0" } }, "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA=="],
+
+    "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="],
+
+    "router": ["router@2.2.0", "", { "dependencies": { "debug": "^4.4.0", "depd": "^2.0.0", "is-promise": "^4.0.0", "parseurl": "^1.3.3", "path-to-regexp": "^8.0.0" } }, "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ=="],
+
+    "safer-buffer": ["safer-buffer@2.1.2", "", {}, "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="],
+
+    "send": ["send@1.2.1", "", { "dependencies": { "debug": "^4.4.3", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "fresh": "^2.0.0", "http-errors": "^2.0.1", "mime-types": "^3.0.2", "ms": "^2.1.3", "on-finished": "^2.4.1", "range-parser": "^1.2.1", "statuses": "^2.0.2" } }, "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ=="],
+
+    "serve-static": ["serve-static@2.2.1", "", { "dependencies": { "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "parseurl": "^1.3.3", "send": "^1.2.0" } }, "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw=="],
+
+    "setprototypeof": ["setprototypeof@1.2.0", "", {}, "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw=="],
+
+    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
+
+    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
+
+    "side-channel": ["side-channel@1.1.0", "", { "dependencies": { "es-errors": "^1.3.0", "object-inspect": "^1.13.3", "side-channel-list": "^1.0.0", "side-channel-map": "^1.0.1", "side-channel-weakmap": "^1.0.2" } }, "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw=="],
+
+    "side-channel-list": ["side-channel-list@1.0.1", "", { "dependencies": { "es-errors": "^1.3.0", "object-inspect": "^1.13.4" } }, "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w=="],
+
+    "side-channel-map": ["side-channel-map@1.0.1", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "get-intrinsic": "^1.2.5", "object-inspect": "^1.13.3" } }, "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA=="],
+
+    "side-channel-weakmap": ["side-channel-weakmap@1.0.2", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "get-intrinsic": "^1.2.5", "object-inspect": "^1.13.3", "side-channel-map": "^1.0.1" } }, "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A=="],
+
+    "statuses": ["statuses@2.0.2", "", {}, "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw=="],
+
+    "toidentifier": ["toidentifier@1.0.1", "", {}, "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA=="],
+
+    "type-is": ["type-is@2.1.0", "", { "dependencies": { "content-type": "^2.0.0", "media-typer": "^1.1.0", "mime-types": "^3.0.0" } }, "sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA=="],
+
+    "unpipe": ["unpipe@1.0.0", "", {}, "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ=="],
+
+    "vary": ["vary@1.1.2", "", {}, "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg=="],
+
+    "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
+
+    "wrappy": ["wrappy@1.0.2", "", {}, "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="],
+
+    "zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
+
+    "zod-to-json-schema": ["zod-to-json-schema@3.25.2", "", { "peerDependencies": { "zod": "^3.25.28 || ^4" } }, "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA=="],
+
+    "type-is/content-type": ["content-type@2.0.0", "", {}, "sha512-j/O/d7GcZCyNl7/hwZAb606rzqkyvaDctLmckbxLzHvFBzTJHuGEdodATcP3yIRoDrLHkIATJuvzbFlp/ki2cQ=="],
+  }
+}

package/resources/mcps/cue-tty-watch/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "cue-tty-watch",
+  "version": "0.1.0",
+  "description": "MCP server giving Claude eyes inside X displays, tmux panes, and Xvfb sessions — screenshot, capture-pane, send-keys.",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "start": "bun server.ts"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "zod": "^3.23.0"
+  }
+}

package/resources/mcps/cue-tty-watch/server.ts

@@ -0,0 +1,181 @@
+#!/usr/bin/env bun
+/**
+ * cue-tty-watch — MCP server giving Claude eyes inside X displays and tmux panes.
+ *
+ * Tools:
+ *   screenshot          → PNG of an X display (default :99 for Xvfb capture flows)
+ *   tmux_pane           → text contents of a tmux pane
+ *   send_keys_tmux      → tmux send-keys (Enter, Up, Down, "literal text", etc.)
+ *   send_keys_xdotool   → xdotool key against a window by --class
+ *   list_xwindows       → enumerate windows + their class on a display
+ *
+ * Designed for the kitty + Xvfb + tmux demo-capture pipeline in scripts/record-demo-kitty.sh.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { spawnSync } from "node:child_process";
+import { z } from "zod";
+
+const server = new McpServer(
+  { name: "cue-tty-watch", version: "0.1.0" },
+  { capabilities: { tools: {} } }
+);
+
+// ─── helpers ─────────────────────────────────────────────────────────────────
+
+const MAX_BUF = 100 * 1024 * 1024;
+
+function err(text: string) {
+  return { content: [{ type: "text" as const, text }], isError: true };
+}
+
+function text(text: string) {
+  return { content: [{ type: "text" as const, text }] };
+}
+
+function image(base64: string) {
+  return { content: [{ type: "image" as const, data: base64, mimeType: "image/png" }] };
+}
+
+// ─── 1. screenshot ───────────────────────────────────────────────────────────
+
+server.tool(
+  "screenshot",
+  "Capture a frame of an X display as a PNG. Use this to SEE what's actually rendering inside a kitty/tmux/Xvfb session. Default display ':99' matches the Xvfb capture pipeline in scripts/record-demo-kitty.sh. Image is downscaled to max 1400px width to keep payload reasonable.",
+  {
+    display: z.string().default(":99").describe("X display, e.g. ':99' (Xvfb) or ':0' (real)"),
+    max_width: z.number().int().min(200).max(2400).default(1400).describe("Resize to at most this width"),
+  },
+  async ({ display, max_width }) => {
+    const xwd = spawnSync("xwd", ["-root", "-silent", "-display", display], {
+      stdio: ["ignore", "pipe", "pipe"],
+      maxBuffer: MAX_BUF,
+    });
+    if (xwd.status !== 0) return err(`xwd failed (display ${display}): ${xwd.stderr?.toString() ?? "no output"}`);
+
+    const conv = spawnSync("convert", ["xwd:-", "-resize", `${max_width}>`, "png:-"], {
+      input: xwd.stdout,
+      stdio: ["pipe", "pipe", "pipe"],
+      maxBuffer: MAX_BUF,
+    });
+    if (conv.status !== 0) return err(`ImageMagick convert failed: ${conv.stderr?.toString() ?? "no output"}`);
+
+    return image(conv.stdout.toString("base64"));
+  }
+);
+
+// ─── 2. tmux_pane ────────────────────────────────────────────────────────────
+
+server.tool(
+  "tmux_pane",
+  "Read the current rendered text of a tmux pane. Use to verify what command was typed, what output appeared, whether a prompt is waiting.",
+  {
+    socket: z.string().default("").describe("tmux -L socket name (e.g. 'cue-demo'). Empty = default socket."),
+    session: z.string().describe("Session name, e.g. 'demo'"),
+    target: z.string().default("0").describe("Window.pane target, e.g. '0' or '0.1'"),
+    history_lines: z.number().int().min(0).max(5000).default(0).describe("Include this many scrollback lines (0 = visible only)"),
+  },
+  async ({ socket, session, target, history_lines }) => {
+    const args: string[] = [];
+    if (socket) args.push("-L", socket);
+    args.push("capture-pane", "-p", "-t", `${session}:${target}`);
+    if (history_lines > 0) args.push("-S", `-${history_lines}`);
+
+    const res = spawnSync("tmux", args, { encoding: "utf8" });
+    if (res.status !== 0) return err(`tmux capture-pane failed: ${res.stderr}`);
+    return text(res.stdout || "(empty pane)");
+  }
+);
+
+// ─── 3. send_keys_tmux ───────────────────────────────────────────────────────
+
+server.tool(
+  "send_keys_tmux",
+  "Send keystrokes into a tmux pane via tmux send-keys. Each item in 'keys' is a separate argument: 'Enter', 'Up', 'Down', 'C-c', 'BSpace', or literal text strings.",
+  {
+    socket: z.string().default("").describe("tmux -L socket name. Empty = default socket."),
+    session: z.string().describe("Session name"),
+    target: z.string().default("0").describe("Window.pane target"),
+    keys: z.array(z.string()).min(1).describe("Array of args passed to tmux send-keys. Example: ['echo hi', 'Enter']"),
+  },
+  async ({ socket, session, target, keys }) => {
+    const args: string[] = [];
+    if (socket) args.push("-L", socket);
+    args.push("send-keys", "-t", `${session}:${target}`, ...keys);
+
+    const res = spawnSync("tmux", args, { encoding: "utf8" });
+    if (res.status !== 0) return err(`tmux send-keys failed: ${res.stderr}`);
+    return text(`sent ${keys.length} arg(s) to ${session}:${target}`);
+  }
+);
+
+// ─── 4. send_keys_xdotool ────────────────────────────────────────────────────
+
+server.tool(
+  "send_keys_xdotool",
+  "Send keystrokes directly to an X window matched by WM_CLASS. Use when targeting a kitty window before tmux is attached, or for keys tmux can't pass cleanly.",
+  {
+    display: z.string().default(":99"),
+    window_class: z.string().describe("WM_CLASS to match (e.g. 'cue-demo')"),
+    keys: z.array(z.string()).min(1).describe("xdotool key specs, e.g. ['Down', 'Down', 'Return']"),
+    delay_ms: z.number().int().min(0).max(2000).default(80).describe("Inter-key delay"),
+  },
+  async ({ display, window_class, keys, delay_ms }) => {
+    const env = { ...process.env, DISPLAY: display };
+    const find = spawnSync("xdotool", ["search", "--class", window_class], { env, encoding: "utf8" });
+    if (find.status !== 0 || !find.stdout.trim()) {
+      return err(`No window matching class '${window_class}' on display ${display}`);
+    }
+    const wid = find.stdout.trim().split("\n")[0]!;
+
+    for (const k of keys) {
+      const r = spawnSync("xdotool", ["key", "--window", wid, "--delay", String(delay_ms), k], { env });
+      if (r.status !== 0) return err(`xdotool key '${k}' failed`);
+    }
+    return text(`sent ${keys.length} key(s) to window ${wid} (class=${window_class})`);
+  }
+);
+
+// ─── 5. list_xwindows ────────────────────────────────────────────────────────
+
+server.tool(
+  "list_xwindows",
+  "List X windows on a display with their class and geometry. Use to find the right window_class before sending keys.",
+  {
+    display: z.string().default(":99"),
+  },
+  async ({ display }) => {
+    const env = { ...process.env, DISPLAY: display };
+    const search = spawnSync("xdotool", ["search", ".*"], { env, encoding: "utf8" });
+    if (search.status !== 0) return err(`xdotool search failed: ${search.stderr}`);
+
+    const wids = search.stdout.trim().split("\n").filter(Boolean);
+    if (!wids.length) return text("(no windows)");
+
+    const rows: string[] = [];
+    rows.push("WID         CLASS                          GEOMETRY");
+    for (const wid of wids) {
+      const cls = spawnSync("xdotool", ["getwindowclassname", wid], { env, encoding: "utf8" });
+      const geo = spawnSync("xdotool", ["getwindowgeometry", "--shell", wid], { env, encoding: "utf8" });
+      const className = (cls.stdout || "").trim();
+      if (!className) continue; // skip unmapped / decoration-only windows
+
+      const geoVars: Record<string, string> = {};
+      for (const line of (geo.stdout || "").split("\n")) {
+        const m = line.match(/^(\w+)=(.+)$/);
+        if (m) geoVars[m[1]!] = m[2]!;
+      }
+      const geomStr = geoVars.WIDTH && geoVars.HEIGHT
+        ? `${geoVars.WIDTH}x${geoVars.HEIGHT}+${geoVars.X ?? "?"}+${geoVars.Y ?? "?"}`
+        : "?";
+      rows.push(`${wid.padEnd(11)} ${className.padEnd(30)} ${geomStr}`);
+    }
+    return text(rows.join("\n"));
+  }
+);
+
+// ─── start ───────────────────────────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);