Skill

share-server-setup

Set up a local share server for coding-agent HTML/static artifacts, or connect portable share skills to an existing compatible server. Use when the user wants local browser-share infrastructure, Tailscale-backed viewing, or reusable artifact publishing across coding agents.

npx claudepluginhub ondrej-svec/heart-of-gold-toolkit --plugin marvin

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Set up or adopt a local share server for cross-agent HTML/static artifact sharing.

Supporting Assets

docs/existing-server.mddocs/setup.mddocs/troubleshooting.mdscripts/configure-existing-server.shscripts/configure-tailscale-viewer.shscripts/healthcheck.shscripts/install-launch-agent.shscripts/install-reference-server.sh

SKILL.md

Similar Skills

share-server-control

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.

8 files

marvin

tailscale-serve

586

Manages Tailscale `serve` for multiple paths without conflicts: check status, serve directories/files/ports at subpaths, remove paths, reset all. Useful for sharing local dev servers securely.

sundial-org-awesome-openclaw-skills-4

shared

342

Provides shared reference documents on CLI availability checks, fallbacks for bd/ao/gt/codex/cass, and multi-agent capabilities. Loaded JIT by AgentOps skills like council/crank/swarm.

16 files

agentops

Stats

Parent Repo Stars11

Parent Repo Forks1

Last CommitApr 14, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Share Server Setup

Set up or adopt a local share server for cross-agent HTML/static artifact sharing.

Use this skill when

the user wants to share generated HTML reports or static previews in a browser
the user wants a reusable local share server, not a one-off ad hoc file server
the user wants optional private viewing over Tailscale
share-html cannot run because the share server is not configured yet

Boundaries

This skill may:

inspect local config and server health
install the Heart of Gold reference share server
write/update ~/.agent-share/config.json
configure a macOS LaunchAgent for long-running use
optionally configure tailscale serve for the viewer listener

This skill may not:

expose the publish API remotely
enable Funnel/public internet access by default
assume Tailscale is required for local usage

Quick decision flow

Check current health:
```
bash scripts/healthcheck.sh
```
If a compatible server already exists, keep it and update config if needed.
If no compatible server exists, install the reference server:
```
bash scripts/install-reference-server.sh
```
For macOS long-running usage, install the LaunchAgent:
```
bash scripts/install-launch-agent.sh
```
If the user wants browser access from another tailnet device, configure Tailscale for the viewer listener only:
```
bash scripts/configure-tailscale-viewer.sh --public-base-url "https://<machine>.<tailnet>.ts.net"
```

Existing compatible server mode

If the user already has a compatible local share server, write the config without reinstalling:

bash scripts/configure-existing-server.sh \
  --api-url "http://127.0.0.1:4815" \
  --viewer-url "http://127.0.0.1:4816" \
  --public-base-url "https://<machine>.<tailnet>.ts.net" \
  --provider existing

Then verify:

bash scripts/healthcheck.sh

Reference implementation mode

Install the reference server files, initialize config, and verify health:

bash scripts/install-reference-server.sh
bash scripts/healthcheck.sh

On macOS, set up long-running mode:

bash scripts/install-launch-agent.sh

Tailscale notes

Tailscale is optional.

If used, expose only the viewer listener. The publish/admin API remains localhost-only.

This skill's Tailscale helper configures:

local viewer listener on 127.0.0.1:4816
tailscale serve --bg 4816
config update for publicBaseUrl

Available scripts

scripts/healthcheck.sh — check config and GET /health
scripts/install-reference-server.sh — install the reference server and initialize config
scripts/install-launch-agent.sh — configure macOS LaunchAgent persistence
scripts/configure-existing-server.sh — point config at an already-running compatible server
scripts/configure-tailscale-viewer.sh — expose viewer listener over tailscale serve and update config

References

docs/setup.md
docs/existing-server.md
docs/troubleshooting.md