@xinleibird/bridge-opencode 0.0.1

package/.cargo/config.toml

@@ -0,0 +1,3 @@
+[alias]
+check-all = "check --features napi"
+build-release = "build --release --features napi"

package/Cargo.lock

@@ -0,0 +1,386 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "anyhow"
+version = "1.0.100"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61"
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "bitflags"
+version = "2.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c4512299f36f043ab09a583e57bceb5a5aab7a73db1805848e8fef3c9e8c78b3"
+
+[[package]]
+name = "bridge-opencode"
+version = "0.0.1"
+dependencies = [
+ "anyhow",
+ "glob",
+ "napi",
+ "napi-build",
+ "napi-derive",
+ "neovim-lib",
+ "rmp",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "byteorder"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
+
+[[package]]
+name = "cfg-if"
+version = "0.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4785bdd1c96b2a846b2bd7cc02e86b6b3dbf14e7e53446c4f54c92a361040822"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "convert_case"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec182b0ca2f35d8fc196cf3404988fd8b8c739a4d270ff118a398feb0cbec1ca"
+dependencies = [
+ "unicode-segmentation",
+]
+
+[[package]]
+name = "ctor"
+version = "0.2.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a2785755761f3ddc1492979ce1e48d2c00d09311c39e4466429188f3dd6501"
+dependencies = [
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "glob"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0cc23270f6e1808e30a928bdc84dea0b9b4136a8bc82338574f23baf47bbd280"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if 1.0.4",
+ "windows-link",
+]
+
+[[package]]
+name = "log"
+version = "0.4.29"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e5032e24019045c762d3c0f28f5b6b8bbf38563a65908389bf7978758920897"
+
+[[package]]
+name = "memchr"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+
+[[package]]
+name = "napi"
+version = "2.16.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "55740c4ae1d8696773c78fdafd5d0e5fe9bc9f1b071c7ba493ba5c413a9184f3"
+dependencies = [
+ "bitflags",
+ "ctor",
+ "napi-derive",
+ "napi-sys",
+ "once_cell",
+]
+
+[[package]]
+name = "napi-build"
+version = "2.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c9c366d2c8c60b86fa632df75f745509b52f9128f91a6bad4c796e44abb505e1"
+
+[[package]]
+name = "napi-derive"
+version = "2.16.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7cbe2585d8ac223f7d34f13701434b9d5f4eb9c332cccce8dee57ea18ab8ab0c"
+dependencies = [
+ "cfg-if 1.0.4",
+ "convert_case",
+ "napi-derive-backend",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "napi-derive-backend"
+version = "1.0.75"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1639aaa9eeb76e91c6ae66da8ce3e89e921cd3885e99ec85f4abacae72fc91bf"
+dependencies = [
+ "convert_case",
+ "once_cell",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "semver",
+ "syn",
+]
+
+[[package]]
+name = "napi-sys"
+version = "2.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "427802e8ec3a734331fec1035594a210ce1ff4dc5bc1950530920ab717964ea3"
+dependencies = [
+ "libloading",
+]
+
+[[package]]
+name = "neovim-lib"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6a8f5a1e1be160ce2b669c2c495a34ade6f3a525d4afafd7370c1792070f587"
+dependencies = [
+ "log",
+ "rmp",
+ "rmpv",
+ "unix_socket",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "paste"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "535d180e0ecab6268a3e718bb9fd44db66bbbc256257165fc699dadf70d16fe7"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "regex"
+version = "1.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e10754a14b9137dd7b1e3e5b0493cc9171fdd105e0ab477f51b72e7f3ac0e276"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e1dd4122fc1595e8162618945476892eefca7b88c52820e74af6262213cae8f"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
+
+[[package]]
+name = "rmp"
+version = "0.8.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "228ed7c16fa39782c3b3468e974aec2795e9089153cd08ee2e9aefb3613334c4"
+dependencies = [
+ "byteorder",
+ "num-traits",
+ "paste",
+]
+
+[[package]]
+name = "rmpv"
+version = "0.4.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c760afe11955e16121e36485b6b828326c3f0eaff1c31758d96dbeb5cf09fd5"
+dependencies = [
+ "num-traits",
+ "rmp",
+ "serde",
+ "serde_bytes",
+]
+
+[[package]]
+name = "semver"
+version = "1.0.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a7852d02fc848982e0c167ef163aaff9cd91dc640ba85e263cb1ce46fae51cd"
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_bytes"
+version = "0.11.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a5d440709e79d88e51ac01c4b72fc6cb7314017bb7da9eeff678aa94c10e3ea8"
+dependencies = [
+ "serde",
+ "serde_core",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.150"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.114"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4d107df263a3013ef9b1879b0df87d706ff80f65a86ea879bd9c31f9b307c2a"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
+
+[[package]]
+name = "unicode-segmentation"
+version = "1.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9629274872b2bfaf8d66f5f15725007f635594914870f65218920345aa11aa8c"
+
+[[package]]
+name = "unix_socket"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6aa2700417c405c38f5e6902d699345241c28c0b7ade4abaad71e35a87eb1564"
+dependencies = [
+ "cfg-if 0.1.10",
+ "libc",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

package/Cargo.toml

@@ -0,0 +1,26 @@
+[package]
+name = "bridge-opencode"
+version = "0.0.1"
+edition = "2024"
+
+[lib]
+crate-type = ["cdylib", "lib"]
+
+[build-dependencies]
+napi-build = "2"
+
+[features]
+default = []
+napi = ["dep:napi", "dep:napi-derive"]
+
+[dependencies]
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+anyhow = "1.0"
+neovim-lib = "0.6"
+glob = "0.3"
+napi = { version = "2", default-features = false, features = ["napi6"], optional = true }
+napi-derive = { version = "2", optional = true }
+
+# Pin rmp to avoid breaking changes in 0.8.15 that break rmpv 0.4.7 (used by neovim-lib)
+rmp = "=0.8.14"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nishant Joshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# bridge-opencode
+
+Bridge between opencode and Neovim.
+
+Inspired by / forked from [sidekick](https://github.com/NishantJoshi00/sidekick) — thanks [@NishantJoshi00](https://github.com/NishantJoshi00).
+
+## Structure
+
+- `plugin/bridge.lua` — Neovim plugin, starts msgpack-rpc socket
+- `bridge.ts` — opencode plugin entry (npm package main)
+- `src/` — Rust source (napi-rs native addon)
+
+## Install
+
+### Neovim plugin (lazy.nvim)
+
+```lua
+{
+  "xinleibird/bridge-opencode",
+  priority = 1000,
+  lazy = false,
+}
+```
+
+`plugin/bridge.lua` auto-starts the RPC socket when Neovim launches.
+
+### opencode plugin
+
+```sh
+cd ~/.config/opencode && npm install @xinleibird/bridge-opencode
+```
+
+```json
+{
+  "plugin": ["@xinleibird/bridge-opencode"]
+}
+```
+
+The `postinstall` script compiles the Rust native addon via napi-rs.

package/bridge.ts

@@ -0,0 +1,128 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import { isAbsolute, join } from "node:path";
+import {
+  checkBuffer,
+  refreshBuffer,
+  getVisualSelections,
+} from "./bridge-opencode.js";
+
+type ToolName = "Edit" | "Write";
+
+const TOOL_MAP: Record<string, ToolName> = {
+  edit: "Edit",
+  write: "Write",
+};
+
+const PATCH_FILE_MARKERS = [
+  "*** Add File:",
+  "*** Update File:",
+  "*** Delete File:",
+  "*** Move to:",
+];
+
+function pickFilePath(args: unknown): string | null {
+  if (!args || typeof args !== "object") return null;
+  const candidate = (args as Record<string, unknown>).filePath;
+  return typeof candidate === "string" && candidate.length > 0
+    ? candidate
+    : null;
+}
+
+function pickPatchPaths(args: unknown): string[] {
+  if (!args || typeof args !== "object") return [];
+  const patch = (args as Record<string, unknown>).patchText;
+  if (typeof patch !== "string") return [];
+
+  const paths: string[] = [];
+  for (const line of patch.split("\n")) {
+    const trimmed = line.trimStart();
+    for (const marker of PATCH_FILE_MARKERS) {
+      if (trimmed.startsWith(marker)) {
+        const candidate = trimmed.slice(marker.length).trim();
+        if (candidate) paths.push(candidate);
+        break;
+      }
+    }
+  }
+  return paths;
+}
+
+function resolveCall(
+  tool: string,
+  args: unknown,
+  cwd: string,
+): { filePaths: string[] } | null {
+  const abs = (p: string) => (isAbsolute(p) ? p : join(cwd, p));
+
+  if (tool === "apply_patch") {
+    return { filePaths: pickPatchPaths(args).map(abs) };
+  }
+
+  const toolName = TOOL_MAP[tool];
+  if (!toolName) return null;
+
+  const raw = pickFilePath(args);
+  return { filePaths: raw ? [abs(raw)] : [] };
+}
+
+export const BridgePlugin: Plugin = async ({ directory }) => {
+  const cwd = directory ?? process.cwd();
+  const pendingByCallID = new Map<string, { filePaths: string[] }>();
+
+  return {
+    "tool.execute.before": async (input, output) => {
+      const call = resolveCall(input.tool, output.args, cwd);
+      if (!call || call.filePaths.length === 0) return;
+
+      for (const filePath of call.filePaths) {
+        const status = await checkBuffer(filePath);
+        if (status.hasUnsavedChanges && status.isCurrent) {
+          throw new Error(
+            "bridge: file has unsaved changes in Neovim",
+          );
+        }
+      }
+
+      pendingByCallID.set(input.callID, call);
+    },
+
+    "tool.execute.after": async (input) => {
+      const pending = pendingByCallID.get(input.callID);
+      if (!pending) return;
+      pendingByCallID.delete(input.callID);
+
+      for (const filePath of pending.filePaths) {
+        await refreshBuffer(filePath);
+      }
+    },
+
+    "chat.message": async (_input, output) => {
+      let selections;
+      try {
+        selections = await getVisualSelections();
+      } catch {
+        return;
+      }
+      if (!selections || selections.length === 0) return;
+
+      const filteredSelections = selections.filter(
+        (s) => !s.cwd || s.cwd === cwd,
+      );
+      if (filteredSelections.length === 0) return;
+
+      const textPart = output.parts.find((p: any) => p.type === "text") as any;
+      if (!textPart || typeof textPart.text !== "string") return;
+
+      const lines = filteredSelections.map((s) => {
+        const path = s.filePath.startsWith(cwd + "/")
+          ? "@" + s.filePath.slice(cwd.length + 1)
+          : s.filePath;
+        return `${path}:${s.startLine}-${s.endLine}`;
+      });
+
+      textPart.text = `${lines.join("\n")}\n\n${textPart.text}`;
+    },
+  };
+};
+
+export default BridgePlugin;

package/build.rs

@@ -0,0 +1,5 @@
+extern crate napi_build;
+
+fn main() {
+    napi_build::setup();
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@xinleibird/bridge-opencode",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "bridge.ts",
+  "exports": {
+    ".": {
+      "import": "./bridge.ts",
+      "default": "./bridge.ts"
+    }
+  },
+  "scripts": {
+    "build": "napi build --platform --release",
+    "postinstall": "npm run build"
+  },
+  "napi": {
+    "name": "bridge-opencode",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "aarch64-apple-darwin",
+        "x86_64-apple-darwin"
+      ]
+    }
+  },
+  "dependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  }
+}

package/src/action/neovim/buffer.rs

@@ -0,0 +1,90 @@
+use super::lua;
+use crate::action::{BufferStatus, EditorContext};
+use anyhow::{Context, Result};
+use neovim_lib::{Neovim, NeovimApi, neovim_api::Buffer};
+use std::path::PathBuf;
+
+pub fn find_buffer(nvim: &mut Neovim, file_path: &str) -> Result<Buffer> {
+    let buffers = nvim.list_bufs().context("couldn't list buffers")?;
+
+    let target_path = PathBuf::from(file_path)
+        .canonicalize()
+        .unwrap_or_else(|_| PathBuf::from(file_path));
+
+    for buffer in buffers {
+        let buf_name = buffer.get_name(nvim).context("couldn't read buffer name")?;
+
+        if buf_name.is_empty() {
+            continue;
+        }
+
+        let buf_path = PathBuf::from(&buf_name)
+            .canonicalize()
+            .unwrap_or_else(|_| PathBuf::from(&buf_name));
+
+        if buf_path == target_path {
+            return Ok(buffer);
+        }
+    }
+
+    anyhow::bail!("file not open in Neovim: {}", file_path)
+}
+
+pub fn get_buffer_status(nvim: &mut Neovim, file_path: &str) -> Result<BufferStatus> {
+    let buffer = find_buffer(nvim, file_path)?;
+    let current_buf = nvim.get_current_buf()?;
+    let is_current = buffer == current_buf;
+
+    let modified = buffer.get_option(nvim, "modified")?;
+    let has_unsaved_changes = modified.as_bool().unwrap_or(false);
+
+    Ok(BufferStatus {
+        is_current,
+        has_unsaved_changes,
+    })
+}
+
+pub fn refresh_buffer(nvim: &mut Neovim, file_path: &str) -> Result<()> {
+    let buffer = find_buffer(nvim, file_path)?;
+    let buf_number = buffer.get_number(nvim)?;
+
+    let lua_code = lua::refresh_buffer_lua(buf_number);
+
+    nvim.execute_lua(&lua_code, vec![])
+        .map(|_| ())
+        .context("couldn't reload buffer")
+}
+
+pub fn get_visual_selection(nvim: &mut Neovim) -> Result<Option<EditorContext>> {
+    let lua_code = lua::get_visual_selection_lua();
+
+    let result = nvim
+        .execute_lua(lua_code, vec![])
+        .context("couldn't read visual selection")?;
+
+    if result.is_nil() {
+        return Ok(None);
+    }
+
+    let json_str = result.as_str().context("unexpected response from Neovim")?;
+
+    #[derive(serde::Deserialize)]
+    struct SelectionData {
+        file_path: String,
+        start_line: u32,
+        end_line: u32,
+        cwd: String,
+        content: String,
+    }
+
+    let data: SelectionData =
+        serde_json::from_str(json_str).context("couldn't parse visual selection")?;
+
+    Ok(Some(EditorContext {
+        file_path: data.file_path,
+        start_line: data.start_line,
+        end_line: data.end_line,
+        cwd: data.cwd,
+        content: data.content,
+    }))
+}

package/src/action/neovim/connection.rs

@@ -0,0 +1,53 @@
+use crate::constants::NEOVIM_RPC_TIMEOUT;
+use anyhow::{Context, Result};
+use neovim_lib::{Neovim, Session};
+use std::path::PathBuf;
+
+pub fn connect(socket_path: &PathBuf) -> Result<Neovim> {
+    let mut session =
+        Session::new_unix_socket(socket_path).context("couldn't connect to Neovim")?;
+    session.set_timeout(NEOVIM_RPC_TIMEOUT);
+    session.start_event_loop();
+    Ok(Neovim::new(session))
+}
+
+pub fn for_each_instance<F>(socket_paths: &[PathBuf], mut f: F) -> bool
+where
+    F: FnMut(&mut Neovim) -> Result<()>,
+{
+    socket_paths
+        .iter()
+        .filter_map(|path| connect(path).ok())
+        .any(|mut nvim| f(&mut nvim).is_ok())
+}
+
+pub fn try_fold_instances<T, F>(socket_paths: &[PathBuf], init: T, mut f: F) -> Option<T>
+where
+    F: FnMut(&mut T, &mut Neovim) -> Result<bool>,
+{
+    let mut any_processed = false;
+
+    let result = socket_paths
+        .iter()
+        .filter_map(|path| connect(path).ok())
+        .try_fold(init, |mut acc, mut nvim| match f(&mut acc, &mut nvim) {
+            Ok(should_continue) => {
+                any_processed = true;
+                if should_continue { Ok(acc) } else { Err(acc) }
+            }
+            Err(_) => Ok(acc),
+        });
+
+    any_processed.then(|| result.unwrap_or_else(|acc| acc))
+}
+
+pub fn collect_all<T, F>(socket_paths: &[PathBuf], mut f: F) -> Vec<T>
+where
+    F: FnMut(&mut Neovim) -> Result<Option<T>>,
+{
+    socket_paths
+        .iter()
+        .filter_map(|path| connect(path).ok())
+        .filter_map(|mut nvim| f(&mut nvim).ok().flatten())
+        .collect()
+}

package/src/action/neovim/lua.rs

@@ -0,0 +1,74 @@
+pub fn refresh_buffer_lua(buf_number: i64) -> String {
+    format!(
+        r#"
+        local buf = {}
+        local cursor_positions = {{}}
+        local is_current_buf = vim.api.nvim_get_current_buf() == buf
+
+        for _, win in ipairs(vim.api.nvim_list_wins()) do
+            if vim.api.nvim_win_get_buf(win) == buf then
+                cursor_positions[win] = vim.api.nvim_win_get_cursor(win)
+            end
+        end
+
+        vim.api.nvim_buf_call(buf, function()
+            vim.cmd('checktime')
+            vim.cmd('edit')
+        end)
+
+        for win, pos in pairs(cursor_positions) do
+            if vim.api.nvim_win_is_valid(win) then
+                pcall(vim.api.nvim_win_set_cursor, win, pos)
+            end
+        end
+
+        if is_current_buf then
+            vim.cmd('redraw')
+        end
+        "#,
+        buf_number
+    )
+}
+
+pub fn send_notification_lua(message: &str) -> String {
+    format!(
+        r#"vim.notify("{}", vim.log.levels.WARN)"#,
+        message.replace('"', r#"\""#)
+    )
+}
+
+pub fn get_visual_selection_lua() -> &'static str {
+    r#"
+    local mode = vim.fn.mode()
+    if not mode:match('[vV\22]') then
+        return nil
+    end
+
+    local start_pos = vim.fn.getpos("v")
+    local end_pos = vim.fn.getpos(".")
+    local sel_type = mode:sub(1, 1)
+
+    if start_pos[2] == 0 or end_pos[2] == 0 then
+        return nil
+    end
+
+    local file_path = vim.api.nvim_buf_get_name(0)
+    if file_path == "" then
+        return nil
+    end
+
+    local lines = vim.fn.getregion(start_pos, end_pos, { type = sel_type })
+    local content = table.concat(lines, "\n")
+
+    local start_line = math.min(start_pos[2], end_pos[2])
+    local end_line = math.max(start_pos[2], end_pos[2])
+
+    return vim.fn.json_encode({
+        file_path = file_path,
+        start_line = start_line,
+        end_line = end_line,
+        content = content,
+        cwd = vim.fn.getcwd()
+    })
+    "#
+}

package/src/action/neovim.rs

@@ -0,0 +1,74 @@
+mod buffer;
+mod connection;
+mod lua;
+
+use crate::action::{Action, BufferStatus, EditorContext};
+use anyhow::Result;
+use neovim_lib::NeovimApi;
+use std::path::PathBuf;
+
+pub struct NeovimAction {
+    socket_paths: Vec<PathBuf>,
+}
+
+impl NeovimAction {
+    pub fn new(socket_paths: Vec<PathBuf>) -> Self {
+        Self { socket_paths }
+    }
+}
+
+impl Action for NeovimAction {
+    fn buffer_status(&self, file_path: &str) -> Result<BufferStatus> {
+        let status = connection::try_fold_instances(
+            &self.socket_paths,
+            (false, false),
+            |(is_current_acc, unsaved_acc), nvim| {
+                let status = buffer::get_buffer_status(nvim, file_path)?;
+
+                *is_current_acc = *is_current_acc || status.is_current;
+                *unsaved_acc = *unsaved_acc || status.has_unsaved_changes;
+
+                Ok(!*unsaved_acc)
+            },
+        )
+        .unwrap_or((false, false));
+
+        Ok(BufferStatus {
+            is_current: status.0,
+            has_unsaved_changes: status.1,
+        })
+    }
+
+    fn refresh_buffer(&self, file_path: &str) -> Result<()> {
+        let any_success = connection::for_each_instance(&self.socket_paths, |nvim| {
+            buffer::refresh_buffer(nvim, file_path)
+        });
+
+        if any_success {
+            Ok(())
+        } else {
+            anyhow::bail!("couldn't refresh Neovim")
+        }
+    }
+
+    fn send_message(&self, message: &str) -> Result<()> {
+        let lua_code = lua::send_notification_lua(message);
+        let any_success = connection::for_each_instance(&self.socket_paths, |nvim| {
+            nvim.execute_lua(&lua_code, vec![])
+                .map(|_| ())
+                .map_err(|e| anyhow::anyhow!("couldn't send to Neovim: {}", e))
+        });
+
+        if any_success {
+            Ok(())
+        } else {
+            anyhow::bail!("couldn't send to Neovim")
+        }
+    }
+
+    fn get_visual_selections(&self) -> Result<Vec<EditorContext>> {
+        Ok(connection::collect_all(&self.socket_paths, |nvim| {
+            buffer::get_visual_selection(nvim)
+        }))
+    }
+}

package/src/action.rs

@@ -0,0 +1,23 @@
+pub mod neovim;
+
+#[derive(Debug, Clone)]
+pub struct BufferStatus {
+    pub is_current: bool,
+    pub has_unsaved_changes: bool,
+}
+
+#[derive(Debug, Clone)]
+pub struct EditorContext {
+    pub file_path: String,
+    pub start_line: u32,
+    pub end_line: u32,
+    pub cwd: String,
+    pub content: String,
+}
+
+pub trait Action {
+    fn buffer_status(&self, file_path: &str) -> anyhow::Result<BufferStatus>;
+    fn refresh_buffer(&self, file_path: &str) -> anyhow::Result<()>;
+    fn send_message(&self, message: &str) -> anyhow::Result<()>;
+    fn get_visual_selections(&self) -> anyhow::Result<Vec<EditorContext>>;
+}

package/src/constants.rs

@@ -0,0 +1,3 @@
+use std::time::Duration;
+
+pub const NEOVIM_RPC_TIMEOUT: Duration = Duration::from_secs(2);

package/src/handler.rs

@@ -0,0 +1,26 @@
+use crate::action::{BufferStatus, EditorContext, Action, neovim::NeovimAction};
+use crate::utils;
+
+pub fn connect() -> anyhow::Result<NeovimAction> {
+    let socket_paths = utils::find_matching_sockets()?;
+    if socket_paths.is_empty() {
+        anyhow::bail!("no Neovim instances found");
+    }
+    Ok(NeovimAction::new(socket_paths))
+}
+
+pub fn check_buffer(action: &NeovimAction, file_path: &str) -> anyhow::Result<BufferStatus> {
+    action.buffer_status(file_path)
+}
+
+pub fn refresh_buffer(action: &NeovimAction, file_path: &str) -> anyhow::Result<()> {
+    action.refresh_buffer(file_path)
+}
+
+pub fn get_visual_selections(action: &NeovimAction) -> anyhow::Result<Vec<EditorContext>> {
+    action.get_visual_selections()
+}
+
+pub fn send_message(action: &NeovimAction, message: &str) -> anyhow::Result<()> {
+    action.send_message(message)
+}

package/src/lib.rs

@@ -0,0 +1,88 @@
+pub mod action;
+pub mod constants;
+pub mod handler;
+pub mod utils;
+
+#[cfg(feature = "napi")]
+mod bindings {
+    use crate::action::neovim::NeovimAction;
+    use crate::action::EditorContext as InternalEditorContext;
+    use crate::handler;
+    use napi::bindgen_prelude::*;
+    use napi_derive::napi;
+
+    fn connect_nvim() -> Result<NeovimAction> {
+        handler::connect().map_err(|e| Error::from_reason(e.to_string()))
+    }
+
+    fn with_action<F, T>(f: F) -> Result<T>
+    where
+        F: FnOnce(&NeovimAction) -> anyhow::Result<T>,
+    {
+        let action = connect_nvim()?;
+        f(&action).map_err(|e| Error::from_reason(e.to_string()))
+    }
+
+    #[napi(object)]
+    #[derive(Clone)]
+    pub struct BufferStatus {
+        pub is_current: bool,
+        pub has_unsaved_changes: bool,
+    }
+
+    impl From<crate::action::BufferStatus> for BufferStatus {
+        fn from(s: crate::action::BufferStatus) -> Self {
+            Self {
+                is_current: s.is_current,
+                has_unsaved_changes: s.has_unsaved_changes,
+            }
+        }
+    }
+
+    #[napi(object)]
+    #[derive(Clone)]
+    pub struct EditorContext {
+        pub file_path: String,
+        pub start_line: u32,
+        pub end_line: u32,
+        pub cwd: String,
+        pub content: String,
+    }
+
+    impl From<InternalEditorContext> for EditorContext {
+        fn from(ctx: InternalEditorContext) -> Self {
+            Self {
+                file_path: ctx.file_path,
+                start_line: ctx.start_line,
+                end_line: ctx.end_line,
+                cwd: ctx.cwd,
+                content: ctx.content,
+            }
+        }
+    }
+
+    #[napi]
+    pub fn check_buffer(file_path: String) -> Result<BufferStatus> {
+        with_action(|action| {
+            handler::check_buffer(action, &file_path).map(BufferStatus::from)
+        })
+    }
+
+    #[napi]
+    pub fn refresh_buffer(file_path: String) -> Result<()> {
+        with_action(|action| handler::refresh_buffer(action, &file_path))
+    }
+
+    #[napi]
+    pub fn get_visual_selections() -> Result<Vec<EditorContext>> {
+        with_action(|action| {
+            handler::get_visual_selections(action)
+                .map(|v| v.into_iter().map(EditorContext::from).collect())
+        })
+    }
+
+    #[napi]
+    pub fn send_message(message: String) -> Result<()> {
+        with_action(|action| handler::send_message(action, &message))
+    }
+}

package/src/utils.rs

@@ -0,0 +1,11 @@
+use anyhow::Context;
+use std::path::PathBuf;
+
+pub fn find_matching_sockets() -> anyhow::Result<Vec<PathBuf>> {
+    let pattern = "/tmp/bridge-*.sock";
+    Ok(glob::glob(pattern)
+        .context("couldn't search for Neovim sockets")?
+        .filter_map(Result::ok)
+        .filter(|path| path.exists())
+        .collect())
+}