bug: opencode.nvim not connecting to existing opencode session

[ridwanyinus]

Did you check docs and existing issues?

• I have read the plugin docs
• I have read the opencode docs
• I have searched the existing plugin issues
• I have searched the existing opencode issues

:checkhealth opencode output

============================================================================== opencode: 1 ❌ - ❌ ERROR No healthcheck found for "opencode" plugin.

Describe the bug

When I have an existing opencode session running, opencode.nvim starts a new session instead of connecting to the existing one.

Steps To Reproduce

Start opencode manually in Kitty terminal with command: opencode
Open Neovim from the same directory
Trigger opencode.nvim with oc
Observe: A new opencode session starts instead of connecting to existing one

Expected Behavior

According to the config documentation:
If nil, searches for an opencode process in Neovim's CWD.
I expected opencode.nvim to automatically detect and connect to my existing opencode process.

Configuration

return {
   "nickjvandyke/opencode.nvim",
   dependencies = {
      -- Recommended for `ask()` and `select()`.
      -- Required for `snacks` provider.
      ---@module 'snacks' <- Loads `snacks.nvim` types for configuration intellisense.
      { "folke/snacks.nvim", opts = { input = {}, picker = {}, terminal = {} } },
   },
   config = function()
      ---@type opencode.Opts
      vim.g.opencode_opts = {
         -- Your configuration, if any — see `lua/opencode/config.lua`, or "goto definition" on the type or field.
      }

      -- Required for `opts.events.reload`.
      vim.o.autoread = true
   end,
}

Environment

OS: linux [cachy os]
Neovim version: v0.11.5
opencode.nvim version: a13db1c
opencode version: 1.0.203
Terminal: Kitty
shell: fish

Additional info

Running ss -tlnp | grep opencode shows:

• Manual instance (pid=364834): Port 4096
• Plugin instance (pid=365202): Port 39801

[ridwanyinus]

adding lazy = false to plugin config and running :checkhealth opencode
output:

opencode: 3 ⚠️

opencode.nvim ~

• OS: Linux 6.18.6-2-cachyos (x86_64)
• nvim version: 0.11.5+v0.11.5.
• opencode.nvim git commit hash: a13db1c0364319d3ebde65030005dea9f8a198cc.
• vim.g.opencode_opts: {}

opencode.nvim [binaries] ~

• ✅ OK opencode available with version 1.0.203.
• ⚠️ WARNING opencode version has an older minor version than latest tested version 1.1.11: may cause compatibility issues.
  • ADVICE:
    • Update opencode.
• ✅ OK curl available.
• ✅ OK pgrep available.
• ✅ OK lsof available.

opencode.nvim [snacks] ~

• ✅ OK snacks.input is enabled: ask() will be enhanced.
• ✅ OK blink.cmp is available: opts.ask.blink_cmp_sources will be registered in ask().
• ✅ OK snacks.picker is enabled: select() will be enhanced.

opencode.nvim [providers] ~

• ✅ OK Configured opencode provider: snacks.
• ✅ OK The snacks provider is available.
• ✅ OK The kitty provider is available.
• ⚠️ WARNING The wezterm provider is not available — wezterm executable not found in $PATH.
  • ADVICE:
    • Install wezterm and ensure it's in your $PATH.
• ⚠️ WARNING The tmux provider is not available — Not running in a tmux session.
  • ADVICE:
    • Launch Neovim in a tmux session.
• ✅ OK The terminal provider is available.

[nickjvandyke]

Start opencode manually in Kitty terminal with command: opencode

You need the --port flag so opencode exposes its server 🙂

[ridwanyinus]

Start opencode manually in Kitty terminal with command: opencode

You need the --port flag so opencode exposes its server 🙂

okay, thank you.

[ridwanyinus]

Start opencode manually in Kitty terminal with command: opencode

You need the --port flag so opencode exposes its server 🙂

I tried starting OpenCode with the port flag and opening OpenCode.nvim, which displays this server selection picker, but these are not current running sessions but old sessions that's closed. Additionally, choosing either of them is not functioning as planned.