feat(vscode): add Reload Vault command to refresh files.exclude patterns

New dotfiles or directories added to the vault root outside VS Code are
not picked up until an unrelated config change triggers
syncFilesExclude.  "Obsidian VFS: Reload Vault" provides a manual
Command Palette trigger that re-scans the vault root, recomputes both
exclude tiers, and refreshes the Explorer tree view.

Assisted-by: Claude

Author: otaviof

packages/vscode/README.md

@@ -38,6 +38,7 @@ Available via the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`):
 | `Obsidian VFS: Copy Path` | Copy the active file's `obs://` URI to the clipboard (`Shift+Alt+Cmd+C` on `obs://` files) |
 | `Obsidian VFS: Move into Vault` | Move a file from the current project into a mounted vault folder (Explorer context menu, editor title, or Command Palette) |
 | `Obsidian VFS: Duplicate into Vault` | Duplicate a file from the current project into a mounted vault folder (Explorer context menu, editor title, or Command Palette) |
+| `Obsidian VFS: Reload Vault` | Re-scan the vault root and refresh `files.exclude` patterns and Explorer tree view |
 
 ## Settings
 
@@ -107,6 +108,7 @@ Non-autoMount vault content (`.obsidian/`, `.trash/`, and any directories not in
 
 - The extension scans the vault root and adds `files.exclude` patterns for entries not in `autoMount`. Patterns are split into two tiers: vault-global patterns (dotfiles and `blocked` paths) are written to `<vault>/.vscode/settings.json` — controlled by `vault.excludeDotfiles`, `vault.excludeDotfilePattern`, and `vault.excludeBlocked`; remaining non-autoMount directories and file extension globs are written to workspace settings — controlled by `workspace.excludeUnmountedFolders`, `workspace.excludeUnmountedFiles`, and `workspace.excludeUnmountedFilePattern`. All managed patterns are tracked internally for cleanup.
 - When `autoMount` entries or any `vault.*`/`workspace.*` toggle changes, patterns are re-synced automatically — stale patterns are removed and new ones added.
+- When new dotfiles or directories are added to the vault outside VS Code, run **Obsidian VFS: Reload Vault** to manually refresh patterns and the tree view.
 - When `obsidianVFS.workspace.enabled` is disabled, all managed patterns are removed and the workspace folder is deleted.
 - The vault's `.git` repository is automatically added to `git.ignoredRepositories` (user-level setting) when `vault.gitIgnore` is true and a workspace folder is active, preventing VS Code's Git extension from listing it in Source Control. The entry is removed when `vault.gitIgnore` is disabled or the workspace folder is removed.
 

packages/vscode/package.json

@@ -2,7 +2,7 @@
   "name": "obsidian-vfs",
   "displayName": "Obsidian VFS",
   "description": "Browse, search, and edit your Obsidian vault directly in VSCode via a virtual file system (obs://)",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "private": true,
   "publisher": "otaviof",
   "engines": {
@@ -63,6 +63,10 @@
       {
         "command": "obsidianVFS.duplicateIntoVault",
         "title": "Obsidian VFS: Duplicate into Vault"
+      },
+      {
+        "command": "obsidianVFS.reloadVault",
+        "title": "Obsidian VFS: Reload Vault"
       }
     ],
     "keybindings": [

packages/vscode/src/commands.test.ts

@@ -94,6 +94,12 @@ function invokeCommandWithUri(
   return { handler, tree, channel };
 }
 
+describe("COMMAND constant", () => {
+  it("defines reloadVault command identifier", () => {
+    expect(COMMAND.reloadVault).toBe("obsidianVFS.reloadVault");
+  });
+});
+
 describe("registerCommands", () => {
   beforeEach(() => {
     vi.clearAllMocks();

packages/vscode/src/extension.test.ts

@@ -83,7 +83,7 @@ import type { LocalIndexTracker } from "@obsidian-vfs/core";
 import { bootstrapFromConfig, readConfig } from "./bootstrap.js";
 import { registerCommands } from "./commands.js";
 import { activate, deactivate } from "./extension.js";
-import { CONFIG_KEY } from "./types.js";
+import { COMMAND, CONFIG_KEY } from "./types.js";
 import { SCHEME } from "./uri-adapter.js";
 import { FOLDER_NAME_PREFIX } from "./workspace-folder.js";
 import { ObsidianFileSystemProvider } from "./file-system-provider.js";
@@ -471,6 +471,47 @@ describe("activate", () => {
       { isCaseSensitive: true, isReadonly: false },
     );
   });
+
+  it("registers reloadVault command", async () => {
+    bootstrapOk();
+    mockReadConfig.mockReturnValueOnce(fakeExtensionConfig({ workspaceEnabled: false }));
+
+    const ctx = fakeContext();
+    await activate(ctx as never);
+
+    const reloadVaultCall = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((call) => call[0] === COMMAND.reloadVault);
+
+    expect(reloadVaultCall).toBeDefined();
+    expect(reloadVaultCall![1]).toBeTypeOf("function");
+  });
+
+  it("reloadVault command triggers tree refresh", async () => {
+    bootstrapOk();
+    mockReadConfig.mockReturnValueOnce(fakeExtensionConfig({ workspaceEnabled: false }));
+    mockHasWF.mockReturnValue(true);
+
+    const ctx = fakeContext();
+    await activate(ctx as never);
+
+    const treeProviderInstance = vi.mocked(VaultTreeDataProvider).mock.results[0].value as {
+      refresh: ReturnType<typeof vi.fn>;
+    };
+
+    treeProviderInstance.refresh.mockClear();
+
+    const reloadVaultCall = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((call) => call[0] === COMMAND.reloadVault);
+
+    expect(reloadVaultCall).toBeDefined();
+
+    const reloadHandler = reloadVaultCall![1] as () => void;
+    reloadHandler();
+
+    expect(treeProviderInstance.refresh).toHaveBeenCalled();
+  });
 });
 
 describe("migrateStrandedAutoMount", () => {

packages/vscode/src/extension.ts

@@ -5,7 +5,7 @@ import { parse as parseJsonc } from "jsonc-parser";
 import { VAULT_MODE } from "@obsidian-vfs/core";
 
 import { bootstrapFromConfig, readConfig } from "./bootstrap.js";
-import { CONFIG_KEY, CONFIG_PROP, CONFIG_SECTION } from "./types.js";
+import { COMMAND, CONFIG_KEY, CONFIG_PROP, CONFIG_SECTION } from "./types.js";
 import type { ExtensionConfig } from "./types.js";
 import { SCHEME } from "./uri-adapter.js";
 import { registerCommands } from "./commands.js";
@@ -425,6 +425,13 @@ export async function activate(context: vscode.ExtensionContext): Promise<void>
 
   await activateWorkspaceFolder(wsCtx, config);
 
+  context.subscriptions.push(
+    vscode.commands.registerCommand(COMMAND.reloadVault, () => {
+      scheduleSync(wsCtx, readConfig());
+      treeProvider.refresh();
+    }),
+  );
+
   context.subscriptions.push(
     vscode.workspace.onDidChangeConfiguration((e) =>
       handleConfigChange(e, wsCtx, treeProvider, statusBar, provider, providerReg),

packages/vscode/src/types.ts

@@ -52,6 +52,7 @@ export const COMMAND = {
   copyPath: `${CONFIG_SECTION}.copyPath`,
   moveIntoVault: `${CONFIG_SECTION}.moveIntoVault`,
   duplicateIntoVault: `${CONFIG_SECTION}.duplicateIntoVault`,
+  reloadVault: `${CONFIG_SECTION}.reloadVault`,
 } as const;
 
 import type { VaultMode } from "@obsidian-vfs/core";