** 🚀 快速入门**：安装 |快速入门 |指南 |API覆盖范围

非官方。 本项目与 OpenCode团队。

** 📦 新包裹ID和新家（0.9.0-preview.5）。** 包裹现在是 OpenCodeDotNet.Sdk 和 OpenCodeDotNet.Sdk.Extensions; OpenCodeAI.Sdk 和 OpenCodeAI.Sdk.Extensions 已被弃用。命名空间保持不变，因此 仅对PackageReference的更改。仓库迁移到了opencode-dotnet组织， 和旧链接重定向。

一个强类型 .NET 客户端用于 opencode 服务器 — 每个开源代码前端（TUI、桌面、Web UI、插件）都使用的HTTP API。SDK说话 OpenCode 2.x API;1.x 服务器 API 不被支持。

---

🎉 项目状态

1.0 之前，协议表面已完成。 全部142个操作在固定的OpenAPI中 快照是可调用的——生成的HTTP调用有140次，两个终端WebSocket连接 通过手写传输。三种连接模式都有效：私有服务器 SDK Starts，一个你已经运行的服务器，以及OpenCode CLI注册的后台服务。

• 🚧 发布次数为0.9.0-preview.N。

opencode SDK for .NET

🚀 Quick Start: Install | Quick start | Guide | API coverage

Unofficial. This project is not affiliated with or endorsed by the opencode team.

📦 New package ids and a new home (0.9.0-preview.5). The packages are now OpenCodeDotNet.Sdk and OpenCodeDotNet.Sdk.Extensions; OpenCodeAI.Sdk and OpenCodeAI.Sdk.Extensions are deprecated. Namespaces are unchanged, so only the PackageReference changes. The repository moved to the opencode-dotnet organization, and old links redirect.

A strongly typed .NET client for the opencode server — the HTTP API that every opencode front-end (TUI, desktop, web UI, plugins) uses. The SDK speaks the OpenCode 2.x API; the 1.x server API is not supported.

await using var server = await OpenCodeServer.StartAsync();
using var client = server.CreateClient();

var created = await client.Sessions.CreateSessionAsync(new SessionCreateRequest { Title = "hello from .NET" });
Console.WriteLine($"session {created.Session.Id}");

---

🎉 Project Status

Pre-1.0, and the protocol surface is complete. All 142 operations in the pinned OpenAPI snapshot are callable — 140 as generated HTTP calls, and the two terminal WebSocket connections through hand-written transports. All three connection modes work: a private server the SDK starts, a server you already run, and the background service that the opencode CLI registers.

• 🚧 Releases are 0.9.0-preview.N. A reviewed baseline locks the public surface, but it can still change before 1.0.0. See CHANGELOG.md.
• 📌 The SDK builds against a snapshot of an upstream release tag, never a live branch. spec/SNAPSHOT.md owns the exact pin and the refresh procedure.