[FEATURE]: opencode://new-session in OpenCode 2's desktop app, as in OpenCode 1 #55106

Activity

1. opencode-agent commented on Oct 13, 2026

   

   opencode-agentBot

   on Oct 13, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed request, @Xrpfant!

   To restate it: you'd like the OpenCode 2 desktop app to handle opencode://new-session?directory=<dir>&prompt=<text> again, ideally with an optional model=, and open a new draft session in that directory with the prompt filled in, the way OpenCode 1 did. That would let a setup command sign the user in and then drop them straight into their project.

   I checked, and it matches what you found. On v2 the desktop app only handles opencode://console/authorized. Other links reach the page, but nothing acts on them yet. This can't be done with a plugin either, because handling the link happens in the desktop app, not in the server where plugins run. Maintainers will consider it.

   Related issues and PRs:

   • feat(desktop): open a session via opencode:// deep link #54187: open PR adding opencode://session/<id> to the v2 desktop app (same deep-link handling)
   • Add a deep link to open a specific Desktop session #44167: deep link to open a specific Desktop session
   • [FEATURE]: Allow API clients and agents to open existing sessions as Desktop tabs #53529: let API clients open existing sessions as Desktop tabs
   • [FEATURE]: Deep link to add an MCP server (opencode://add-mcp) #51919: opencode://add-mcp deep link
   • Desktop deep links can open projects before they are recognized #43472 and [FEATURE]: Allow desktop prompt deeplinks to use the current workspace #34762: earlier reports about new-session links, from before OpenCode 2
2. ahatzz11 commented on Nov 1, 2026

   

   ahatzz11

   on Nov 1, 2026

   More actions

   Still the case in desktop 2.2.5 on macOS:

   open "opencode://new-session?directory=$HOME/code/hex&prompt=hello%20from%20hex"
   

   The app comes to the front, but it reopens the last-used project on an empty new-session view. The directory and prompt are both dropped, whether the app was already running or not.

   Another use case: Hex's Output pane wants an "Edit with agent" button that opens a fresh OpenCode session with a prompt already typed in but not sent (anomalyco/hex#789). This link, opening a draft rather than sending, is exactly what it needs.