nodmix 2026.5.25

package/skills/canvas/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: canvas
+description: "Present HTML on connected Nodmix node canvases, navigate/eval/snapshot, and debug canvas host URLs."
+metadata: { "nodmix": { "emoji": "🖼️" } }
+---
+
+# Canvas
+
+Use canvas to show HTML on connected Mac/iOS/Android nodes.
+
+## Model
+
+- Canvas host serves files from `plugins.entries.canvas.config.host.root`.
+- Canvas routes live on the Gateway HTTP port (`gateway.port`, default `18789`).
+- Node bridge sends canvas URLs to connected node apps.
+- Node apps render URLs in a WebView.
+- Host name follows `gateway.bind`: loopback local only, LAN IP for LAN, Tailscale host for tailnet, auto picks best route.
+- Localhost URLs only work for a node on the same machine.
+- Paired nodes normally receive node-scoped `pluginSurfaceUrls.canvas` capability URLs; prefer those when available.
+
+## Config
+
+Active config: `$NODMIX_CONFIG_PATH` or `~/.nodmix/nodmix.json`.
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "canvas": {
+        "config": {
+          "host": {
+            "enabled": true,
+            "root": "~/.nodmix/canvas",
+            "liveReload": true
+          }
+        }
+      }
+    }
+  },
+  "gateway": { "bind": "auto" }
+}
+```
+
+## Actions
+
+- `present`: show canvas, optional URL.
+- `hide`: hide canvas.
+- `navigate`: open new URL.
+- `eval`: run JavaScript in current canvas.
+- `snapshot`: capture screenshot.
+
+## Workflow
+
+1. Ensure Canvas plugin host is enabled.
+2. Put HTML/CSS/JS under `plugins.entries.canvas.config.host.root` or the default state canvas dir.
+3. Use a route reachable by the target node.
+4. Present the hosted URL: `/__nodmix__/canvas/<file>.html`.
+5. Use `snapshot` when the user needs proof.
+
+## URL shape
+
+```text
+http://<gateway-host>:<gateway.port>/__nodmix__/canvas/index.html
+http://<gateway-host>:<gateway.port>/__nodmix__/canvas/games/snake.html
+```
+
+Path mapping:
+
+- `/__nodmix__/canvas/index.html` -> `<canvas host root>/index.html`
+- `/__nodmix__/canvas/games/snake.html` -> `<canvas host root>/games/snake.html`
+
+## Troubleshooting
+
+- Node sees localhost but is remote: fix `gateway.bind` or public URL, regenerate URL.
+- LAN node cannot load: verify same network, firewall, Gateway port, and auth/capability URL.
+- Tailnet node cannot load: verify Tailscale status and advertised host.
+- Blank page: open URL locally, check browser console, then snapshot node.
+- Live reload missing: verify `liveReload` and file write under root.

package/skills/clawhub/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: clawhub
+description: "Search, install, update, sync, or publish agent skills with the ClawHub CLI and registry."
+metadata:
+  {
+    "nodmix":
+      {
+        "requires": { "bins": ["clawhub"] },
+        "install":
+          [
+            {
+              "id": "node",
+              "kind": "node",
+              "package": "clawhub",
+              "bins": ["clawhub"],
+              "label": "Install ClawHub CLI (npm)",
+            },
+          ],
+      },
+  }
+---
+
+# ClawHub CLI
+
+Install
+
+```bash
+npm i -g clawhub
+```
+
+Auth (publish)
+
+```bash
+clawhub login
+clawhub whoami
+```
+
+Search
+
+```bash
+clawhub search "postgres backups"
+```
+
+Install
+
+```bash
+clawhub install my-skill
+clawhub install my-skill --version 1.2.3
+```
+
+Update (hash-based match + upgrade)
+
+```bash
+clawhub update my-skill
+clawhub update my-skill --version 1.2.3
+clawhub update --all
+clawhub update my-skill --force
+clawhub update --all --no-input --force
+```
+
+List
+
+```bash
+clawhub list
+```
+
+Publish
+
+```bash
+clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
+```
+
+Notes
+
+- Default registry: https://clawhub.com (override with CLAWHUB_REGISTRY or --registry)
+- Default workdir: cwd (falls back to Nodmix workspace); install dir: ./skills (override with --workdir / --dir / CLAWHUB_WORKDIR)
+- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set

package/skills/coding-agent/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: coding-agent
+description: "Delegate coding work to Codex, Claude Code, OpenCode, or Pi as background workers; not simple edits or read-only code lookup."
+metadata:
+  {
+    "nodmix":
+      {
+        "emoji": "🧩",
+        "requires":
+          {
+            "anyBins": ["claude", "codex", "opencode", "pi"],
+            "config": ["skills.entries.coding-agent.enabled"],
+          },
+        "install":
+          [
+            {
+              "id": "node-claude",
+              "kind": "node",
+              "package": "@anthropic-ai/claude-code",
+              "bins": ["claude"],
+              "label": "Install Claude Code CLI (npm)",
+            },
+            {
+              "id": "node-codex",
+              "kind": "node",
+              "package": "@openai/codex",
+              "bins": ["codex"],
+              "label": "Install Codex CLI (npm)",
+            },
+          ],
+      },
+  }
+---
+
+# Coding Agent
+
+Use for background feature builds, PR reviews, large refactors, and issue-to-PR loops. Do not use for simple edits, read-only lookup, ACP thread-bound work, or any run inside `~/.nodmix`, `$NODMIX_STATE_DIR`, or active Nodmix state dirs.
+
+## Hard rules
+
+- Always launch with `background:true`.
+- Codex, Pi, OpenCode: use `pty:true`.
+- Claude Code: no PTY; use `claude --permission-mode bypassPermissions --print`.
+- Capture a real notification route before spawning.
+- Worker must send completion/failure via `nodmix message send`.
+- Do not rely on heartbeat, system events, or notify-on-exit.
+- Monitor with `process`; do not kill slow workers without cause.
+- If user asked for a specific agent, use that agent.
+- If worker fails/hangs, respawn or ask; do not silently hand-code instead.
+- Never checkout branches or run background coding agents in `~/Projects/nodmix`; use an isolated checkout.
+
+## Notification block
+
+Append this shape to every worker prompt with real values:
+
+```text
+Notification route:
+- channel: <notifyChannel>
+- target: <notifyTarget>
+- account: <notifyAccount or omit>
+- reply_to: <notifyReplyTo or omit>
+- thread_id: <notifyThreadId or omit>
+
+When finished, send exactly one completion or failure message using:
+nodmix message send --channel <channel> --target '<target>' --message '<brief result>'
+Add --account, --reply-to, or --thread-id only when present above.
+Do not use nodmix system event or heartbeat.
+```
+
+If no trustworthy route exists, say completion auto-notify is unavailable.
+
+## Launch forms
+
+Write the worker prompt to a temp file first. This avoids shell quoting bugs when the required notification block contains quotes or newlines.
+
+```bash
+PROMPT=$(mktemp -t nodmix-worker-prompt.XXXXXX)
+cat >"$PROMPT" <<'EOF'
+Task.
+<notification block>
+EOF
+printf 'prompt file: %s\n' "$PROMPT"
+```
+
+Use `$PROMPT` when launching from the same shell/session. If using a separate tool call, substitute the printed path.
+
+Codex:
+
+```bash
+bash pty:true background:true workdir:/path/repo command:"codex exec - < \"$PROMPT\""
+```
+
+Claude Code:
+
+```bash
+bash background:true workdir:/path/repo command:"claude --permission-mode bypassPermissions --print < \"$PROMPT\""
+```
+
+OpenCode:
+
+```bash
+bash pty:true background:true workdir:/path/repo command:"opencode run < \"$PROMPT\""
+```
+
+Pi:
+
+```bash
+bash pty:true background:true workdir:/path/repo command:"pi -p \"$(cat \"$PROMPT\")\""
+```
+
+## Long issue-to-PR work
+
+1. Create/reuse a GitHub issue as durable spec.
+2. Include issue URL, repo, base branch, expected PR, proof, and notification route.
+3. Tell worker to branch, implement, test, run review until no accepted actionable findings, open PR.
+4. Return issue URL and `sessionId` immediately.
+5. Monitor with `process`; cancel through Task Registry if mirrored there.
+
+## Scratch Codex
+
+Codex needs a trusted git repo:
+
+```bash
+SCRATCH=$(mktemp -d)
+git -C "$SCRATCH" init
+PROMPT=$(mktemp -t nodmix-worker-prompt.XXXXXX)
+cat >"$PROMPT" <<'EOF'
+Build X.
+<notification block>
+EOF
+printf 'prompt file: %s\n' "$PROMPT"
+bash pty:true background:true workdir:$SCRATCH command:"codex exec - < \"$PROMPT\""
+```
+
+## Process actions
+
+- `list`: running/recent sessions.
+- `poll`: status.
+- `log`: output.
+- `submit`: send input + Enter.
+- `write`: raw stdin.
+- `paste`: paste text.
+- `kill`: terminate.
+
+## Status to user
+
+- Say what started, where, and `sessionId`.
+- Update only on milestone, worker question, error, user action needed, or finish.
+- If killed, say why.

package/skills/diagram-maker/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: diagram-maker
+description: Create SVG/HTML or Excalidraw diagrams for concepts, architecture, flows, and whiteboards.
+metadata: { "nodmix": { "emoji": "🧭" } }
+---
+
+# Diagram Maker
+
+Create diagrams as artifacts, not prose. Choose one output mode:
+
+- `clean-svg`: educational concepts, physical systems, processes, lifecycle, simple data flow.
+- `architecture-svg`: software/cloud/infra topology, services, databases, queues, trust zones.
+- `excalidraw`: editable hand-drawn whiteboard, flowchart, sequence, architecture sketch.
+
+Routing
+
+- User wants editable/collaborative: choose Excalidraw.
+- User wants polished standalone browser output: choose SVG/HTML.
+- Software architecture with infra components: choose architecture SVG.
+- Science, product, process, concept map, physical object: choose clean SVG.
+- Unsure: ask one short question only if output format matters; otherwise choose clean SVG.
+
+Workflow
+
+1. Extract nodes, groups, labels, and directed relationships.
+2. Pick layout first: left-to-right, top-down, hub-spoke, swimlanes, layered stack, sequence.
+3. Keep labels short. Prefer 5-9 main elements over dense diagrams.
+4. Generate the file at the requested path, or `./diagram.html` / `./diagram.excalidraw`.
+5. Verify syntax by opening/parsing when feasible.
+
+SVG/HTML rules
+
+- Single standalone `.html` file with inline CSS and inline SVG.
+- No external fonts, JS, images, gradients, glows, decorative blobs, or remote assets.
+- Use semantic colors, not rainbow sequences: neutral, input, process, storage, external, risk.
+- Draw connectors before nodes so arrows sit behind boxes.
+- Every connector path has `fill="none"` and a marker arrow when directed.
+- Leave 24px text padding inside boxes; do not let text touch borders.
+- Legend only when symbols/colors are not obvious.
+
+SVG template
+
+Use `references/svg-template.md` as the wrapper and replace `<!-- SVG -->`.
+
+Excalidraw rules
+
+- Save `.excalidraw` JSON with `type`, `version`, `source`, `elements`, and `appState`.
+- Use bound text for shape labels. Do not use a nonstandard `label` property.
+- Keep bound text immediately after its container in the elements array.
+- Minimum labeled shape: 120x60. Minimum body text: 16px.
+- Use roughness `1`, `fontFamily: 1`, and simple fills.
+
+For exact Excalidraw element snippets, read `references/excalidraw-patterns.md`.

package/skills/diagram-maker/references/excalidraw-patterns.md

@@ -0,0 +1,85 @@
+# Excalidraw Patterns
+
+Envelope:
+
+```json
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "nodmix/diagram-maker",
+  "elements": [],
+  "appState": { "viewBackgroundColor": "#ffffff" }
+}
+```
+
+Labeled rounded rectangle:
+
+```json
+{
+  "type": "rectangle",
+  "id": "svc",
+  "x": 100,
+  "y": 100,
+  "width": 180,
+  "height": 72,
+  "roundness": { "type": 3 },
+  "backgroundColor": "#a5d8ff",
+  "fillStyle": "solid",
+  "strokeWidth": 2,
+  "roughness": 1,
+  "opacity": 100,
+  "boundElements": [{ "id": "svc_text", "type": "text" }]
+}
+```
+
+Bound text:
+
+```json
+{
+  "type": "text",
+  "id": "svc_text",
+  "x": 112,
+  "y": 124,
+  "width": 156,
+  "height": 24,
+  "text": "API service",
+  "originalText": "API service",
+  "fontSize": 20,
+  "fontFamily": 1,
+  "strokeColor": "#1e1e1e",
+  "textAlign": "center",
+  "verticalAlign": "middle",
+  "containerId": "svc",
+  "autoResize": true
+}
+```
+
+Bound arrow:
+
+```json
+{
+  "type": "arrow",
+  "id": "a1",
+  "x": 280,
+  "y": 136,
+  "width": 140,
+  "height": 0,
+  "points": [
+    [0, 0],
+    [140, 0]
+  ],
+  "endArrowhead": "arrow",
+  "startBinding": { "elementId": "svc", "fixedPoint": [1, 0.5] },
+  "endBinding": { "elementId": "db", "fixedPoint": [0, 0.5] }
+}
+```
+
+Palette:
+
+- Primary/input: `#a5d8ff`
+- Process: `#d0bfff`
+- Success/output: `#b2f2bb`
+- Storage/data: `#c3fae8`
+- External/warning: `#ffd8a8`
+- Error/risk: `#ffc9c9`
+- Note/decision: `#fff3bf`

