Inquiry: Programmatic access or Node.js SDK for OpenCode

[i18nsite]

Hello, I am looking for a way to call the OpenCode agent programmatically from a Node.js environment.

Is there an existing Node.js SDK, or an API, that allows for this?

My goal is to integrate OpenCode's functionality into other automated workflows, and having an SDK or API would be very helpful for this purpose.

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Feature request: Python SDK #2266: This is a very similar request asking for a Python SDK for programmatic integration with OpenCode server functionality

Feel free to ignore if none of these address your specific case.

[sandipwane]

Hey @i18nsite,

Yes, OpenCode has a Node.js SDK for programmatic access.

Install:

npm install @opencode-ai/sdk

Source: https://github.com/sst/opencode/tree/dev/packages/sdk/js

Docs: https://opencode.ai/docs/sdk/

Quick start:

import { createOpencodeClient, createOpencodeServer } from "@opencode-ai/sdk"

// Start server
const server = await createOpencodeServer()
const client = createOpencodeClient({ baseUrl: server.url })

// Create session & send prompt
const session = await client.session.create()
await client.session.prompt({
  path: { id: session.data.id },
  body: {
    parts: [
      { type: "text", text: "Your prompt here" }
    ]
  }
})

SDK handles sessions, file ops, streaming responses - everything needed for automation.

Note: Last time I used @opencode-ai/sdk, the npm package wasn't up to date. I ended up using the SDK directly from the monorepo - cloned sst/opencode and installed the JS SDK folder directly into my project using bun. Check the npm version first, but if you need latest features, the monorepo approach works well.

Let me know if you need help with specific use cases.

[rekram1-node]

The sdk should be up to date now

and thank u @sandipwane for being so helpful

[mrlubos]

@i18nsite is your issue solved now?