@banbury-cheese/voxagent-local-bridge

Local WebSocket bridge for VoxAgent. It exposes a localhost-only endpoint that a VoxAgent room running in the browser can use to trigger Codex or Claude on the user's own machine.

Install

npm install -g @banbury-cheese/voxagent-local-bridge

Or run it without a global install:

npx @banbury-cheese/voxagent-local-bridge --provider codex --workspace-root ~/Code

Usage

voxagent-local-bridge --provider codex --workspace-root ~/Code

Optional flags:

• --provider codex|claude
• --port 4571
• --workspace-root /path/to/projects
• --allow-origin https://app.yourdomain.com

How it works

1. VoxAgent in the browser connects to ws://127.0.0.1:4571.
2. The bridge validates the browser origin.
3. The browser sends build requests over WebSocket.
4. The bridge runs codex exec or claude -p locally inside:
   • <workspace-root>/voxagent-local-builds/<buildId>
5. The bridge returns structured build results back to the browser.

By default, the bridge does not publish or deploy apps publicly. It builds them locally and returns the workspace path plus a summary.