@ping-island/bridge
v0.1.0
Published
Remote bridge server for Ping Island — run on remote machines to relay coding agent hook events via WebSocket
Maintainers
Readme
@ping-island/bridge
WebSocket bridge for Ping Island — enables remote agent session monitoring on machines that can only be accessed via IDE connections (not standard SSH).
Quick Start
# If published to npm:
npx @ping-island/bridge
# Or from a local clone:
cd ping-island/packages/bridge
npm install
node bin/ping-island-bridge.jsThis will:
- Start an HTTP + WebSocket server on port 19526
- Detect installed agent CLIs (Claude Code, Codex, Qwen Code, Qoder, etc.)
- Configure their hooks to send events to the bridge
Then set up IDE port forwarding (remote 19526 → local 19526), and in Ping Island add a tunnel endpoint pointing to ws://localhost:19526.
Options
--port <number> Listen on a custom port (default: 19526)
--no-setup Skip automatic hook configuration
--setup-only Only configure hooks, don't start the serverHow It Works
Agent CLI (claude, codex, qwen, ...)
→ hook script (ping-island-hook)
→ HTTP POST to bridge server (/hook)
→ WebSocket push to Ping Island app
→ Island UI on your MacThe bridge also supports bidirectional communication: permission requests and intervention prompts from the agent are forwarded to Ping Island, and your approve/deny decisions are sent back to the agent.
License
Apache 2.0
