From 685f887771a712faa3c5fb39c1cd72521c2de5e7 Mon Sep 17 00:00:00 2001 From: Dax Raad Date: Mon, 13 Jul 2026 14:54:40 -0400 Subject: [PATCH] docs: clarify embedded sdk roadmap --- packages/docs/build/sdk.mdx | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/packages/docs/build/sdk.mdx b/packages/docs/build/sdk.mdx index b72aac9c09..afc29dca0b 100644 --- a/packages/docs/build/sdk.mdx +++ b/packages/docs/build/sdk.mdx @@ -1,12 +1,21 @@ --- title: "SDK" -description: "Embed an OpenCode host in an Effect application." +description: "Embed OpenCode directly in your application." --- -`@opencode-ai/sdk-next` is the Effect-native SDK for applications that need to -host OpenCode in-process. Unlike the [network client](/build/client), it assembles the -OpenCode server and routes API calls through its HTTP router in memory. It opens -no HTTP listener and adds no network hop between the client and server. +We're working on a general-purpose SDK for embedding OpenCode directly inside +your application. The regular SDK is coming soon. + +An Effect-native version is available now for applications built with Effect. +Its current documentation is below. For other applications, run OpenCode as a +server and use the [TypeScript client](/build/client) in the meantime. + +## Effect + +`@opencode-ai/sdk-next` hosts OpenCode in-process. Unlike the +[network client](/build/client), it assembles the OpenCode server and routes API +calls through its HTTP router in memory. It opens no HTTP listener and adds no +network hop between the client and server. The V2 SDK is beta and currently private to the OpenCode workspace. It is not