html-skills-listen
html-skills-listen — server-mode setup for html-skills artifacts
System primitive for the html-skills plugin. It runs a bundled script that detects the environment, starts (or finds) this session's local receiver on an ephemeral port, and prints what you need; you then arm a Monitor on the receiver's log so each submit becomes a session notification, and hand the URL back to the skill that invoked you.
Steps
-
Run the setup script with this session's id:
bash "${CLAUDE_PLUGIN_ROOT}/skills/html-skills-listen/scripts/listen.sh" "${CLAUDE_SESSION_ID}"Output is
KEY=VALUElines. Always present:SID,LOG,MIDF,STATUS. WithSTATUS=STARTEDorSTATUS=ALREADY_RUNNINGyou also getURL. After a restart of a receiver that had died,STATUS=STARTEDalso printsRESTARTED=1and, if its previous port could not be reused,PORT_CHANGED=1. -
Branch on
STATUS:-
STATUS=WEB— Claude Code web session; the sandbox can't reach the user's browser. Don't arm aMonitor. Tell the parent skill (or the user, if invoked directly):ⓘ Claude Code web session detected. Server mode can't work here. The artifact will use clipboard mode automatically — Submit copies JSON to the clipboard for paste-back.
-