agent-orchestrator/.claude/rules/56-electrobun-launch.md

Electrobun Launch Sequence (MANDATORY)

Before launching the Electrobun app, ALWAYS start dependencies in this exact order:

Steps

1. Start Rust PTY daemon (if not already running):

   /home/hibryda/code/ai/agent-orchestrator/agor-pty/target/release/agor-ptyd &>/dev/null &
   

2. Start Vite dev server on port 9760:

   cd /home/hibryda/code/ai/agent-orchestrator/ui-electrobun && npx vite dev --port 9760 --host localhost &>/dev/null &
   

3. Wait 3-4 seconds for Vite to be ready.

4. Launch Electrobun:

   cd /home/hibryda/code/ai/agent-orchestrator/ui-electrobun && npx electrobun dev
   

What Happens If You Skip Steps

• No PTY daemon: App crashes with Connection timeout (5s). Is agor-ptyd running? — Bun process dies silently.
• No Vite: WebView loads a blank page (no frontend bundle served).
• No wait: Electrobun opens before Vite is ready — blank page or partial load.

Kill Sequence (Rule 55)

Always kill previous instances before launching new ones:

pkill -f "electrobun|vite.*9760|agor-ptyd|WebKit|AgentOrch|launcher" 2>/dev/null
fuser -k 9760/tcp 2>/dev/null

Rules

• NEVER launch Electrobun without the PTY daemon running.
• NEVER launch Electrobun without Vite running on port 9760.
• ALWAYS kill previous instances first (Rule 55).
• Check pgrep -f agor-ptyd before launching to verify daemon is alive.