cyberneticlibrary

Start interactive UI design sessions

ui-sessioncommandsetup L11
kolisachint/hoocowork
What it does

Launch hot-reload UI dev session for component iteration

Best for

Frontend teams needing rapid visual feedback loop without manual page reloads or Git complexity.

Inputs
  • · Session name (optional, for working branch slug)
Outputs
  • · dev/ui-<name> branch created
  • · Vite dev server on :5173
  • · API server on :3001
  • · Network IP and URLs reported
Requires
  • · git
  • · npm (Vite, dev servers)
Preconditions
  • · Codebase has docs/ui-map.md for component index
  • · main branch is up-to-date
  • · npm packages installed
Failure modes
  • · Network IP detection fails — fallback: manual ifconfig/ip addr
  • · dev servers already running on :5173/:3001 — kill and retry
  • · git branch already exists — switches instead of creating new
Trust signals
  • · Explicit IP detection with fallback patterns
  • · Token-lean rules (subagent delegation, offset/limit reads)
  • · Structured handoff to PR workflow (/pr command)