package/skills/diagram-maker/references/svg-template.md

@@ -0,0 +1,112 @@
+# SVG HTML Template
+
+Copy this to a `.html` file and replace `<!-- SVG -->`.
+
+```html
+<!doctype html>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Diagram</title>
+<style>
+  :root {
+    color-scheme: light dark;
+    --bg: #f8fafc;
+    --fg: #172033;
+    --muted: #5b6475;
+    --line: #64748b;
+    --neutral: #e2e8f0;
+    --input: #bfdbfe;
+    --process: #c7d2fe;
+    --storage: #99f6e4;
+    --external: #fde68a;
+    --risk: #fecaca;
+  }
+  @media (prefers-color-scheme: dark) {
+    :root {
+      --bg: #0f172a;
+      --fg: #e5e7eb;
+      --muted: #a3adbd;
+      --line: #94a3b8;
+      --neutral: #334155;
+      --input: #1d4ed8;
+      --process: #4338ca;
+      --storage: #0f766e;
+      --external: #92400e;
+      --risk: #991b1b;
+    }
+  }
+  body {
+    margin: 0;
+    background: var(--bg);
+    color: var(--fg);
+    font:
+      14px/1.4 ui-sans-serif,
+      system-ui,
+      -apple-system,
+      BlinkMacSystemFont,
+      "Segoe UI",
+      sans-serif;
+  }
+  main {
+    max-width: 980px;
+    margin: 32px auto;
+    padding: 0 20px;
+  }
+  svg {
+    width: 100%;
+    height: auto;
+    display: block;
+  }
+  .title {
+    font-size: 20px;
+    font-weight: 650;
+    fill: var(--fg);
+  }
+  .label {
+    font-size: 14px;
+    font-weight: 600;
+    fill: var(--fg);
+  }
+  .small {
+    font-size: 12px;
+    fill: var(--muted);
+  }
+  .node {
+    stroke: var(--line);
+    stroke-width: 1;
+  }
+  .neutral {
+    fill: var(--neutral);
+  }
+  .input {
+    fill: var(--input);
+  }
+  .process {
+    fill: var(--process);
+  }
+  .storage {
+    fill: var(--storage);
+  }
+  .external {
+    fill: var(--external);
+  }
+  .risk {
+    fill: var(--risk);
+  }
+  .edge {
+    stroke: var(--line);
+    stroke-width: 1.5;
+    fill: none;
+  }
+  .zone {
+    fill: none;
+    stroke: var(--line);
+    stroke-width: 1;
+    stroke-dasharray: 6 5;
+    opacity: 0.8;
+  }
+</style>
+<main>
+  <!-- SVG -->
+</main>
+```

