fix: actionable error when port is occupied by foreign service

BrainSlugs83 · Copilot · BrainSlugs83 · commit 7446920da719 · 2026-03-02T17:21:14.000-08:00
Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/index.js b/index.js
@@ -112,7 +112,11 @@ async function ensureServer() {
       return;
     }
   }
-  throw new Error("Vector memory server failed to start within 30s");
+  throw new Error(
+    `Vector memory server failed to start — port ${PORT} may be in use by another service. ` +
+    `Fix: set VECTOR_MEMORY_PORT to an unused port in ~/.copilot/mcp-config.json — ` +
+    `see https://github.com/BrainSlugs83/GithubCopilotCLI-VectorMemoryMCP#environment-variables`
+  );
 }
 
 // --- HTTP client helper ---

Original file line number	Diff line number	Diff line change
`@@ -112,7 +112,11 @@ async function ensureServer() {`
`112`	`112`	`return;`
`113`	`113`	`}`
`114`	`114`	`}`
`115`		`- throw new Error("Vector memory server failed to start within 30s");`
	`115`	`+ throw new Error(`
	`116`	+ `Vector memory server failed to start — port ${PORT} may be in use by another service. ` +
	`117`	+ `Fix: set VECTOR_MEMORY_PORT to an unused port in ~/.copilot/mcp-config.json — ` +
	`118`	+ `see https://github.com/BrainSlugs83/GithubCopilotCLI-VectorMemoryMCP#environment-variables`
	`119`	`+ );`
`116`	`120`	`}`
`117`	`121`
`118`	`122`	`// --- HTTP client helper ---`