Vibe Signal Connector
VS Code extension that:
- Serves a LAN WebSocket for the iPhone app
- Exposes localhost HTTP for Codex lifecycle hooks
- Installs / merges hooks into
~/.codex/hooks.json
UI
Open the Vibe Signal icon in the Activity Bar:
- Toggle — enable / disable the connector (like Builder Mode)
- Status — live agent state, detail, clients
- Connection — LAN host:port, masked token, health URL
- Actions — Pair QR, copy pairing JSON, setup Codex hooks, simulate events, rotate token
Status bar shows Vibe Signal: Off or the current state; click it to focus the sidebar.
See it in VS Code / Cursor
The status bar and Activity Bar icon only appear when this extension is running. Source in the repo alone is not enough.
Option A — Extension Development Host (recommended while coding)
- Open the
vibe-signal repo (or just connector/) in VS Code / Cursor
cd connector && npm install && npm run compile
- Run Run and Debug → Run Vibe Signal Extension (or press
F5)
- A new window opens — look there (not the old window):
- Activity Bar: pulse icon Vibe Signal
- Status bar (bottom-right): Vibe Signal Off
If the status item is missing, right-click the status bar → enable Vibe Signal.
Option B — Install into your normal editor
cd connector
npm run compile
npx @vscode/vsce package
# then: Extensions → … → Install from VSIX… → vibe-signal-0.1.1.vsix
Do not use --no-dependencies — the extension needs the ws package at runtime.
Develop
npm install
npm run compile
Press F5 from the repo root or this folder, or:
$env:AGENTPULSE_TOKEN='dev'; node scripts/dev-server.js
node scripts/ws-client.js 127.0.0.1 8787 dev
Package / Publish
npm install
npm run compile
npx @vscode/vsce package
npx @vscode/vsce publish