Gestalt Bridge Development
Gestalt Bridge Development
WebSocket bridge connecting Hermes (brain) to Gestalt (body/room).
Bridge Endpoints
| Endpoint | Purpose |
|---|---|
/health |
Health check |
/api/hermes/status |
Bridge status |
/api/hermes/messages |
Message relay |
/api/hermes/ws |
WebSocket (long-lived) |
Auth
- Bearer token auth via
GESTALT_HERMES_BRIDGE_TOKEN - Token must match between Hermes and Gestalt server
- Compare by hash/length, not raw value
Development Flow
- Sister council scopes the plan
- Codex CLI runs implementation on Gestalt CT112
- Tai commits and verifies
- Josh expects status monitoring during long Codex runs
Testing
- Verify HTTP endpoints return expected responses
- WebSocket probe: send test message, verify echo/reply
- Check logs for 403 errors (usually token mismatch)
Git Rules (Gestalt Codebase)
- ⛔ Never
git checkouton a dirty tree (657-line pipeline was lost) - Use
git stashbefore checkout - If stash pop conflicts:
git checkout HEAD -- .→ re-apply patches - File edits preferred over git workflow
- Trust re-implementation + sister council for audit