From 81fd4e5157c9615ca97afd5aac12b8123fa8b66b Mon Sep 17 00:00:00 2001
From: Wenzheng Jiang <jwzh.hi@gmail.com>
Date: Mon, 30 Mar 2026 09:17:17 +0900
Subject: [PATCH] feat(miyo): add remote vault folder path override for remote
 servers (#2334)

When using a Miyo remote server, the vault may be mounted at a
different path on the remote machine. This adds an optional
"Remote Vault Folder" setting that overrides the folder path sent
to Miyo when a custom server URL is configured.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/miyo/miyoUtils.ts                             | 15 ++++++++++++---
 src/search/findRelevantNotes.ts                   |  2 +-
 src/search/indexBackend/MiyoIndexBackend.ts       |  2 +-
 src/search/miyo/MiyoSemanticRetriever.ts          |  2 +-
 .../v2/components/CopilotPlusSettings.tsx         | 13 ++++++++++++-
 5 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/src/miyo/miyoUtils.ts b/src/miyo/miyoUtils.ts
index 4f6d13c0..be60491e 100644
--- a/src/miyo/miyoUtils.ts
+++ b/src/miyo/miyoUtils.ts
@@ -36,12 +36,21 @@ export function shouldUseMiyo(settings: CopilotSettings): boolean {
 }
 
 /**
- * Resolve the current vault folder path sent to Miyo as `folder_path`.
+ * Resolve the folder path sent to Miyo as `folder_path`.
+ *
+ * When a remote server URL is configured and the user has set a remote vault folder,
+ * that override is used — the remote machine's folder path may differ from the local
+ * vault path. Falls back to the local vault filesystem path, then vault name.
  *
  * @param app - Obsidian application instance.
- * @returns Current vault filesystem path when available, otherwise vault name.
+ * @param settings - Current Copilot settings.
+ * @returns Remote vault folder override when applicable, otherwise local vault path.
  */
-export function getMiyoFolderPath(app: App): string {
+export function getMiyoFolderPath(app: App, settings: CopilotSettings): string {
+  const remoteVaultFolder = (settings.miyoRemoteVaultPath || "").trim();
+  if (remoteVaultFolder && getMiyoCustomUrl(settings)) {
+    return remoteVaultFolder;
+  }
   const vaultPath = getVaultBasePath(app);
   if (vaultPath) {
     return vaultPath;
diff --git a/src/search/findRelevantNotes.ts b/src/search/findRelevantNotes.ts
index 8bac26ea..a2b43c30 100644
--- a/src/search/findRelevantNotes.ts
+++ b/src/search/findRelevantNotes.ts
@@ -129,7 +129,7 @@ async function calculateSimilarityScoreFromMiyo(filePath: string): Promise<Map<s
     const settings = getSettings();
     const miyoClient = new MiyoClient();
     const baseUrl = await miyoClient.resolveBaseUrl(getMiyoCustomUrl(settings));
-    const folderPath = getMiyoFolderPath(app);
+    const folderPath = getMiyoFolderPath(app, settings);
     const response = await miyoClient.searchRelated(baseUrl, getMiyoAbsolutePath(app, filePath), {
       folderPath,
       limit: MAX_K,
diff --git a/src/search/indexBackend/MiyoIndexBackend.ts b/src/search/indexBackend/MiyoIndexBackend.ts
index da636f58..33ed9bce 100644
--- a/src/search/indexBackend/MiyoIndexBackend.ts
+++ b/src/search/indexBackend/MiyoIndexBackend.ts
@@ -261,7 +261,7 @@ export class MiyoIndexBackend implements SemanticIndexBackend {
    * @returns Folder path string.
    */
   private getFolderPath(): string {
-    return getMiyoFolderPath(this.app);
+    return getMiyoFolderPath(this.app, getSettings());
   }
 
   /**
diff --git a/src/search/miyo/MiyoSemanticRetriever.ts b/src/search/miyo/MiyoSemanticRetriever.ts
index 2144ecec..91d2bfb6 100644
--- a/src/search/miyo/MiyoSemanticRetriever.ts
+++ b/src/search/miyo/MiyoSemanticRetriever.ts
@@ -91,7 +91,7 @@ export class MiyoSemanticRetriever extends BaseRetriever {
       }
       const response = await this.client.search(
         baseUrl,
-        getMiyoFolderPath(this.app),
+        getMiyoFolderPath(this.app, getSettings()),
         query,
         limit,
         filters
diff --git a/src/settings/v2/components/CopilotPlusSettings.tsx b/src/settings/v2/components/CopilotPlusSettings.tsx
index dc0dda38..c04fcea4 100644
--- a/src/settings/v2/components/CopilotPlusSettings.tsx
+++ b/src/settings/v2/components/CopilotPlusSettings.tsx
@@ -227,6 +227,17 @@ export const CopilotPlusSettings: React.FC = () => {
                     onChange={(value) => updateSetting("miyoServerUrl", value)}
                   />
 
+                  {(settings.miyoServerUrl || "").trim() && (
+                    <SettingItem
+                      type="text"
+                      title="Remote Vault Folder (Optional)"
+                      description="The folder path on the remote machine that Miyo should search. Leave blank to use the local vault path (only works if the remote vault is mounted at the same path)."
+                      value={settings.miyoRemoteVaultPath || ""}
+                      onChange={(value) => updateSetting("miyoRemoteVaultPath", value)}
+                      placeholder="e.g. /Users/you/Documents/vault"
+                    />
+                  )}
+
                   <SettingItem
                     type="switch"
                     title="Enable Miyo"
@@ -240,7 +251,7 @@ export const CopilotPlusSettings: React.FC = () => {
                     <div className="tw-text-xs tw-text-muted">
                       Folder path sent to Miyo:{" "}
                       <span className="tw-font-medium tw-text-normal">
-                        {getMiyoFolderPath(app)}
+                        {getMiyoFolderPath(app, settings)}
                       </span>
                     </div>
                   )}