@rama_nigg/open-cursor 2.3.1 → 2.3.2

package/README.md

@@ -31,9 +31,11 @@ The simplest approach—just add the npm package to your OpenCode config:
 }
 ```
 
+> **Note:** The model identifiers shown above are examples. Run `cursor-agent models` after authentication to see the full list of models available for your account.
+
 After authenticating with `cursor-agent login`, run `cursor-agent models` to see the full model list, or use one of the automated installers below to auto-discover models.
 
-**Prerequisites:** Only OpenCode required. OpenCode's Bun runtime resolves the npm package automatically.
+**Prerequisites:** OpenCode and cursor-agent required. Install cursor-agent with: `curl -fsSL https://cursor.com/install | bash && cursor-agent login`. OpenCode's Bun runtime resolves the npm package automatically.
 
 **Option B — One-line installer (curl)**
 
@@ -43,18 +45,22 @@ curl -fsSL https://raw.githubusercontent.com/Nomadcxx/opencode-cursor/main/insta
 
 This automated installer detects your environment and chooses the best installation method.
 
-**Option C — npm global install + CLI**
+**Option C — npm global install + CLI symlink**
+
+Installs globally via npm and creates a symlink in the OpenCode plugin directory:
 
 ```bash
 npm install -g @rama_nigg/open-cursor
 open-cursor install
 ```
 
+The `open-cursor install` command creates a symlink at `~/.config/opencode/plugin/cursor-acp.js` pointing to the npm package's entry file.
+
 Upgrade later with:
 
 ```bash
 npm update -g @rama_nigg/open-cursor
-open-cursor install
+# Symlink automatically uses updated files
 ```
 
 **Option D — Go TUI installer**
@@ -261,7 +267,7 @@ Detailed architecture: [docs/architecture/runtime-tool-loop.md](docs/architectur
 
 ## Prerequisites
 
-**For Option A (npm-direct):** Only [OpenCode](https://opencode.ai/) required.
+**For Option A (npm-direct):** [OpenCode](https://opencode.ai/) and [cursor-agent](https://cursor.com/) required. The npm package is resolved by OpenCode's Bun runtime, but cursor-agent handles the actual API communication.
 
 **For Options B-F:**
 - [Bun](https://bun.sh/)

package/dist/cli/opencode-cursor.js

@@ -236,9 +236,24 @@ function checkOpenCode() {
     };
   }
 }
-function checkPluginFile(pluginPath) {
+function isNpmDirectInstalled(config) {
+  if (!config || typeof config !== "object")
+    return false;
+  const plugins = config.plugin;
+  if (!Array.isArray(plugins))
+    return false;
+  return plugins.some((p) => typeof p === "string" && p.startsWith(NPM_PACKAGE_PREFIX));
+}
+function checkPluginFile(pluginPath, config) {
   try {
     if (!existsSync(pluginPath)) {
+      if (isNpmDirectInstalled(config)) {
+        return {
+          name: "Plugin file",
+          passed: true,
+          message: "Installed via npm package (no symlink needed)"
+        };
+      }
       return {
         name: "Plugin file",
         passed: false,
@@ -308,17 +323,24 @@ function checkAiSdk(opencodeDir) {
 }
 function runDoctorChecks(configPath, pluginPath) {
   const opencodeDir = dirname(configPath);
+  let config;
+  try {
+    config = readConfig(configPath);
+  } catch {
+    config = undefined;
+  }
   return [
     checkBun(),
     checkCursorAgent(),
     checkCursorAgentLogin(),
     checkOpenCode(),
-    checkPluginFile(pluginPath),
+    checkPluginFile(pluginPath, config),
     checkProviderConfig(configPath),
     checkAiSdk(opencodeDir)
   ];
 }
 var PROVIDER_ID = "cursor-acp";
+var NPM_PACKAGE_PREFIX = "@rama_nigg/open-cursor";
 var DEFAULT_BASE_URL = "http://127.0.0.1:32124/v1";
 function printHelp() {
   const binName = basename(process.argv[1] || "open-cursor");
@@ -527,13 +549,20 @@ function commandSyncModels(options) {
   console.log(`Models synced: ${models.length}`);
   console.log(`Config path: ${configPath}`);
 }
+var NPM_PACKAGE = "@rama_nigg/open-cursor";
 function commandUninstall(options) {
   const { configPath, pluginPath } = resolvePaths(options);
   rmSync(pluginPath, { force: true });
   if (existsSync(configPath)) {
     const config = readConfig(configPath);
     if (Array.isArray(config.plugin)) {
-      config.plugin = config.plugin.filter((name) => name !== PROVIDER_ID);
+      config.plugin = config.plugin.filter((name) => {
+        if (name === PROVIDER_ID)
+          return false;
+        if (typeof name === "string" && name.startsWith(NPM_PACKAGE))
+          return false;
+        return true;
+      });
     }
     if (config.provider && typeof config.provider === "object") {
       delete config.provider[PROVIDER_ID];
@@ -565,22 +594,32 @@ function getStatusResult(configPath, pluginPath) {
       pluginTarget = undefined;
     }
   }
+  let config;
   let providerEnabled = false;
   let baseUrl = "http://127.0.0.1:32124/v1";
   let modelCount = 0;
   if (existsSync(configPath)) {
-    const config = readConfig(configPath);
+    config = readConfig(configPath);
     const provider = config.provider?.["cursor-acp"];
     providerEnabled = !!provider;
     if (provider?.options?.baseURL) {
       baseUrl = provider.options.baseURL;
     }
     modelCount = Object.keys(provider?.models || {}).length;
+  } else {
+    config = undefined;
   }
   const opencodeDir = dirname(configPath);
   const sdkPath = join(opencodeDir, "node_modules", "@ai-sdk", "openai-compatible");
   const aiSdkInstalled = existsSync(sdkPath);
+  let installMethod = "none";
+  if (pluginType !== "missing") {
+    installMethod = "symlink";
+  } else if (isNpmDirectInstalled(config)) {
+    installMethod = "npm-direct";
+  }
   return {
+    installMethod,
     plugin: {
       path: pluginPath,
       type: pluginType,
@@ -615,6 +654,7 @@ function commandStatus(options) {
   } else {
     console.log(`  Type: missing`);
   }
+  console.log(`  Install method: ${result.installMethod}`);
   console.log("");
   console.log("Provider");
   console.log(`  Config: ${result.provider.configPath}`);