npm - @heart-of-gold/toolkit - Versions diffs - 0.1.30 → 0.1.32 - Mend

@heart-of-gold/toolkit 0.1.30 → 0.1.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/README.md CHANGED Viewed

@@ -39,8 +39,9 @@ When installed as a Pi package, Heart of Gold exposes Pi-native extension comman
 - `/deep-thought-brainstorm` — start a brainstorm (collaborative discovery)
 - `/deep-thought-plan` — start planning (research and produce a plan document)
 - `/deep-thought-architect` — turn brainstorm decisions into stories and architecture docs
-- `/share` — publish an HTML file or static site directory through the portable `share-html` skill
+- `/share-html` — publish an HTML file or static site directory through the portable `share-html` skill
 - `/share-server-setup` — set up or adopt the local share server through the portable `share-server-setup` skill
+- `/share-server-control` — control the local share server lifecycle through the portable `share-server-control` skill
 - `/marvin-work` — start executing a plan (with always-on safety guardrails)
 Pi package installs also include a Pi-only guided workflow enhancer for supported Heart of Gold skills. For `brainstorm`, `plan`, and `architect`, when the assistant asks a high-confidence structured question, Pi can upgrade it into a custom interactive TUI and feed the answer back into the same workflow. Shared skills remain plain-text portable in every other harness.
@@ -97,18 +98,19 @@ The unglamorous work that compounds.
 Execute plans task by task with tests after every change. Quick-review code with an emphasis on simplicity — catch YAGNI violations, premature abstractions, and code that solves problems that don't exist yet. Document solutions so the next person doesn't waste time re-discovering what you already figured out.
-9 skills · 2 agents · 3 knowledge files
+10 skills · 2 agents · 3 knowledge files
 ```
-/marvin:work               # execute plans — implement, test, commit, ship
-/marvin:quick-review       # fast opinionated quality pass (simplicity, tests, correctness)
-/marvin:compound           # document solved problems for future reference
-/marvin:redteam            # adversarial review — find weaknesses, expose with failing tests
-/marvin:scaffold           # prepare project structure, configs, dependencies
-/marvin:test-writer        # write failing tests from user stories
-/marvin:copy-editor        # two-layer copy editor (typography audit + LLM judgment)
-/marvin:share-server-setup # set up local artifact sharing infrastructure
-/marvin:share-html         # publish HTML/static output to a browser URL
+/marvin:work                 # execute plans — implement, test, commit, ship
+/marvin:quick-review         # fast opinionated quality pass (simplicity, tests, correctness)
+/marvin:compound             # document solved problems for future reference
+/marvin:redteam              # adversarial review — find weaknesses, expose with failing tests
+/marvin:scaffold             # prepare project structure, configs, dependencies
+/marvin:test-writer          # write failing tests from user stories
+/marvin:copy-editor          # two-layer copy editor (typography audit + LLM judgment)
+/marvin:share-server-setup   # set up local artifact sharing infrastructure
+/marvin:share-server-control # start, stop, and inspect local share server lifecycle
+/marvin:share-html           # publish HTML/static output to a browser URL
 ```
 ### [Guide](plugins/guide/) — The Hitchhiker's Guide

package/extensions/pi/share.ts CHANGED Viewed

