@cursor-go-sdk/cursor-sdk-bridge
v0.0.2
Published
Connect RPC bridge over @cursor/sdk for cursor-go-sdk. Prerequisite for the Go SDK.
Readme
@cursor-go-sdk/cursor-sdk-bridge
The Go SDK cannot load @cursor/sdk (Node). @cursor-go-sdk/cursor-sdk-bridge is the prerequisite npm package:
cursor/ (Go) ──Connect JSON──► cursor-sdk-bridge ──in-process──► @cursor/sdk (npm)Install the bridge before using the Go SDK. The Go client launches the cursor-sdk-bridge binary from PATH.
Install
npm install -g @cursor-go-sdk/cursor-sdk-bridgeOr via Go (from any project):
go run github.com/remdev/cursor-go-sdk/cmd/setup@latestFrom a clone of this repository (development):
go run ./cmd/setup --localRequires Node.js >= 18.
Verify:
cursor-sdk-bridge --helpPublish (maintainers)
See PUBLISHING.md.
Layout
| Path | Role |
|------|------|
| package.json | npm package @cursor-go-sdk/cursor-sdk-bridge |
| proto/ | Owned protobuf wire schema (sdk.v1) |
| gen/ts/ | Generated Connect + ES modules (npm run generate) |
| src/ | TypeScript source (Connect RPC handlers → @cursor/sdk) |
| dist/ | Compiled output (npm run build, gitignored) |
| bin/cursor-sdk-bridge | Dev/local shell launcher → dist/bin/cursor-sdk-bridge.js |
| npm bin | Points at dist/bin/cursor-sdk-bridge.js (works with npm install -g) |
Wire protocol
Protobuf schema: proto/ (sdk.v1). Regenerate TypeScript: npm run generate → gen/ts/.
Connect services: SdkAgentService, SdkBridgeControlService, SdkCursorService. Go client: internal/connect/.
Go SDK discovery
CURSOR_SDK_BRIDGE_BIN— absolute path to the launcherCURSOR_SDK_BRIDGE_ROOT— bridge package root (prefersdist/bin/cursor-sdk-bridge.jswhen built)cursor-sdk-bridgeonPATH(from global install ornpm link)
See references/bridge.md.
