/server — Backstage Viewer Server Control

/server — Backstage Viewer Server Control

Start/stop the backstage pixel art office viewer server.

Usage

/server           → Show current status + toggle menu
/server on        → Enable backstage + start viewer server
/server off       → Disable backstage + stop viewer server

Implementation

When this skill is invoked, execute the single Bash command below. Do NOT run multiple commands or add extra checks.

1. Parse Arguments

Check if the user passed on, off, or nothing.

2. If no argument — show status and ask

Run this single command:

[ -f ~/.claude/plugins/backstage/enabled ] && echo "Backstage: ON" || echo "Backstage: OFF"

Then use AskUserQuestion to ask: "Backstage를 켜시겠습니까? / 끄시겠습니까?" with options.

3. Turn ON

Run this single Bash command (copy exactly, do not modify):

mkdir -p ~/.claude/plugins/backstage && touch ~/.claude/plugins/backstage/enabled && lsof -ti:7777 | xargs kill 2>/dev/null; sleep 0.3; VIEWER_DIR="$(ls -d ~/.claude/plugins/cache/backstage/backstage/*/viewer 2>/dev/null | sort -V | tail -1)"; [ -z "$VIEWER_DIR" ] && VIEWER_DIR=~/.claude/plugins/backstage/viewer; cd "$VIEWER_DIR" && nohup perl -e 'use POSIX "setsid"; setsid(); exec @ARGV' bun server.ts > /tmp/backstage-viewer.log 2>&1 & echo $! > ~/.claude/plugins/backstage/viewer.pid; sleep 1; lsof -ti:7777 > /dev/null 2>&1 && echo "OK: http://localhost:7777" || echo "FAIL: check /tmp/backstage-viewer.log"

Report the output. Do not add extra commands.

4. Turn OFF

Run this single Bash command (copy exactly, do not modify):

rm -f ~/.claude/plugins/backstage/enabled; lsof -ti:7777 | xargs kill 2>/dev/null; rm -f ~/.claude/plugins/backstage/viewer.pid; echo "Backstage OFF"

Report the output. Do not add extra commands.

Notes

• When OFF, all hooks immediately exit (no token cost)
• dialogue-generator is not called when OFF
• The enabled file at ~/.claude/plugins/backstage/enabled controls all hook behavior
• ON always kills existing server first, then starts fresh (no stale process issues)
• Uses nohup + perl POSIX::setsid() + & for triple process isolation:
  • nohup: ignores SIGHUP (terminal close)
  • perl setsid(): creates new session (immune to process group SIGTERM)
  • &: backgrounds from shell
• Viewer directory auto-detected: finds latest version in plugin cache via sort -V
• Liveness check uses lsof -ti:7777 (port check), not curl (avoids false positives)