@@ -19,12 +19,12 @@ function queueOrSend(
 }
 export default function shareExtension(pi: ExtensionAPI) {
-	pi.registerCommand("share", {
+	pi.registerCommand("share-html", {
 		description: "Publish an HTML file or static site directory via the share-html skill",
 		handler: async (args, ctx) => {
 			const source = args.trim() || (ctx.hasUI ? (await ctx.ui.editor?.("HTML file or static site directory", ""))?.trim() : undefined);
 			if (!source) {
-				ctx.ui.notify("Usage: /share <html file or static site directory>", "info");
+				ctx.ui.notify("Usage: /share-html <html file or static site directory>", "info");
 				return;
 			}
@@ -39,4 +39,12 @@ export default function shareExtension(pi: ExtensionAPI) {
 			queueOrSend(pi, prompt, ctx, "Share server setup queued as follow-up");
 		},
 	});
+	pi.registerCommand("share-server-control", {
+		description: "Control the local share server lifecycle via the portable share-server-control skill",
+		handler: async (args, ctx) => {
+			const prompt = args.trim() ? `/skill:share-server-control ${args.trim()}` : "/skill:share-server-control";
+			queueOrSend(pi, prompt, ctx, "Share server control queued as follow-up");
+		},
+	});
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@heart-of-gold/toolkit",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "type": "module",
   "description": "Cross-platform installer for Heart of Gold skills — works with Codex, OpenCode, Pi, Claude Code, and more",
   "bin": {
@@ -68,6 +68,7 @@
       "./plugins/guide/skills/write-post",
       "./plugins/marvin/skills/compound",
       "./plugins/marvin/skills/share-html",
+      "./plugins/marvin/skills/share-server-control",
       "./plugins/marvin/skills/share-server-setup",
       "./plugins/marvin/skills/quick-review",
       "./plugins/marvin/skills/redteam",

package/plugins/babel-fish/skills/visualize/SKILL.md CHANGED Viewed

@@ -1,9 +1,10 @@
 ---
 name: visualize
 description: >
-  Render mind maps and tree visualizations directly in the terminal using Unicode box-drawing characters
-  with ANSI colors. Works over SSH, no browser needed. Use on brainstorm docs, plan docs, markdown files,
-  or any structured content. Triggers: visualize, mindmap, mind map, show me the structure, draw a map.
+  Render mind maps and tree visualizations from markdown. Prefer terminal output for quick local inspection,
+  and generate shareable HTML when the user wants a browser view and share-html infrastructure is configured.
+  Works on brainstorm docs, plan docs, markdown files, or any structured content. Triggers: visualize,
+  mindmap, mind map, show me the structure, draw a map.
 allowed-tools:
   - Read
   - Bash
@@ -17,8 +18,8 @@ Translating structured text into spatial understanding. Because walls of text hi
 ## Boundaries
-- MAY: read files, generate mind maps, run the renderer script via bash
-- MAY NOT: modify files, create new files (except temp files in /tmp), install packages
+- MAY: read files, generate terminal mind maps, generate temporary HTML artifacts, run renderer/share scripts via bash
+- MAY NOT: modify project files, create persistent files outside temp/output artifacts, install unrelated packages
 ## The Renderer
@@ -46,7 +47,7 @@ fi
 ## Usage
 ```bash
-# Render a markdown file
+# Render a markdown file in the terminal
 node "$SCRIPT" path/to/file.md
 # With options
@@ -54,11 +55,26 @@ node "$SCRIPT" --no-color path/to/file.md    # plain Unicode, no ANSI
 node "$SCRIPT" --width 120 path/to/file.md   # constrain to 120 columns
 node "$SCRIPT" --depth 2 path/to/file.md     # limit tree depth
 node "$SCRIPT" --json path/to/data.json      # JSON tree input
+node "$SCRIPT" --html /tmp/map.html path/to/file.md  # generate HTML mind map
 # Pipe markdown
 echo "# Root\n## Branch A\n## Branch B" | node "$SCRIPT"
 ```
+### Shareable HTML flow
+Use the helper script when the user wants a browser URL and the share server is already configured:
+```bash
+bash scripts/render-and-share.sh path/to/file.md
+```
+This script:
+1. generates an HTML mind map via the existing renderer
+2. locates `share-html/scripts/publish.sh`
+3. publishes the artifact to the configured local share server
+4. prints the publish JSON so you can return the URL
 ## Rendering Behavior
 - **Auto-depth:** If no `--depth` is specified, the renderer tries depths 3, 2, 1 and picks the deepest that fits the terminal width.
@@ -72,6 +88,20 @@ echo "# Root\n## Branch A\n## Branch B" | node "$SCRIPT"
 ## Phase 0 — Determine What to Visualize
+First decide whether the user wants:
+- a quick terminal view
+- a browser/shareable HTML view
+**Prefer browser/shareable HTML when:**
+- the user asks to open it in a browser
+- the user wants to share the result with another person or device
+- the structure is large enough that browser navigation is more useful than terminal rendering
+**Prefer terminal rendering when:**
+- the user wants a quick local look
+- the environment is SSH-heavy or browser access is not requested
+- share-html is not configured
 When invoked as `/visualize [path]`:
 **If a file path is provided:**
@@ -88,11 +118,13 @@ When invoked as `/visualize [path]`:
 2. Generate an appropriate markdown structure
 3. Render it
-## Phase 1 — Render
+## Phase 1 — Render or Share
+### Path A — Terminal rendering
-**IMPORTANT: Output the mind map in Claude's response text, NOT as bash tool output.**
+**IMPORTANT: Output the mind map in the assistant response text, NOT as raw bash tool output.**
-Claude Code's bash output panel truncates long output and wraps wide content, breaking alignment. Instead:
+Many harness bash panels truncate long output and wrap wide content, breaking alignment. Instead:
 1. Locate the renderer script (see above)
 2. Ensure dependencies are installed
@@ -102,18 +134,35 @@ Claude Code's bash output panel truncates long output and wraps wide content, br
    ```
 4. Read `/tmp/mindmap-result.txt`
 5. Output the contents inside a markdown fenced code block in your response text
-6. Clean up: `rm /tmp/mindmap-result.txt`
+6. Clean up: `rm -f /tmp/mindmap-result.txt`
+The default mode is **vertical layout** — boxes on main branches, compact leaves, ~40 chars wide.
+### Path B — Shareable HTML
+If the user wants browser viewing or sharing and `share-html` is configured:
+1. Verify or assume the input markdown is ready
+2. Run:
+   ```bash
+   bash scripts/render-and-share.sh [file]
+   ```
+3. Read the returned JSON
+4. Return the primary URL to the user (`url` when present, otherwise `viewerUrl`)
+5. Briefly explain what was published
-The default mode is **vertical layout** — boxes on main branches, compact leaves, ~40 chars wide. Fits perfectly in Claude Code's response area.
+If publishing fails because the share server is not configured, say so clearly and fall back to terminal rendering unless the user wants to stop and run `share-server-setup` first.
-**For shell usage** (not through Claude Code): Run without `--no-color` for ANSI colors, or use `--horizontal` for the wide spatial layout.
+**For shell usage** (not through assistant panels): terminal rendering can use ANSI colors, or `--horizontal` for the wide spatial layout.
 ## Phase 2 — Offer Next Steps
-After rendering, briefly note:
-- "Use `--depth N` to see more/less detail"
-- "Use `--width N` to fit a different terminal size"
-- If the source was a brainstorm/plan, offer to continue the workflow (e.g., proceed to `/plan` or `/work`)
+After rendering or sharing, briefly note:
+- for terminal mode: "Use `--depth N` to see more/less detail"
+- for terminal mode: "Use `--width N` to fit a different terminal size"
+- for shared HTML: return the viewer URL and say whether it is local-only or publicly reachable on the user's tailnet
+- if publishing failed due to missing share infrastructure: suggest `share-server-setup`
+- if the source was a brainstorm/plan/architecture doc, offer to continue the workflow (e.g., proceed to `/plan`, `/work`, or implementation)
 ## Input Formats
@@ -166,4 +215,4 @@ Write the generated markdown to `/tmp/mindmap-XXXXXX.md`, render it, then clean
 ## What Makes This Babel Fish
-The Babel Fish translates between languages. This skill translates between *modalities* — from linear text to spatial structure. It makes the invisible visible: the hierarchy, the relationships, the gaps that only show up when you see the shape of the thinking.
+The Babel Fish translates between languages. This skill translates between *modalities* — from linear text to spatial structure, and now from private working docs to shareable browser views. It makes the invisible visible: the hierarchy, the relationships, the gaps that only show up when you see the shape of the thinking.

package/plugins/babel-fish/skills/visualize/scripts/render-and-share.sh ADDED Viewed

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+RENDER_DIR="$SCRIPT_DIR/render-mindmap"
+RENDER_SCRIPT="$RENDER_DIR/index.js"
+INPUT_PATH=""
+SLUG=""
+TITLE=""
+ALIAS=""
+KEEP_HTML=0
+HTML_OUT=""
+TEMP_DIR=""
+usage() {
+  cat <<'EOF'
+Usage: render-and-share.sh <markdown-file> [--slug STEM] [--title TITLE] [--alias ALIAS] [--html-out PATH] [--keep-html]
+Generate an HTML mind map from a markdown file, publish it via share-html, and print the publish JSON.
+EOF
+}
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --slug) SLUG="$2"; shift 2 ;;
+    --title) TITLE="$2"; shift 2 ;;
+    --alias) ALIAS="$2"; shift 2 ;;
+    --html-out) HTML_OUT="$2"; shift 2 ;;
+    --keep-html) KEEP_HTML=1; shift ;;
+    --help) usage; exit 0 ;;
+    --*) echo "Unknown argument: $1" >&2; exit 1 ;;
+    *)
+      if [[ -z "$INPUT_PATH" ]]; then
+        INPUT_PATH="$1"
+        shift
+      else
+        echo "Unexpected positional argument: $1" >&2
+        exit 1
+      fi
+      ;;
+  esac
+done
+if [[ -z "$INPUT_PATH" ]]; then
+  usage >&2
+  exit 1
+fi
+if [[ ! -f "$INPUT_PATH" ]]; then
+  echo "Input markdown file does not exist: $INPUT_PATH" >&2
+  exit 1
+fi
+if [[ ! -f "$RENDER_SCRIPT" ]]; then
+  echo "Renderer script not found: $RENDER_SCRIPT" >&2
+  exit 1
+fi
+if [[ ! -d "$RENDER_DIR/node_modules" ]]; then
+  (cd "$RENDER_DIR" && npm install --silent)
+fi
+if [[ -z "$HTML_OUT" ]]; then
+  TEMP_DIR="$(mktemp -d)"
+  HTML_OUT="$TEMP_DIR/$(basename "${INPUT_PATH%.*}").html"
+fi
+cleanup() {
+  if [[ "$KEEP_HTML" -eq 0 && -n "$TEMP_DIR" && -d "$TEMP_DIR" ]]; then
+    rm -rf "$TEMP_DIR"
+  fi
+}
+trap cleanup EXIT
+node "$RENDER_SCRIPT" --html "$HTML_OUT" "$INPUT_PATH" >/dev/null
+find_share_publish_script() {
+  local candidates=(
+    "$SCRIPT_DIR/../../share-html/scripts/publish.sh"
+    "$SCRIPT_DIR/../../../marvin/skills/share-html/scripts/publish.sh"
+    "$SCRIPT_DIR/../../../../marvin/skills/share-html/scripts/publish.sh"
+    "$HOME/.agents/skills/share-html/scripts/publish.sh"
+    "$HOME/.pi/agent/skills/share-html/scripts/publish.sh"
+  )
+  for candidate in "${candidates[@]}"; do
+    if [[ -f "$candidate" ]]; then
+      printf '%s\n' "$candidate"
+      return 0
+    fi
+  done
+  find "$(cd "$SCRIPT_DIR/../../../../.." && pwd)" -path '*/share-html/scripts/publish.sh' 2>/dev/null | head -1
+}
+PUBLISH_SCRIPT="$(find_share_publish_script)"
+if [[ -z "$PUBLISH_SCRIPT" || ! -f "$PUBLISH_SCRIPT" ]]; then
+  echo '{"ok":false,"error":{"code":"MISSING_SHARE_HTML","message":"Could not find share-html publish.sh. Install the share-html skill first."}}'
+  exit 1
+fi
+CMD=(bash "$PUBLISH_SCRIPT" "$HTML_OUT")
+if [[ -n "$SLUG" ]]; then CMD+=(--slug "$SLUG"); fi
+if [[ -n "$TITLE" ]]; then CMD+=(--title "$TITLE"); fi
+if [[ -n "$ALIAS" ]]; then CMD+=(--alias "$ALIAS"); fi
+"${CMD[@]}"

package/plugins/babel-fish/skills/visualize/scripts/render-mindmap/package.json CHANGED Viewed

@@ -9,6 +9,7 @@
   },
   "dependencies": {
     "chalk": "^5.4.1",
-    "cli-boxes": "^4.0.1"
+    "cli-boxes": "^4.0.1",
+    "markmap-cli": "^0.18.12"
   }
 }

package/plugins/deep-thought/skills/architect/SKILL.md CHANGED Viewed

@@ -176,10 +176,13 @@ Use **AskUserQuestion** with:
 - header: "Next step"
 - options:
   1. label: "Start implementation (Recommended)", description: "Proceed to scaffold or test writing"
-  2. label: "Review and refine", description: "Adjust stories or architecture based on feedback"
-  3. label: "Done for now", description: "Return later"
+  2. label: "Visualize / Share", description: "Prefer a shareable HTML view when sharing is configured; otherwise render structure in the terminal"
+  3. label: "Review and refine", description: "Adjust stories or architecture based on feedback"
+  4. label: "Done for now", description: "Return later"
 - multiSelect: false
+**If user selects "Visualize / Share":** Run `/babel-fish:visualize {stories_path}/{slug}.architecture.md` and prefer the shareable HTML flow when browser viewing or sharing is useful and `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
 **If pipeline mode (`$BRAINSTORM_PATH` set):**
 Complete without asking. Output paths for downstream consumers:
 ```

package/plugins/deep-thought/skills/brainstorm/SKILL.md CHANGED Viewed

@@ -291,13 +291,13 @@ Ask the user what to do next.
 - Prefer the harness's structured choice UI if available
 - Otherwise present this short plain-text choice list:
   1. **Proceed to /plan** — Turn these decisions into an implementation plan
-  2. **Visualize** — Render a mind map of this brainstorm in the terminal
+  2. **Visualize / Share** — Prefer a shareable HTML mind map when sharing is configured; otherwise render in the terminal
   3. **Keep exploring** — More questions or refine decisions before moving on
   4. **Done for now** — Return later; to plan: `/plan {brainstorm-path}`
 **If user selects "Proceed to /plan":** Suggest running `/plan {brainstorm-path}`.
-**If user selects "Visualize":** Run `/babel-fish:visualize {brainstorm-path}` to render a mind map of the brainstorm structure. After rendering, return to this handoff with the remaining options.
+**If user selects "Visualize / Share":** Run `/babel-fish:visualize {brainstorm-path}` and prefer the shareable HTML flow when browser viewing or sharing is useful and `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
 **If user selects "Keep exploring":** Return to Phase 3 and continue asking questions one at a time. When satisfied, update the document and return to this handoff.

package/plugins/deep-thought/skills/plan/SKILL.md CHANGED Viewed

@@ -283,13 +283,13 @@ Ask the user what to do next.
 - Prefer the harness's structured choice UI if available
 - Otherwise present this short plain-text choice list:
   1. **Start /work (Recommended)** — Begin implementing this plan
-  2. **Visualize** — Render a mind map of this plan in the terminal
+  2. **Visualize / Share** — Prefer a shareable HTML mind map when sharing is configured; otherwise render in the terminal
   3. **Review and refine** — Adjust the plan based on feedback
   4. **Done for now** — Return later; to start: `/work {plan-path}`
 **If user selects "Start /work":** Suggest running `/work {plan-path}`.
-**If user selects "Visualize":** Run `/babel-fish:visualize {plan-path}` to render a mind map of the plan structure. After rendering, return to this handoff with the remaining options.
+**If user selects "Visualize / Share":** Run `/babel-fish:visualize {plan-path}` and prefer the shareable HTML flow when browser viewing or sharing is useful and `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
 **If user selects "Review and refine":** Accept feedback, update the plan, then present these options again.

package/plugins/marvin/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "marvin",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
   "author": {
     "name": "ondrej-svec",

package/plugins/marvin/README.md CHANGED Viewed

@@ -2,7 +2,7 @@
 > "Here I am, brain the size of a planet, and they ask me to review your code. Call that job satisfaction? 'Cause I don't."
-A quality plugin for Claude Code. Nine skills for the unglamorous work that compounds: executing plans, reviewing code, documenting solutions, scaffolding projects, writing failing tests, adversarial review, keeping copy clean, and publishing browser-viewable artifacts.
+A quality plugin for Claude Code. Ten skills for the unglamorous work that compounds: executing plans, reviewing code, documenting solutions, scaffolding projects, writing failing tests, adversarial review, keeping copy clean, publishing browser-viewable artifacts, and controlling the local share server lifecycle.
 ## Skills
@@ -35,6 +35,9 @@ Set up or adopt a local share server for browser-viewable coding-agent artifacts
 ### `/marvin:share-html`
 Publish a local HTML file or static site directory to the configured share server and return a browser URL. Supports a single `.html` file or a directory containing `index.html`.
+### `/marvin:share-server-control`
+Control the local share server after setup. Use it to check status, start or stop the macOS LaunchAgent-backed reference server, restart it, or enable or disable private Tailscale viewer exposure.
 ## Agents
 | Agent | Focus |

package/plugins/marvin/skills/share-html/SKILL.md CHANGED Viewed

@@ -10,15 +10,21 @@ Publish browser-viewable artifacts to the local share server.
 ## Use this skill when
-- the user generated an HTML report or preview and wants a stable URL
+- the user generated an HTML report, preview, or visualization and wants a stable URL
 - the user wants to open output in a browser on another device
 - the user wants a share flow that works across coding agents
+- another shared skill produced HTML as a derived artifact and now needs publication
 ## Supported inputs
 - a single `.html` file
 - a directory containing `index.html`
+Common producers include:
+- handcrafted HTML reports
+- static-site outputs
+- HTML mind maps or structured document previews generated from brainstorms, plans, or architecture docs
 If the server is not configured yet, stop and run `share-server-setup` first.
 ## Default workflow

package/plugins/marvin/skills/share-server-control/SKILL.md ADDED Viewed

@@ -0,0 +1,80 @@
+---
+name: share-server-control
+description: Control the local share server lifecycle after setup. Use when the user wants to check status, start or stop the local share server, restart it, or enable or disable private Tailscale viewer exposure.
+compatibility: Requires macOS LaunchAgent-based reference server management in v1. Optional Tailscale CLI support for enabling or disabling private viewer exposure.
+---
+# Share Server Control
+Control the local share server after it has been set up.
+## Use this skill when
+- the user wants to know whether the share server is running
+- the user wants to start, stop, or restart the local server
+- the user wants to enable or disable private Tailscale viewer exposure
+- the user wants the current health/status without re-running setup
+## Boundaries
+This skill may:
+- inspect the current config and server health
+- control the macOS LaunchAgent for the reference server
+- inspect or change Tailscale Serve viewer exposure
+This skill may not:
+- replace first-time setup
+- expose the publish/admin API remotely
+- enable Funnel/public internet access by default
+## Recommended commands
+### Status
+```bash
+bash scripts/status.sh
+```
+### Start the local server
+```bash
+bash scripts/start.sh
+```
+### Stop the local server
+```bash
+bash scripts/stop.sh
+```
+### Restart the local server
+```bash
+bash scripts/restart.sh
+```
+### Enable private viewer exposure over Tailscale
+```bash
+bash scripts/enable-viewer.sh --public-base-url "https://<machine>.<tailnet>.ts.net"
+```
+### Disable private viewer exposure over Tailscale
+```bash
+bash scripts/disable-viewer.sh
+```
+## Notes
+- In v1, lifecycle control assumes the reference server was installed as a macOS LaunchAgent.
+- If the user has not set up the server yet, stop and use `share-server-setup` first.
+- `status.sh` is the safest first command because it shows LaunchAgent state, health, and Tailscale Serve status together.
+## Available scripts
+- `scripts/status.sh` — show LaunchAgent, health, and viewer exposure status
+- `scripts/start.sh` — load the LaunchAgent and start the local share server
+- `scripts/stop.sh` — unload the LaunchAgent and stop the local share server
+- `scripts/restart.sh` — restart the LaunchAgent cleanly
+- `scripts/enable-viewer.sh` — enable private Tailscale Serve exposure for the viewer listener
+- `scripts/disable-viewer.sh` — turn off private Tailscale Serve exposure
+## References
+- `docs/usage.md`
+- `docs/troubleshooting.md`

package/plugins/marvin/skills/share-server-control/scripts/disable-viewer.sh ADDED Viewed

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+TAILSCALE_BIN="${TAILSCALE_BIN:-tailscale}"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help)
+      cat <<'EOF'
+Usage: disable-viewer.sh
+Disable private Tailscale Serve exposure for the viewer listener.
+EOF
+      exit 0
+      ;;
+    *) echo "Unknown argument: $1" >&2; exit 1 ;;
+  esac
+done
+"$TAILSCALE_BIN" serve --https=443 off
+echo '{"ok":true,"action":"disable-viewer"}'

package/plugins/marvin/skills/share-server-control/scripts/enable-viewer.sh ADDED Viewed

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+DIR="$(cd "$(dirname "$0")" && pwd)"
+exec bash "$DIR/../../share-server-setup/scripts/configure-tailscale-viewer.sh" "$@"

package/plugins/marvin/skills/share-server-control/scripts/restart.sh ADDED Viewed

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+DIR="$(cd "$(dirname "$0")" && pwd)"
+bash "$DIR/stop.sh"
+sleep 1
+bash "$DIR/start.sh"

package/plugins/marvin/skills/share-server-control/scripts/start.sh ADDED Viewed

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+PLIST_PATH="${PLIST_PATH:-$HOME/Library/LaunchAgents/com.heart-of-gold.share-server.plist}"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help)
+      cat <<'EOF'
+Usage: start.sh
+Load the macOS LaunchAgent for the local share server.
+EOF
+      exit 0
+      ;;
+    *) echo "Unknown argument: $1" >&2; exit 1 ;;
+  esac
+done
+launchctl unload "$PLIST_PATH" 2>/dev/null || true
+launchctl load "$PLIST_PATH"
+echo "{\"ok\":true,\"action\":\"start\",\"plistPath\":\"$PLIST_PATH\"}"

package/plugins/marvin/skills/share-server-control/scripts/status.sh ADDED Viewed

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -euo pipefail
+CONFIG_PATH="${CONFIG_PATH:-$HOME/.agent-share/config.json}"
+PLIST_PATH="${PLIST_PATH:-$HOME/Library/LaunchAgents/com.heart-of-gold.share-server.plist}"
+TAILSCALE_BIN="${TAILSCALE_BIN:-tailscale}"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --config) CONFIG_PATH="$2"; shift 2 ;;
+    --help)
+      cat <<'EOF'
+Usage: status.sh [--config PATH]
+Show LaunchAgent state, server health, and Tailscale Serve status for the local share server.
+EOF
+      exit 0
+      ;;
+    *) echo "Unknown argument: $1" >&2; exit 1 ;;
+  esac
+done
+python3 - <<'PY' "$CONFIG_PATH" "$PLIST_PATH" "$TAILSCALE_BIN"
+import json, os, subprocess, sys, urllib.request
+config_path, plist_path, tailscale = sys.argv[1], sys.argv[2], sys.argv[3]
+result = {
+    'ok': True,
+    'configPath': config_path,
+    'launchAgent': {
+        'plistPath': plist_path,
+        'exists': os.path.exists(plist_path),
+        'loaded': False,
+    },
+    'health': None,
+    'tailscaleServe': {
+        'available': False,
+        'status': None,
+    },
+}
+if result['launchAgent']['exists']:
+    try:
+        proc = subprocess.run(['launchctl', 'list', 'com.heart-of-gold.share-server'], capture_output=True, text=True)
+        result['launchAgent']['loaded'] = proc.returncode == 0
+    except Exception:
+        pass
+if os.path.exists(config_path):
+    with open(config_path, 'r', encoding='utf-8') as f:
+        cfg = json.load(f)
+    url = cfg['server']['apiUrl'].rstrip('/') + '/health'
+    try:
+        with urllib.request.urlopen(url, timeout=3) as resp:
+            result['health'] = json.loads(resp.read().decode('utf-8'))
+    except Exception as exc:
+        result['health'] = {'ok': False, 'error': str(exc)}
+try:
+    proc = subprocess.run([tailscale, 'serve', 'status'], capture_output=True, text=True)
+    result['tailscaleServe']['available'] = proc.returncode == 0
+    result['tailscaleServe']['status'] = (proc.stdout or proc.stderr).strip()
+except FileNotFoundError:
+    result['tailscaleServe']['available'] = False
+print(json.dumps(result, indent=2))
+PY

package/plugins/marvin/skills/share-server-control/scripts/stop.sh ADDED Viewed

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+PLIST_PATH="${PLIST_PATH:-$HOME/Library/LaunchAgents/com.heart-of-gold.share-server.plist}"
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help)
+      cat <<'EOF'
+Usage: stop.sh
+Unload the macOS LaunchAgent for the local share server.
+EOF
+      exit 0
+      ;;
+    *) echo "Unknown argument: $1" >&2; exit 1 ;;
+  esac
+done
+launchctl unload "$PLIST_PATH" 2>/dev/null || true
+echo "{\"ok\":true,\"action\":\"stop\",\"plistPath\":\"$PLIST_PATH\"}"

package/src/index.ts CHANGED Viewed

@@ -8,7 +8,7 @@ import { shareServerCommand } from "./commands/share-server";
 const main = defineCommand({
   meta: {
     name: "heart-of-gold",
-    version: "0.1.30",
+    version: "0.1.32",
     description:
       "Cross-platform installer for Heart of Gold skills — Codex, OpenCode, Pi, Claude Code, and more",
   },