You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 56d4fb2
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: packages/web/src/content/docs/go.mdx
+26-26Lines changed: 26 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -109,46 +109,46 @@ Your client should:
109
109
110
110
Use an up-to-date client and its OpenCode Go integration where available.
111
111
112
-
| Client | Session support |
113
-
| --- | --- |
114
-
|**OpenCode**| Sends the session ID automatically. Update older installations. |
115
-
|**Pi**| Current builds send session information for OpenCode. Update older installations. |
116
-
|**Claude Code**| Go recognizes its native session header. No custom-header wrapper is needed. |
117
-
|**ZCode**| Go recognizes its native session header. Our [request for `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) remains open, but it is no longer necessary to send that specific header. |
118
-
|**Codex**| Go recognizes its native session header. Some versions and proxy setups still omit it; preserve the session header when forwarding requests. |
119
-
|**jcode**| Update to **v0.81.6 or later**, which includes the [session-header fix](https://github.com/1jehuang/jcode/issues/1167). |
120
-
|**Hermes**| Builds containing [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) send the header on main and auxiliary OpenCode requests. The fix was merged after v0.21.0; that release alone does not include it. |
|**OpenCode**| Sends the session ID automatically. Update older installations.|
115
+
|**Pi**| Current builds send session information for OpenCode. Update older installations.|
116
+
|**Claude Code**| Go recognizes its native session header. No custom-header wrapper is needed.|
117
+
|**ZCode**| Go recognizes its native session header. Our [request for `x-opencode-session`](https://github.com/zai-org/feedback/issues/492) remains open, but it is no longer necessary to send that specific header.|
118
+
|**Codex**| Go recognizes its native session header. Some versions and proxy setups still omit it; preserve the session header when forwarding requests.|
119
+
|**jcode**| Update to **v0.81.6 or later**, which includes the [session-header fix](https://github.com/1jehuang/jcode/issues/1167).|
120
+
|**Hermes**| Builds containing [PR #101864](https://github.com/NousResearch/hermes-agent/pull/101864) send the header on main and auxiliary OpenCode requests. The fix was merged after v0.21.0; that release alone does not include it.|
121
121
|**Kilo Code CLI**| Builds containing [PR #13752](https://github.com/Kilo-Org/kilocode/pull/13752) restore OpenCode session headers. This fix covers the CLI, not the VS Code extension. See [issue #13723](https://github.com/Kilo-Org/kilocode/issues/13723). |
122
122
123
123
### Clients with outstanding integration work
124
124
125
125
These clients have missing or incomplete session support in the versions we
126
126
investigated. The linked reports track fixes and workarounds.
127
127
128
-
| Client | Status and tracking |
129
-
| --- | --- |
130
-
|**DeepSeek Harness**| Session information arrives on some model paths, but is missing on others. We recognize its native header; the remaining work is to send it across all adapters. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495). |
131
-
|**GitHub Copilot Chat**| Automatic session-header support is requested in [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
132
-
|**Kimi Code**| Automatic session-header support is requested in [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506). |
133
-
|**MiMo Code**|[Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) has a proposed fix in [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), which has not yet merged. |
134
-
|**Cursor**| We have not verified automatic session support. Contact [Cursor support](https://forum.cursor.com/) about sending a stable conversation ID. |
135
-
|**WorkBuddy**| We have not verified automatic session support. Contact the team through [WorkBuddy](https://workbuddy.ai/) about sending a stable conversation ID. |
136
-
|**TauriTavern**| The maintainer reports a dedicated OpenCode provider with a stable ID, targeted at the Canary release. See [issue #221](https://github.com/Darkatse/TauriTavern/issues/221) for availability. This integration fix does not change Go's intended use for coding agents. |
|**DeepSeek Harness**| Session information arrives on some model paths, but is missing on others. We recognize its native header; the remaining work is to send it across all adapters. [Discussion #5495](https://github.com/deepseek-ai/deepseek-harness/discussions/5495).|
131
+
|**GitHub Copilot Chat**| Automatic session-header support is requested in [VS Code issue #334186](https://github.com/microsoft/vscode/issues/334186). |
132
+
|**Kimi Code**| Automatic session-header support is requested in [issue #3506](https://github.com/MoonshotAI/kimi-code/issues/3506).|
133
+
|**MiMo Code**|[Issue #2317](https://github.com/XiaomiMiMo/MiMo-Code/issues/2317) has a proposed fix in [PR #2327](https://github.com/XiaomiMiMo/MiMo-Code/pull/2327), which has not yet merged.|
134
+
|**Cursor**| We have not verified automatic session support. Contact [Cursor support](https://forum.cursor.com/) about sending a stable conversation ID.|
135
+
|**WorkBuddy**| We have not verified automatic session support. Contact the team through [WorkBuddy](https://workbuddy.ai/) about sending a stable conversation ID.|
136
+
|**TauriTavern**| The maintainer reports a dedicated OpenCode provider with a stable ID, targeted at the Canary release. See [issue #221](https://github.com/Darkatse/TauriTavern/issues/221) for availability. This integration fix does not change Go's intended use for coding agents. |
137
137
138
138
### SDKs and gateways
139
139
140
140
SDKs do not necessarily own a conversation's lifecycle. If you build your own
141
141
coding client, supply the session ID in your application and give the client a
142
142
distinct user agent. If you use a gateway, preserve the ID from the original client.
143
143
144
-
| Integration | What to do |
145
-
| --- | --- |
146
-
|**Vercel AI SDK**| Pass `x-opencode-session` through the `headers` option on each `generateText` or `streamText` call. [Issue #20271](https://github.com/vercel/ai/issues/20271) was closed: applications must supply the ID. |
147
-
|**OpenAI Agents SDK for Python**| Set `ModelSettings.extra_headers` with the session header. [Issue #4841](https://github.com/openai/openai-agents-python/issues/4841) was closed with this supported configuration. |
148
-
|**LangChain.js**| Add the header through your model client's request-header configuration. [Issue #11547](https://github.com/langchain-ai/langchainjs/issues/11547) tracks the request for automatic support. |
149
-
|**LiteLLM**| Configure your gateway to forward or supply a per-conversation session header. [Issue #39503](https://github.com/BerriAI/litellm/issues/39503) remains open. |
150
-
|**AxonHub**| Session-header support was added in the fix for [issue #2361](https://github.com/looplj/axonhub/issues/2361). Use a build containing that fix and the OpenCode Go channel, and pass a stable session ID from your client; a randomly generated fallback per request does not preserve conversation affinity. |
151
-
|**OpenAI / Anthropic SDKs, fetch, and other HTTP clients**| Add the session header and your application's user agent explicitly. A generic `OpenAI/Python`, `node`, `Bun`, or browser user agent does not identify the coding agent. |
|**Vercel AI SDK**| Pass `x-opencode-session` through the `headers` option on each `generateText` or `streamText` call. [Issue #20271](https://github.com/vercel/ai/issues/20271) was closed: applications must supply the ID.|
147
+
|**OpenAI Agents SDK for Python**| Set `ModelSettings.extra_headers` with the session header. [Issue #4841](https://github.com/openai/openai-agents-python/issues/4841) was closed with this supported configuration.|
148
+
|**LangChain.js**| Add the header through your model client's request-header configuration. [Issue #11547](https://github.com/langchain-ai/langchainjs/issues/11547) tracks the request for automatic support.|
149
+
|**LiteLLM**| Configure your gateway to forward or supply a per-conversation session header. [Issue #39503](https://github.com/BerriAI/litellm/issues/39503) remains open.|
150
+
|**AxonHub**| Session-header support was added in the fix for [issue #2361](https://github.com/looplj/axonhub/issues/2361). Use a build containing that fix and the OpenCode Go channel, and pass a stable session ID from your client; a randomly generated fallback per request does not preserve conversation affinity. |
151
+
|**OpenAI / Anthropic SDKs, fetch, and other HTTP clients**| Add the session header and your application's user agent explicitly. A generic `OpenAI/Python`, `node`, `Bun`, or browser user agent does not identify the coding agent. |
152
152
153
153
For example, create an ID when a conversation starts and reuse it on every
0 commit comments