chore: add rule 56 — Electrobun launch sequence (PTY + Vite before app)
This commit is contained in:
parent
2709600319
commit
b2b1e429dc
1 changed files with 43 additions and 0 deletions
43
.claude/rules/56-electrobun-launch.md
Normal file
43
.claude/rules/56-electrobun-launch.md
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
# 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):
|
||||
```bash
|
||||
/home/hibryda/code/ai/agent-orchestrator/agor-pty/target/release/agor-ptyd &>/dev/null &
|
||||
```
|
||||
|
||||
2. **Start Vite dev server** on port 9760:
|
||||
```bash
|
||||
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**:
|
||||
```bash
|
||||
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:
|
||||
```bash
|
||||
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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue