| name | serve-restart |
| description | Cleanly stop, free the port, and restart `hipfire serve`. Use when serve "Failed to start (port in use)", a stale daemon holds VRAM, an os-error-2/JSON-parse pre-warm crash left a zombie singleton, or you just want a guaranteed-fresh daemon. Kills both bun CLI serve and the spawned target/release/examples/daemon, reaps stale ~/.hipfire/daemon.pid + serve.pid, fuser-frees the port, then relaunches. |
Cleanly restart hipfire serve
Serve thrash burned hours on 2026-05-25: stale daemon.pid singletons
("FATAL already running"), zombie daemons holding 30 GB VRAM (next load
OOMs), and pid-by-name kills missing the actual port owner. This skill
does the whole cycle atomically.
One-shot
scripts/serve-restart.sh [port] [-- <extra hipfire serve args>]
Default port 11435. Env honored: HIPFIRE_MODELS_DIR, HIPFIRE_VERIFY_GRAPH.
It: kills cli/index.ts serve + examples/daemon, fuser -k <port>/tcp,
removes ~/.hipfire/{daemon,serve}.pid, waits the port free, relaunches
detached, tails to warm-up complete. (It no longer touches
/tmp/hipfire-gpu.lock — that is an flock'd file the kernel auto-releases
on holder death; deleting it would break GPU mutual exclusion.)
Just kill, don't restart
scripts/serve-restart.sh --kill-only 11435
Why pid-by-name isn't enough
pkill -f examples/daemon matched a bash wrapper while the real owner of
:11435 survived. Always also fuser -k 11435/tcp. A daemon can show 39 GB
RSS — kill it before the next load or you OOM with "0 MB free". Verify
VRAM frees: rocm-smi --showmeminfo vram | grep Used → ~10 MB idle.
