feat(vscode): add excludeFilePattern setting for file-level exclusion

Hide Obsidian files (.md, .base, .canvas) at partially-mounted vault
levels via regex-driven files.exclude glob patterns scoped to the vault
folder. Files matching the configurable excludeFilePattern regex are
grouped by extension into {prefix}/*{ext} globs, keeping Explorer and
Quick Open clean without affecting same-named files in other workspace
folders. Non-matching files remain visible. Invalid regex degrades
gracefully to no file exclusion.

Assisted-by: Claude

Author: otaviof

AGENTS.md

@@ -33,6 +33,7 @@ Style, file layout, patterns: [CONTRIBUTING.md#conventions](CONTRIBUTING.md#conv
 - **Single `file://` workspace folder at the vault root** for Quick Open (`Cmd+P`) and `Ctrl+Shift+F` search. VSCode's file discovery and ripgrep indexer only operate on `file://` workspace folders — `obs://` workspace folders provide zero discoverability (confirmed by spike, 2026-05-15).
 - **`files.exclude` patterns** hide non-autoMount vault content to match the Explorer tree view's visibility. Two-tier split: dotfiles + `blocked` → `ConfigurationTarget.WorkspaceFolder` (`<vault>/.vscode/settings.json`); non-autoMount dirs → `ConfigurationTarget.Workspace`. Tracked in `context.workspaceState`, cleaned up on change or disable.
 - **Sub-path exclusion** — when `autoMount` contains nested paths (e.g., `["20-areas/idea"]`), `files.exclude` patterns hide sibling directories (`20-areas/career`, `20-areas/otaviof`) to match tree view visibility. Computed via mount tree (`packages/core/src/mount-tree.ts`).
+- **File-level exclusion** — `obsidianVFS.excludeFilePattern` provides a regex tested against file basenames at partially-mounted levels. Matching files generate `{prefix}/*{ext}` glob patterns in the folder-scoped `files.exclude` tier, hiding Obsidian files (`.md`, `.base`, `.canvas`) from Explorer and Quick Open without affecting same-named files in other workspace folders. Default: `\\.(md|base|canvas)$`.
 - **`obs://` FileSystemProvider** remains registered for the Explorer tree view sidebar, wikilinks, drag-and-drop, and watch events — it does not back a workspace folder.
 - **`FileSearchProvider`/`TextSearchProvider` are proposed (unstable) APIs** as of `@types/vscode@1.118.0`. When stabilized, the extension can switch to a single `obs://` workspace folder with native search, eliminating the `files.exclude` workaround. Check `@types/vscode` for stable availability — do not use while proposed.
 

packages/vscode/README.md

@@ -49,6 +49,7 @@ Configure via **Settings UI** or `settings.json`:
 | `obsidianVFS.explorer` | `boolean` | `true` | Show the Obsidian VFS tree view in the Explorer sidebar |
 | `obsidianVFS.statusBar` | `boolean` | `true` | Show vault name and mode in the status bar |
 | `obsidianVFS.workspace` | `boolean` | `true` | Add the vault as a workspace folder for Quick Open and Search (see below) |
+| `obsidianVFS.excludeFilePattern` | `string` | `\.(md\|base\|canvas)$` | Regex pattern tested against file basenames at partially-mounted vault levels. Matching files are hidden from Explorer via `files.exclude` glob patterns scoped to the vault folder. Covers Obsidian's three core formats by default. Set to empty string to disable. Examples: `\.(md\|base\|canvas\|pdf)$`, `^README`. |
 | `obsidianVFS.workspaceFile` | `boolean` | `false` | Generate a `.code-workspace` file named after the project folder. Eliminates the "Untitled (Workspace)" label. The file contains a `file://` vault folder entry; `files.exclude` patterns are written to its `settings` section. Opening the file triggers a one-time window reload. |
 
 All three toggle settings (`explorer`, `statusBar`, `workspace`) take effect immediately — no reload required.

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": "0.3.4",
+  "version": "0.3.5",
   "private": true,
   "publisher": "otaviof",
   "engines": {
@@ -131,6 +131,11 @@
           "default": true,
           "description": "Show vault name and mode in the status bar"
         },
+        "obsidianVFS.excludeFilePattern": {
+          "type": "string",
+          "default": "\\.(md|base|canvas)$",
+          "markdownDescription": "Regex pattern tested against file basenames (not including parent directories) at partially-mounted vault levels. Matching files are hidden from Explorer via `files.exclude` glob patterns scoped to the vault folder. Set to empty string to disable. Examples: `\\.(md|base|canvas|pdf)$` (with attachments), `\\.base$` (single extension), `^README` (by name prefix)."
+        },
         "obsidianVFS.workspace": {
           "type": "boolean",
           "default": true,

packages/vscode/src/bootstrap.ts

@@ -2,7 +2,7 @@ import * as vscode from "vscode";
 import { DEFAULT_TIMEOUT_MS, bootstrapTracker, resolveCliPath } from "@obsidian-vfs/core";
 import type { BootstrapResult, VFSResult } from "@obsidian-vfs/core";
 
-import { CONFIG_SECTION } from "./types.js";
+import { CONFIG_SECTION, DEFAULT_EXCLUDE_FILE_PATTERN } from "./types.js";
 import type { ExtensionConfig } from "./types.js";
 
 /** Read extension configuration from VSCode settings. */
@@ -12,6 +12,7 @@ export function readConfig(): ExtensionConfig {
     cliPath: resolveCliPath({ userPath: cfg.get<string>("cliPath", "") }),
     timeoutMs: cfg.get<number>("timeoutMs", DEFAULT_TIMEOUT_MS),
     autoMount: cfg.get<string[]>("autoMount", []),
+    excludeFilePattern: cfg.get<string>("excludeFilePattern", DEFAULT_EXCLUDE_FILE_PATTERN),
     explorer: cfg.get<boolean>("explorer", true),
     statusBar: cfg.get<boolean>("statusBar", true),
     workspace: cfg.get<boolean>("workspace", true),