pi-repoprompt-mcp 0.1.0 → 0.2.0

package/README.md

@@ -37,6 +37,7 @@ Add to `~/.pi/agent/settings.json` (or replace an existing unfiltered `git:githu
 
 - RepoPrompt installed
 - RepoPrompt MCP server reachable (stdio transport)
+  - If the server is not configured/auto-detected, the package will still load, but `rp(...)` will error until you configure it
 - `rp-cli` on `PATH` is recommended (used as a fallback for window discovery)
 
 ## Usage
@@ -67,4 +68,15 @@ Create `~/.pi/agent/extensions/repoprompt-mcp.json`:
 }
 ```
 
+If the MCP server is not auto-detected, set `command` explicitly:
+
+```json
+{
+  "command": "/Applications/Repo Prompt.app/Contents/MacOS/repoprompt-mcp",
+  "args": []
+}
+```
+
+(Alternatively, configure RepoPrompt in `~/.pi/agent/mcp.json`)
+
 For more detail, see: `extensions/repoprompt-mcp/README.md` in the dot314 repo.

package/extensions/repoprompt-mcp/src/config.ts

@@ -222,9 +222,13 @@ function maybeWrapServerCommand(
 }
 
 /**
- * Get the server command and args, or throw if not found
+ * Get the server command and args, or return null if not found
+ *
+ * We avoid throwing on startup because a missing server is a common first-run condition
+ * (users may not have installed RepoPrompt / rp-mcp-server yet). Instead we surface this
+ * as a non-fatal warning and only error when a user actually tries to use rp features
  */
-export function getServerCommand(config: RpConfig): { command: string; args: string[] } {
+export function getServerCommand(config: RpConfig): { command: string; args: string[] } | null {
   if (config.command) {
     return maybeWrapServerCommand(config, {
       command: config.command,
@@ -232,8 +236,5 @@ export function getServerCommand(config: RpConfig): { command: string; args: str
     });
   }
 
-  throw new Error(
-    "RepoPrompt MCP server not found. Please ensure rp-mcp-server is installed, " +
-    "or add RepoPrompt to your ~/.pi/agent/mcp.json"
-  );
+  return null;
 }

package/extensions/repoprompt-mcp/src/index.ts

@@ -250,13 +250,13 @@ Mode priority: call > describe > search > windows > bind > status`,
     
     parameters: RpToolSchema,
     
-    async execute(_toolCallId, params: RpToolParams, onUpdate, _ctx, _signal) {
+    async execute(_toolCallId, params: RpToolParams, _signal, onUpdate, _ctx) {
       // Provide a no-op if onUpdate is undefined
       const safeOnUpdate = onUpdate ?? (() => {});
 
       // Only modes that need MCP require a connection
       if (params.call || params.describe || params.search || params.windows || params.bind) {
-        await ensureConnected();
+        await ensureConnected(_ctx as ExtensionContext | undefined);
       }
 
       // Mode resolution: call > describe > search > windows > bind > status
@@ -374,15 +374,28 @@ Mode priority: call > describe > search > windows > bind > status`,
   // Helper Functions
   // ───────────────────────────────────────────────────────────────────────────
   
-  async function ensureConnected(): Promise<void> {
+  async function ensureConnected(ctx?: ExtensionContext): Promise<void> {
     if (initPromise) {
       await initPromise;
     }
-    
+
     const client = getRpClient();
-    if (!client.isConnected) {
-      throw new Error("Not connected to RepoPrompt. Run /rp reconnect");
+    if (client.isConnected) {
+      return;
     }
+
+    // Lazy reconnect: allow the user to install/configure RepoPrompt after Pi starts
+    // and have `rp(...)` work without requiring a restart.
+    config = loadConfig();
+
+    const server = getServerCommand(config);
+    if (!server) {
+      throw new Error(
+        "RepoPrompt MCP server not found. Install RepoPrompt / rp-mcp-server, or configure ~/.pi/agent/extensions/repoprompt-mcp.json (or ~/.pi/agent/mcp.json)"
+      );
+    }
+
+    await client.connect(server.command, server.args, config.env);
   }
 
   function parseNumber(value: unknown): number | undefined {
@@ -545,11 +558,17 @@ Mode priority: call > describe > search > windows > bind > status`,
     const client = getRpClient();
     const binding = getBinding();
     
+    const server = getServerCommand(config);
+
     let text = `RepoPrompt: ${client.status}\n`;
     if (client.error) {
       text += `Error: ${client.error}\n`;
     }
     text += `Tools: ${client.tools.length}\n`;
+    if (!server) {
+      text += `Server: (not configured / not auto-detected)\n`;
+      text += `Hint: configure ~/.pi/agent/extensions/repoprompt-mcp.json or ~/.pi/agent/mcp.json\n`;
+    }
     
     if (binding) {
       text += `\nBound to window ${binding.windowId}`;
@@ -872,11 +891,20 @@ async function initializeExtension(
   
   // Get server command
   const server = getServerCommand(config);
-  
+  if (!server) {
+    if (ctx.hasUI) {
+      ctx.ui.notify(
+        "RepoPrompt MCP server not found. Install RepoPrompt / rp-mcp-server, or configure ~/.pi/agent/extensions/repoprompt-mcp.json (or ~/.pi/agent/mcp.json)",
+        "warning"
+      );
+    }
+    return;
+  }
+
   // Connect to RepoPrompt
   const client = getRpClient();
   await client.connect(server.command, server.args, config.env);
-  
+
   // Notify connection
   if (ctx.hasUI) {
     ctx.ui.notify(`RepoPrompt: connected (${client.tools.length} tools)`, "info");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-repoprompt-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A token-efficient RepoPrompt MCP integration for Pi",
   "keywords": ["pi-package", "pi", "pi-coding-agent", "repoprompt", "mcp"],
   "license": "MIT",
@@ -22,7 +22,7 @@
     "diff": "^7.0.0"
   },
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-coding-agent": ">=0.51.0",
     "@mariozechner/pi-tui": "*",
     "@sinclair/typebox": "*"
   },