| name | portal-hud-deploy |
| description | Use when you need to deploy a freshly-built tze_hud.exe to the Windows host and launch the TRANSPARENT overlay HUD in one deterministic command — kill the stale instance, scp + checksum-verify the exe, launch it as a scheduled task (exe-direct, so overlay transparency is preserved), wait for gRPC + MCP ports to bind, and confirm MCP HTTP reachability. Subskill of /user-test. |
| metadata | {"owner":"tze","authors":["tze","Claude"],"status":"active","last_reviewed":"2026-06-21"} |
Portal HUD Deploy (subskill of /user-test)
Consolidates the "deploy a freshly-built tze_hud.exe → kill stale instance →
launch the transparent overlay HUD on the Windows host → verify ports +
reachability" flow into a single deterministic command. No rediscovery needed.
Parent skill: ../../SKILL.md. Use this subskill instead of
the parent's generic deploy_windows_hud.sh when you specifically need the
overlay (transparent) portal launch + port/reachability verification.
The one command
Real host values live in docs/operations/private/tzehouse-windows.local.md
(git-ignored). Read that file for the values, then:
WIN_HOST=<host> WIN_FILE_USER=<file-user> WIN_ADMIN_USER=<admin-user> SSH_KEY=<key> \
.claude/skills/user-test/subskills/portal-hud-deploy/scripts/deploy_portal_hud.sh \
--local-exe target/x86_64-pc-windows-gnu/release/tze_hud.exe
Defaults (scrubbed placeholders, override via env/flags): WIN_HOST=windows-host.example,
WIN_FILE_USER=hud-user, WIN_ADMIN_USER=admin-user, SSH_KEY=~/.ssh/hud-ssh-key.
Run for the full flag list.