package/skills/discord/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: discord
+description: "Discord message-tool ops: send/read/edit/delete, react, poll, pin, thread, search, presence, media/components."
+metadata: { "nodmix": { "emoji": "🎮", "requires": { "config": ["channels.discord.token"] } } }
+allowed-tools: ["message"]
+---
+
+# Discord
+
+Use the `message` tool with `channel: "discord"`. No separate Discord tool.
+
+## Rules
+
+- Respect `channels.discord.actions.*` gates.
+- Prefer explicit `guildId`, `channelId`, `messageId`, `userId`.
+- Multi-account: pass `accountId` when needed.
+- Send targets: `to: "channel:<id>"` or `to: "user:<id>"`.
+- Mention users as `<@USER_ID>`.
+- Avoid Markdown tables in outbound Discord messages.
+- Prefer components v2 for rich UI; do not mix v2 `components` with legacy `embeds`.
+
+## Common actions
+
+Send:
+
+```json
+{ "action": "send", "channel": "discord", "to": "channel:123", "message": "hello", "silent": true }
+```
+
+Send media:
+
+```json
+{
+  "action": "send",
+  "channel": "discord",
+  "to": "channel:123",
+  "message": "see attachment",
+  "media": "file:///tmp/example.png"
+}
+```
+
+Components v2:
+
+```json
+{
+  "action": "send",
+  "channel": "discord",
+  "to": "channel:123",
+  "message": "Status",
+  "components": "[Carbon v2 components]"
+}
+```
+
+React:
+
+```json
+{ "action": "react", "channel": "discord", "channelId": "123", "messageId": "456", "emoji": "👍" }
+```
+
+Read:
+
+```json
+{ "action": "read", "channel": "discord", "to": "channel:123", "limit": 20 }
+```
+
+Edit/delete:
+
+```json
+{
+  "action": "edit",
+  "channel": "discord",
+  "channelId": "123",
+  "messageId": "456",
+  "message": "fixed typo"
+}
+```
+
+```json
+{ "action": "delete", "channel": "discord", "channelId": "123", "messageId": "456" }
+```
+
+Poll:
+
+```json
+{
+  "action": "poll",
+  "channel": "discord",
+  "to": "channel:123",
+  "pollQuestion": "Lunch?",
+  "pollOption": ["Pizza", "Sushi"],
+  "pollDurationHours": 24
+}
+```
+
+Pin:
+
+```json
+{ "action": "pin", "channel": "discord", "channelId": "123", "messageId": "456" }
+```
+
+Thread:
+
+```json
+{
+  "action": "thread-create",
+  "channel": "discord",
+  "channelId": "123",
+  "messageId": "456",
+  "threadName": "bug triage"
+}
+```
+
+Search:
+
+```json
+{
+  "action": "search",
+  "channel": "discord",
+  "guildId": "999",
+  "query": "release notes",
+  "channelIds": ["123"],
+  "limit": 10
+}
+```
+
+Presence, often gated:
+
+```json
+{
+  "action": "set-presence",
+  "channel": "discord",
+  "activityType": "playing",
+  "activityName": "Nodmix",
+  "status": "online"
+}
+```