opencode Release Notes

Core

• Improve wording
• Revert tool attachment fix to prevent them being sent as user messages
• Reinstall plugins when cache module is missing (@kenryu42)

Desktop

• Remember last opened project in app
• Truncate workspace title in app
• Handle new session correctly in app
• Center dialog on page instead of session

Thank you to 3 community contributors:

• @kenryu42:
  • fix(bun): reinstall plugins when cache module missing (#8815)
• @ariane-emory:
  • fix: make home/end keys work in menu list modal windows (resolves #7190) (#8347)

Original source Report a problem

Core

• Upgrade OpenTUI to v0.1.74 and fix tmux kitty keyboard regression
• Ensure that tool attachments aren't sent as user messages
• Use dynamic import for session event in config.ts to avoid circular dependency
• Fix broken URL in documentation (@berenar)
• Fix itemId stripping logic for GPT models
• Revert test fix for image handling
• Update GPT models prompt
• Add OAuth redirect URI configuration for MCP servers (@christso)
• Adjust websearch tool to emphasize current date and clarify it's no longer 2024
• Clarify question tool guidance in documentation (@kitlangton)
• Set OpenCode as user agent for most inference requests
• Show auth URL when browser cannot open in remote sessions (@danlapid)
• Strip item IDs in more cases
• Stop changing main model/agent from subtasks invocation (@dbpolito)
• Fix default agent selection in ACP and headless mode (@assagman)
• Add LiteLLM proxy provider option for explicit compatibility (@seilk)

TUI

• Add version to session header and /status dialog (@AksharP5)
• Correct theme count tip in TUI (@kitlangton)
• Dim question option prefixes in terminal UI (@kitlangton)
• Add tab navigation support for questions in terminal interface (@kitlangton)
• Add Carbonfox theme (@devatnull)

Desktop

• Add ability to edit project and session titles
• Open workspace if navigating to session in workspace
• Can't expand workspaces
• Fixed scroll jumping when expanding workspaces
• Truncate the workspace name on hover
• Fix alignment of load more label
• Update panel minimum size and button maximum width
• Fix session icon and label alignment
• Fixed desktop hamburger menu shifting issue
• Center hamburger menu with project avatars
• Fix mobile menu on web
• Fix responsive menu on desktop
• Moved createMemo down to fix bug
• Updated project and sessions list width
• Fix styles for view all sessions state
• Add default icon to sessions
• Fix search bar sizing, padding, and keyboard shortcut styling
• Fixed avatar border radius and current project display
• Persist workspace order and collapsed state
• Add unified search for commands and files in app
• Add skeleton loader for sessions
• Fix project avatar border radius

SDK

• Update OpenAPI TypeScript SDK generator to version 0.90.4

• Revert SDK OpenAPI TypeScript generator update to 0.90.4

• Update @hey-api/openapi-ts to 0.90.4 (@coleleavitt)

• Thank you to 13 community contributors:

• @seilk:

  • feat: add litellmProxy provider option for explicit LiteLLM compatibility (#8658)

• @devatnull:

  • feat: add Carbonfox theme (#8723)

• @johnnyapu15:

  • fix:subagent reasoningEffort not being applied (#8646)

• @aaroniker:

  • feat(console): Fix /black page View Transition Safari issue (#8755)
  • feat(console): /black shader improvements, performance, details (#8871)

• @assagman:

  • fix(agent): default agent selection in acp and headless mode (#8678)

• @dbpolito:

  • fix: stop changing main model/agent from subtasks invocation (#7681)
  • feat(desktop): Terminal Splits (#8767)

• @ricardo-valero:

  • fix: nix desktop workflow (#8747)

• @danlapid:

  • fix(mcp): show auth URL when browser cannot open in remote sessions (#7884)

• @kitlangton:

  • docs: clarify question tool guidance (#8778)
  • fix(tui): add tab navigation in questions (#8777)
  • fix(tui): dim question option prefixes (#8776)
  • fix(tui): correct theme count tip (#8779)

• @AksharP5:

  • feat: add version to session header and /status dialog (#8802)

• @christso:

  • feat(mcp): add OAuth redirect URI configuration for MCP servers (#7379)

• @coleleavitt:

  • chore(sdk): update @hey-api/openapi-ts to 0.90.4 (#8921)

• @berenar:

  • fix(docs): Broken URL (#8918)

Original source Report a problem

Core

Ensure agent exists before processing title in session summary (@0x404)

More defensive handling of project list to prevent errors

Filter dead worktrees from git worktree list

Load models.dev in development mode

Ensure frontmatter can process same content as other agents

Show toast error message when ConfigMarkdown parsing fails (@vvarp)

Prettify retry duration display in TUI

Handle broken symlinks gracefully in grep tool (@andrew-kramer-inno)

Honor per-server MCP timeouts

Upgrade OpenTUI to v0.1.73, fixing CJK word wrapping and Thai text rendering in non-tmux environments

Add input limit for compaction (@brandon93s)

Fix Codex ID issue

Revert provider-level store option

Allow provider-level store option (@cyhhao)

Make dialog keybinds configurable (@CasualDeveloper)

TUI

Update black plan selection with light rays effect and mobile styles (@aaroniker)

Use native text truncation for sidebar diff paths

Center the initially selected session in the session list (@ariane-emory)

Restore brand integrity of TUI wordmark (@kitlangton)

Desktop

Fix sidebar toggle on desktop

Persist workspace branch selection across sessions

Persist workspace order and collapsed state in sidebar

Fix thinking animation opacity and improve design

Fix session icon and name alignment

Show session as busy even when it's the active session

Stop killing opencode-cli process on dev mode restart (@dbpolito)

Update desktop question tools (@dbpolito)

Fix current session background color

Remove the active state from load more button after press

Fix new session tooltip position and add keyboard shortcut

Remove more options tooltip

Fix workspace name color in UI

Hide "View all sessions" button when on active project page

Fix avatar button states

Reduce font size of load more button

Fix recent sessions title color

Fix project dropdown labels and sorting order

Move left panel toggle button to the right

Fix avatar background color

Show project options on hover of row

Increase delay on session list tooltips

Fix tooltip gutter spacing on session items and archive buttons

Archive icon replaces diff count on hover

Fix hover state for recent sessions in gutter

Fix search bar functionality in header

Fixed layout issues in the app

Fix stale sessions in new layout

New app layout

Open external links in system browser instead of webview in desktop app (@turculaurentiu91)

Thank you to 15 community contributors:

• @CasualDeveloper: feat(tui): make dialog keybinds configurable (#6143) (#6144)
• @kitlangton: fix: restore brand integrity of TUI wordmark (#8584)
• @cyhhao: feat: allow provider-level store option (#8000)
• @ariane-emory: fix(tui): Center the initially selected session in the session_list (resolves #8558) (#8560)
• @brandon93s: fix(opencode): add input limit for compaction (#8465)
• @R44VC0RP: fix: enable sticky header on changelog and download pages (#8556)
• @turculaurentiu91: fix(desktop): open external links in system browser instead of webview (#7360)
• @LAG-4: docs: fix typos in documentation (#8703)
• @andrew-kramer-inno: fix: handle broken symlinks gracefully in grep tool (#8612)
• @vvarp: fix: show toast error message on ConfigMarkdown parse error (#8049)
• @dbpolito: chore(desktop): Question Tools Updates
  chore(desktop): Stop Killing opencode-cli on dev
• @aaroniker: feat(console): Update /black plan selection, light rays effect. mobile styles (#8731)
  feat(console): Style improvements for /black, View Transition fixes (#8739)
• @nathannewyen: docs: add /thinking command documentation (#8722)
• @0x404: fix(session): ensure agent exists before processing title in session summary (#8662)
• @ricardo-valero: fix: update hix hashes for all systems (#8732)

Original source Report a problem

Core

Add error message to prompt users to reauthenticate with Copilot
Official Copilot plugin
Adjust LSP wording to better encourage users to fix issues
Fix plan path permissions
Add check in case provider doesn't exist in models list
Adjust GitLab logic in provider configuration
Add AWS Web Identity Token File support for Bedrock (@bainos)
Add Chocolatey and Scoop to OpenCode upgrade methods (@itsrainingmani)
Remove duplicate path import in session module (@CasualDeveloper)

TUI

Improve question prompt UX in TUI (@kitlangton)

Thank you to 8 community contributors:

• @kitlangton:
  feat(tui): improve question prompt UX (#8339)

• @R44VC0RP:
  fix(homepage): Update FAQ to include desktop and web links (#8453)
  docs: update screenshot images (#8479)
  feat(console): add /changelog page (#8476)
  docs: add Web usage page (#8482)
  fix(console): make logo on /black link back to homepage (#8498)
  feat(console): add OG image and SEO meta tags for /black page (#8506)

• @CasualDeveloper:
  fix(session): remove typo'd duplicate path import (#8408) (#8412)

• @itsrainingmani:
  feat: add choco and scoop to opencode upgrade methods (#8439)

• @aaroniker:
  feat(console/app): Style changes, view transitions, small improvements (#8481)

• @bainos:
  feat(opencode): add AWS Web Identity Token File support for Bedrock (#8461)

• @samiulsami:
  feat(install): respect ZDOTDIR for zsh config detection (#8511)

• @IdrisGit:
  docs: fix permission system documentation in agents section (#7652)

Original source Report a problem

Core

• Do not allow agent to ask custom-less questions
• Improve prompt for explore agent
• Add plugin mocks to provider tests (@vglafirov)
• Update User-Agent string to latest Chrome version in webfetch (@AlanThiec)
• Add plan mode with enter and exit tools
• Add family to GPT 5.2 Codex in Codex plugin
• Add GitLab Duo Agentic Chat provider support (@vglafirov)
• Delete key from recordsByKey on instance disposal (@sauerdaniel)
• Close existing MCP client before reassignment to prevent resource leaks (@sauerdaniel)
• Added Ask Question tool support for desktop application (@dbpolito)

TUI

• Tweak external directory permission rendering in TUI
• Ensure external directory and Bash tool invocations render working directory details
• Fix duplicate radio button icon in MCP auth CLI interface (@dmmulroy)

Desktop

• Handle Shift+Enter before IME check to prevent stuck state in prompt input (@josephbharrison)
• Revert provider icon on select model dialog in desktop app (@dbpolito)

Thank you to 8 community contributors:

• @dbpolito:

  • fix(desktop): Revert provider icon on select model dialog (#8245)
  • feat(desktop): Ask Question Tool Support (#8232)

• @cmdr-chara:

  • feat: add Undertale and Deltarune built-in themes (#8240)

• @sauerdaniel:

  • fix(mcp): close existing client before reassignment to prevent leaks (#8253)
  • fix(state): delete key from recordsByKey on instance disposal (#8252)

• @zeke:

  • docs: document ~/.claude/CLAUDE.md compatibility behavior (#8268)

• @vglafirov:

  • feat: Add GitLab Duo Agentic Chat Provider Support (#7333)
  • fix: Add Plugin Mocks to Provider Tests (#8276)

• @dmmulroy:

  • fix(cli): mcp auth duplicate radio button icon (#8273)

• @josephbharrison:

  • fix(prompt-input): handle Shift+Enter before IME check to prevent stuck state (#8275)

• @AlanThiec:

  • fix: update User-Agent string to latest Chrome version in webfetch (#8284)

Original source Report a problem

Core

• Fixed "load more" button behavior in desktop sidebar (@shanebishop1)
• Fix plan mode when not in git worktree
• Skip duplicate system prompt for Codex OAuth sessions (@zerone0x)

TUI

• Fixed Docker image after SST rename in tips (@goniz)
• Show connected providers in /connect dialog (@AksharP5)
• Deduplicate file references in sent prompts (@felixzsh)
• Track all timeouts in Footer component to prevent memory leaks (@sauerdaniel)
• Make TUI work when OPENCODE_SERVER_PASSWORD is set (@LeonMueller-OneAndOnly)

SDK

• Add missing metadata() and ask() definitions to ToolContext type (@danielmbrasil)

Thank you to 21 community contributors:

• @LeonMueller-OneAndOnly:
  • fix(TUI): make tui work when OPENCODE_SERVER_PASSWORD is set (#8179)
  • fix(github): add persist-credentials: false to workflow templates (#8202)
  • fix(TUI): make tui work when OPENCODE_SERVER_PASSWORD is set (#8179)
• @Eduard-Voiculescu:
  • docs: Update plan mode restrictions (#8290)
  • docs: Update plan mode restrictions (#8290)
• @mthezi:
  • docs: add 302ai provider (#8142)
  • docs: add 302ai provider (#8142)
• @danielmbrasil:
  • fix: add missing metadata() and ask() defintions to ToolContext type (#8269)
  • fix: add missing metadata() and ask() defintions to ToolContext type (#8269)
• @sauerdaniel:
  • fix(tui): track all timeouts in Footer to prevent memory leak (#8255)
  • fix(mcp): close existing client before reassignment to prevent leaks (#8253)
  • fix(state): delete key from recordsByKey on instance disposal (#8252)
  • fix(tui): track all timeouts in Footer to prevent memory leak (#8255)
• @felixzsh:
  • fix: deduplicate file refs in sent prompts (#8303)
  • fix: deduplicate file refs in sent prompts (#8303)
• @usvimal:
  • fix(desktop): correct health check endpoint URL to /global/health (#8231)
• @dbpolito:
  • feat(desktop): Adding Provider Icons (#8215)
  • fix(desktop): Revert provider icon on select model dialog (#8245)
  • feat(desktop): Ask Question Tool Support (#8232)
• @Brendonovich:
  • console: reduce desktop download cache ttl to 5 minutes
• @cmdr-chara:
  • feat: add Undertale and Deltarune built-in themes (#8240)
• @zeke:
  • docs: document ~/.claude/CLAUDE.md compatibility behavior (#8268)
• @vglafirov:
  • feat: Add GitLab Duo Agentic Chat Provider Support (#7333)
  • fix: Add Plugin Mocks to Provider Tests (#8276)
• @dmmulroy:
  • fix(cli): mcp auth duplicate radio button icon (#8273)
• @josephbharrison:
  • fix(prompt-input): handle Shift+Enter before IME check to prevent stuck state (#8275)
• @AlanThiec:
  • fix: update User-Agent string to latest Chrome version in webfetch (#8284)
• @zerone0x:
  • fix(session): skip duplicate system prompt for Codex OAuth sessions (#8357)
• @AksharP5:
  • feat: show connected providers in /connect dialog (#8351)
• @goniz:
  • fix(opencode): fix docker image after sst rename in tips (#8376)
• @neriousy:
  • fix(app): file listing (#8309)
• @ajzbc:
  • fix(ui): layout-bottom icons (#8330)
• @shanebishop1:
  • fix(desktop): "load more" button behavior in desktop sidebar (#8430)

Original source Report a problem

TUI

• Add persist-credentials: false to workflow templates to prevent credential exposure (@LeonMueller-OneAndOnly)
• Add fullscreen view to permission prompt

Desktop

• Add provider icons to desktop application (@dbpolito)
• Correct desktop health check endpoint URL to /global/health (@usvimal)

Thank you to 4 community contributors:

• @usvimal: fix(desktop): correct health check endpoint URL to /global/health (#8231)
• @dbpolito: feat(desktop): Adding Provider Icons (#8215)
• @Brendonovich: console: reduce desktop download cache ttl to 5 minutes
• @LeonMueller-OneAndOnly: fix(github): add persist-credentials: false to workflow templates (#8202)

Original source Report a problem

Core

• Remove the symlinkBinary function call that replaces the wrapper script
• Fix Homebrew auto-upgrade functionality

TUI

• Prevent question tool keybindings when dialog is open (@zerone0x)

Desktop

• Kill existing OpenCode CLI processes on macOS when launching desktop app (@Brendonovich)
• Set serverPassword in desktop app (@Brendonovich)
• Provide PTY socket authentication if available from desktop (@Brendonovich)
• Tie desktop and CLI to the same Windows JobObject (@Brendonovich)

Thank you to 3 community contributors:

• @zerone0x:

  • fix(tui): prevent question tool keybindings when dialog is open (#8147)

• @Brendonovich:

  • feat(desktop): Tie desktop & CLI to the same Windows JobObject (#8153)
  • fix(app): provide pty socket auth if available from desktop (#8210)
  • fix(desktop): set serverPassword

• desktop: macos killall opencode-cli on launch

• @OpeOginni:

  • fix(ui): track memo-based items in useFilteredList without affecting async function based lists (#8216)

Original source Report a problem

Core

• Handle write errors when updating schema in OpenCode config (@ShoeBoom)
• Ensure clear_thinking is disabled for zai model
• Improved edit and write tool feedback to prevent confusion about whether changes were successfully applied
• Prevent [object Object] error display in console output (@lengmodkx)
• Respect agent task permission for nested sub-agents (@malhashemi)
• Fix max completion tokens error for Cloudflare provider (@roerohan)
• Use reasoningConfig for Anthropic models on Bedrock (@Adam8234)
• Store API URL in session metadata (@jkoelker)
• Add nova-2 to region prefix models
• Tweak truncation directory permissions
• Make environment file reads ask user for permission instead of blocking
• Use Biome check instead of format to include import sorting (@kynnyhsap)
• Ensure plurals are properly handled

TUI

• Support debug tool calling directly in CLI (@Eric-Guo)
• Don't submit prompt when switching sessions (@LeonMueller-OneAndOnly)
• Await auth.set to prevent race condition when setting API key (@darshkpatel)
• Actually modify OpenCode config when adding MCP servers with mcp add command (@paoloricciuti)

Desktop

• Spawn local server with password in desktop app (@Brendonovich)
• Add missing args to Windows Tauri CLI spawn (@pschiel)
• Implement better dynamic terminal numbering (@OpeOginni)
• Add icon button for server removal in dialog select server (@OpeOginni)

Contributors

• @kynnyhsap:
  fix(formatter): use biome check instead of format to include import sorting (#8057)

• @OpeOginni:
  feat(dialog-select-server): add icon button for server removal (#8053)
  feat(terminal): implement better dynamic terminal numbering (#8081)

• @jkoelker:
  fix(session): store api url in metadata (#8090)

• @paoloricciuti:
  fix: actually modify opencode config with mcp add (#7339)

• @jerome-benoit:
  fix(nix): initialize hashes.json with per-system format (#8095)

• @darshkpatel:
  fix: await auth.set to prevent race condition when setting API key (#8075)

• @Adam8234:
  fix(bedrock): use reasoningConfig for Anthropic models on Bedrock (#8092)

• @roerohan:
  fix: max completion tokens error for cloudflare (#7970)

• @malhashemi:
  fix(task): respect agent task permission for nested sub-agents (#8111)

• @pschiel:
  fix: add missing args to windows tauri cli spawn (#8084)

• @lengmodkx:
  fix: prevent [object Object] error display in console output (#8116)

• @LeonMueller-OneAndOnly:
  fix(TUI): dont submit prompt when switching sessions (#8016)

• @Eric-Guo:
  feat(cli): Support debug tool calling directly in CLI. (#6564)

• @ShoeBoom:
  fix(config): handle write errors when updating schema in opencode config (#8125)

• @Brendonovich:
  feat(desktop): spawn local server with password (#8139)

Original source Report a problem