@postman/postman-plugin 0.2.1-rc.0 → 0.2.1-rc.1

package/dist/hosts/cursor.js

@@ -1,12 +1,20 @@
 import path from 'node:path';
 import { guard, removeClone, syncClone } from './shared.js';
 import { result } from './types.js';
-// Cursor has no command to install a plugin, but loads any plugin folder under
-// plugins/local. Its Marketplace keeps its own copy under plugins/cache.
-const localClone = (system) => path.join(system.home, '.cursor', 'plugins', 'local', 'postman'), marketplaceCopy = (system) => path.join(system.home, '.cursor', 'plugins', 'cache', 'cursor-public', 'postman'), NEXT = 'Reload the Cursor window (Developer: Reload Window), or start a new Cursor CLI session, for the change to take effect.', 
+// Cursor has no command to install a plugin, but its editor loads any plugin folder under
+// plugins/local; its CLI doesn't. Its Marketplace keeps its own copy under plugins/cache.
+const localClone = (system) => path.join(system.home, '.cursor', 'plugins', 'local', 'postman'), marketplaceCopy = (system) => path.join(system.home, '.cursor', 'plugins', 'cache', 'cursor-public', 'postman'), NEXT = 'Reload the Cursor window (Developer: Reload Window) for the change to take effect.', cliOffPath = (system) => path.join(system.home, '.local', 'bin', 'cursor-agent'), 
 // Cursor keeps a disabled Marketplace copy on disk and records "enabled" only in its
 // private state database, so the copy being there doesn't mean Postman is active.
 CHECK_ENABLED = 'If Postman isn\'t active in Cursor, enable it in Cursor Settings > Plugins.', MAYBE_TWICE = 'The Cursor Marketplace copy is present too; if it\'s enabled, Postman loads twice, so disable one in Cursor Settings > Plugins.';
+// Until https://github.com/postmanlabs/postman-plugin/issues/82 is fixed. Names the CLI by its path when
+// it isn't on PATH, which detect() accepts.
+async function cliNext(system) {
+    const cli = (await system.which('cursor-agent')) === null && await system.exists(cliOffPath(system)) ?
+        `"${cliOffPath(system)}"` :
+        'cursor-agent';
+    return `The Cursor CLI doesn't load plugins from there; start it with \`${cli} --plugin-dir "${localClone(system)}"\`.`;
+}
 export const cursor = {
     id: 'cursor',
     name: 'Cursor',
@@ -16,7 +24,7 @@ export const cursor = {
         // ~/.local/bin on the PATH of the shell that ran it. It also installs `agent`, a name
         // too generic to mean Cursor.
         return (await system.which('cursor')) !== null || (await system.which('cursor-agent')) !== null ||
-            await system.exists(path.join(system.home, '.local', 'bin', 'cursor-agent')) ||
+            await system.exists(cliOffPath(system)) ||
             (system.platform === 'darwin' && await system.exists('/Applications/Cursor.app')) ||
             await system.exists(path.join(system.home, '.cursor'));
     },
@@ -43,7 +51,8 @@ export const cursor = {
             // An existing clone is kept even next to the Marketplace copy, which may be
             // disabled: a duplicate is visible and fixable, deleting the working copy is not.
             const action = await syncClone(system, localClone(system));
-            return result('done', `${action} ${localClone(system)}`, fromMarketplace ? `${NEXT} ${MAYBE_TWICE}` : NEXT);
+            const next = `${NEXT} ${await cliNext(system)}`;
+            return result('done', `${action} ${localClone(system)}`, fromMarketplace ? `${next} ${MAYBE_TWICE}` : next);
         });
     },
     remove(system) {

package/mcp.pi.json

@@ -6,8 +6,8 @@
       "description": "Postman workspaces, collections, specs, environments, mocks and monitors",
       "headers": {
         "X-Source": "postman-pi-plugin",
-        "X-Plugin-Version": "0.2.1-rc.0",
-        "User-Agent": "postman-pi-plugin/0.2.1-rc.0"
+        "X-Plugin-Version": "0.2.1-rc.1",
+        "User-Agent": "postman-pi-plugin/0.2.1-rc.1"
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman/postman-plugin",
-  "version": "0.2.1-rc.0",
+  "version": "0.2.1-rc.1",
   "description": "Postman's API engineering skills for coding agents: a Pi package, and an npx installer that sets up Claude Code, Codex, Cursor, Kimi Code, Factory Droid, OpenCode and Pi.",
   "type": "module",
   "license": "Apache-2.0",