v0.0.2

Go client for the Cursor Agent SDK — same surface as TypeScript @cursor/sdk and Python cursor-sdk, with local and cloud agents from idiomatic Go.

Quick install

go run github.com/remdev/cursor-go-sdk/cmd/setup@latest
go get github.com/remdev/cursor-go-sdk/cursor@v0.0.2
export CURSOR_API_KEY="cursor_..."

Highlights

• One-command setup — cmd/setup installs @cursor-go-sdk/cursor-sdk-bridge@0.0.2 via npm
• Local + cloud agents — CreateAgent, Prompt, Send, Stream / Messages, Wait, typed *AgentError
• Cookbook examples — quickstart, coding-agent CLI, terminal UI, basic smoke test
• Opt-in e2e tests — real API runs with CURSOR_E2E=1 and -tags=e2e
• npm bridge 0.0.2 — global install fixed (bin → compiled JS entrypoint)

Architecture

cursor/ (Go)  ──Connect──►  cursor-sdk-bridge  ──►  @cursor/sdk (npm)

Local agents use the official npm runtime; Go launches the bridge automatically.

Requirements

Component	Version
Go (SDK module)	1.23+
Go (TUI example)	1.24.2+
Node.js	>= 18
npm bridge	>= 0.0.2
API key	CURSOR_API_KEY for live runs

Notable fixes

• Wire encoding no longer leaks cloud: {} on local agents (spurious idempotency keys)
• Idempotency keys only for cloud create/send
• Bridge subprocess no longer dies when the caller context is cancelled
• Setup rejects bridge versions below 0.0.2

Links

• README
• pkg.go.dev
• API map (TS/Python → Go)
• Which Go client?
• npm bridge
• Changelog

Community-maintained — see DISCLAIMER.md.