# OpenCode: known issues context pack (KnownFix)
Generated 2026-10-26T10:18:14Z from github.com/anomalyco/opencode. Auto-extracted; verify via links. Source: https://knownfix.ai/issues/opencode/
Fields: severity (auto-estimate) | symptom | versions mentioned | workaround (quoted from issue/comments, if any) | fixed-in (if referenced).

## Active
- [HIGH] Is there a way to sandbox the agent ? (https://github.com/anomalyco/opencode/issues/2242)
  - symptom: Is there a way to restrict terminal command from a agent to access/edit file outside the current directory ? I see that gemini-cli or codex-cli use seatbelt on macOS
  - error: `Is there a way to restrict terminal command from a agent to access/edit file outside the current directory ?`
  - workaround: none stated
- [MEDIUM] desktop: custom provider save always throws "unavailable on this server" (https://github.com/anomalyco/opencode/issues/50650)
  - symptom: OpenCode Desktop exposes the "Custom OpenAI-compatible provider" form in Settings → Providers, but the save handler unconditionally throws provider.custom.unavailable, so the flow can never succeed on
  - versions: 2.0.14
  - error: `throw Error(a.t(`provider.custom.unavailable`))`
  - workaround: none stated
- [MEDIUM] Unable to install OpenCode on windows with winget command (https://github.com/anomalyco/opencode/issues/56297)
  - symptom: Unable to install OpenCode on windows with winget command I follow the instruction described in Changelog: https://github.com/anomalyco/opencode/blob/dev/CHANGELOG.md#highlights-3 The root cause…
  - error: `Unable to install OpenCode on windows with winget command`
  - workaround: none stated
- [MEDIUM] migrate-v1: non-git sessions in "global" project hidden after V1→V2 upgrade (https://github.com/anomalyco/opencode/issues/49827)
  - symptom: After upgrading from V1.18.31 to V2.0.8, sessions that V1 stored in the global project (sessions created in non-git directories) become invisible in the TUI session picker, because V2 creates a per-di
  - versions: 2.0.8, 1.18.31
  - error: `("List all sessions") shows everything, including the`
  - workaround: Before repair: 104 sessions total, 93 with `project_id = 'global'` (81 in `/home/wjf`, 8 in `/tmp/opencode`, 3 in `/home/wjf/novel`, 1 in `/home/wjf/videos`). - Sessions in a git repository were unaffected: `/home/wjf/fadebreak` kept a stab [issue body]
- [MEDIUM] [gateway] 30-image cap applied only to some session routes: identical request flips 400/200 with only x-opencode-session (https://github.com/anomalyco/opencode/issues/51073)
  - symptom: The OpenCode Go gateway (https://opencode.ai/zen/go/v1) enforces a 30-image-per-request cap on only some routes: enforcement follows the x-opencode-session routing value and the model
  - versions: 3.14.3, 2.6-flash
  - error: `Turn execution failed provider=opencode-go-chat-2 model=deepseek-v4.1-flash request=4c9964bb-0208-4ac5-816e-5bef6aa07af6 reason=invalid_request status=400 retry`
  - workaround: Workaround used: temporarily switch the model/provider, compact there, switch back. - The same request works or fails purely based on the session header, which is extremely hard for users to diagnose. - Compounds #47493 (no client-side medi [issue body]
- [MEDIUM] openai: ChatGPT OAuth requests use Zen API key (https://github.com/anomalyco/opencode/issues/49847)
  - symptom: incorrectly binds the OpenAI provider to the OpenCode Zen integration, causing a Zen API key to be sent to ChatGPT’s OAuth-only Codex endpoint
  - versions: 2.0.8
  - error: `incorrectly binds the OpenAI provider to the OpenCode Zen integration, causing a Zen API key to be sent to ChatGPT’s OAuth-only Codex endpoint. OpenAI rejects t`
  - workaround: none stated
- [MEDIUM] run: --command removed in v2 and slash commands are not expanded — no CLI path for headless command invocation (https://github.com/anomalyco/opencode/issues/49903)
  - symptom: OpenCode 2.0.8 removed --command from opencode run, and run does not expand slash commands in the message, so there is no CLI way to invoke a command headlessly
  - versions: 2.0.8
  - error: `... we expect the flag". The migrate-v1 guide also says command definitions in`
  - workaround: none stated
- [MEDIUM] terminal does not clipboard read (kitty OSC 5522) for image paste over SSH (https://github.com/anomalyco/opencode/issues/48628)
  - symptom: I use the TUI over SSH and can't paste images
  - versions: 0.0.0-beta
  - error: `I use the TUI over SSH and can't paste images. Unsure if it's a bug or a gap in the design: the clipboard I want to read is on my laptop, but the TUI is running`
  - workaround: none stated
- [MEDIUM] Models get stuck on "Thinking" after a few hours (https://github.com/anomalyco/opencode/issues/49033)
  - symptom: After using OpenCode for a few hours, any model I try gets stuck indefinitely on "Thinking"
  - error: `There is no error message and the request never finishes. Switching to another model does not help.`
  - workaround: none stated

## Recently closed (with fix/workaround info)
- OpenCode v1.17.10 crashes with Bun segmentation fault on Windows; v1.17.9 appears stable (https://github.com/anomalyco/opencode/issues/33742); workaround: Downgrading to `opencode-ai@1.17.9` appears to avoid the fatal crash under the same environment and workflow.
- Regression in 1.18.30: every prompt crashes with TypeError in SystemPrompt.environment ("a.name") — 1.18.18 wo (https://github.com/anomalyco/opencode/issues/48645); workaround: Downgrading to 1.18.18 (via the cached pacman package) fixes it immediately — same machine, same everything else.
- Android/Bionic: Bun 1.4.1 splitting:true causes a.name crash (https://github.com/anomalyco/opencode/issues/49262); workaround: `minify:true, splitting:false`