feat(vscode): add "Copy Path" command for obs:// URIs

New `obsidianVFS.copyPath` command copies the active file's canonical
`obs://` URI to the clipboard. Keybinding (Shift+Alt+Cmd+C) overrides
the default "Copy Relative Path" for obs:// files.

Assisted-by: Claude

Author: otaviof

packages/vscode/README.md

@@ -15,6 +15,7 @@ Browse, search, and edit your [Obsidian](https://obsidian.md) vault directly in
 - **Wikilink navigation**, click `[[links]]` in Markdown to jump between notes (resolves to `file://` paths for seamless navigation in workspace folders)
 - **Search notes** via Quick Pick across all vault Markdown files
 - **Open in Obsidian**, jump to the current file in the Obsidian app
+- **Copy path** as `obs://` URI to the clipboard (`Shift+Alt+Cmd+C` on `obs://` files)
 - **Auto-mount** configured folders on startup
 - **Status bar** showing vault name and connection mode (`full` / `degraded`)
 - **Workspace folder**, vault browsable in Explorer with Quick Open (`Cmd+P`) and Search (`Ctrl+Shift+F`) support
@@ -30,6 +31,7 @@ Available via the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`):
 | `Obsidian VFS: Unmount Folder` | Remove a mounted vault folder from the tree view |
 | `Obsidian VFS: Open in Obsidian` | Open the active vault file in the Obsidian app (works from both `obs://` and `file://` documents) |
 | `Obsidian VFS: Search Notes` | Quick Pick search across all vault Markdown files |
+| `Obsidian VFS: Copy Path` | Copy the active file's `obs://` URI to the clipboard (`Shift+Alt+Cmd+C` on `obs://` files) |
 
 ## Settings
 

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.1.2",
+  "version": "0.1.3",
   "private": true,
   "publisher": "otaviof",
   "engines": {
@@ -47,6 +47,17 @@
       {
         "command": "obsidianVFS.searchNotes",
         "title": "Obsidian VFS: Search Notes"
+      },
+      {
+        "command": "obsidianVFS.copyPath",
+        "title": "Obsidian VFS: Copy Path"
+      }
+    ],
+    "keybindings": [
+      {
+        "command": "obsidianVFS.copyPath",
+        "key": "shift+alt+cmd+c",
+        "when": "resourceScheme == obs"
       }
     ],
     "views": {

packages/vscode/src/commands.test.ts

@@ -47,14 +47,14 @@ describe("registerCommands", () => {
     vi.clearAllMocks();
   });
 
-  it("registers four commands", () => {
+  it("registers five commands", () => {
     const ctx = fakeContext();
     const tracker = mockTracker();
     const tree = fakeTreeProvider();
     const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
     registerCommands(ctx as never, tracker, tree as never, channel);
 
-    expect(vscode.commands.registerCommand).toHaveBeenCalledTimes(4);
+    expect(vscode.commands.registerCommand).toHaveBeenCalledTimes(5);
     expect(vscode.commands.registerCommand).toHaveBeenCalledWith(
       "obsidianVFS.mount",
       expect.any(Function),
@@ -71,6 +71,10 @@ describe("registerCommands", () => {
       "obsidianVFS.searchNotes",
       expect.any(Function),
     );
+    expect(vscode.commands.registerCommand).toHaveBeenCalledWith(
+      "obsidianVFS.copyPath",
+      expect.any(Function),
+    );
   });
 });
 
@@ -595,3 +599,88 @@ describe("searchNotes command", () => {
     expect(vscode.window.showQuickPick).not.toHaveBeenCalled();
   });
 });
+
+describe("copyPath command", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("copies obs:// URI when active editor has obs:// scheme", async () => {
+    const tracker = mockTracker();
+
+    Object.defineProperty(vscode.window, "activeTextEditor", {
+      value: { document: { uri: { scheme: SCHEME, path: "/notes/todo.md" } } },
+      writable: true,
+      configurable: true,
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.copyPath")![1] as () => Promise<void>;
+    await handler();
+
+    // eslint-disable-next-line @typescript-eslint/unbound-method
+    expect(vscode.env.clipboard.writeText).toHaveBeenCalledWith("obs://TestVault/notes/todo.md");
+
+    Object.defineProperty(vscode.window, "activeTextEditor", {
+      value: undefined,
+      writable: true,
+      configurable: true,
+    });
+  });
+
+  it("copies obs:// URI when active editor has file:// scheme under vault", async () => {
+    const tracker = mockTracker();
+
+    Object.defineProperty(vscode.window, "activeTextEditor", {
+      value: { document: { uri: { scheme: "file", fsPath: "/vault/notes/todo.md" } } },
+      writable: true,
+      configurable: true,
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.copyPath")![1] as () => Promise<void>;
+    await handler();
+
+    // eslint-disable-next-line @typescript-eslint/unbound-method
+    expect(vscode.env.clipboard.writeText).toHaveBeenCalledWith("obs://TestVault/notes/todo.md");
+
+    Object.defineProperty(vscode.window, "activeTextEditor", {
+      value: undefined,
+      writable: true,
+      configurable: true,
+    });
+  });
+
+  it("shows info message when no vault file is active", async () => {
+    Object.defineProperty(vscode.window, "activeTextEditor", {
+      value: undefined,
+      writable: true,
+      configurable: true,
+    });
+
+    const tracker = mockTracker();
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.copyPath")![1] as () => Promise<void>;
+    await handler();
+
+    expect(vscode.window.showInformationMessage).toHaveBeenCalledWith("No Obsidian VFS file active");
+  });
+});

packages/vscode/src/commands.ts

@@ -1,5 +1,6 @@
 import * as vscode from "vscode";
 import type { LocalIndexTracker } from "@obsidian-vfs/core";
+import { buildObsUri } from "@obsidian-vfs/core";
 
 import { SCHEME, toFileUri, toVaultPath, toVaultPathFromFile } from "./uri-adapter.js";
 import type { VaultTreeDataProvider } from "./vault-tree-provider.js";
@@ -76,6 +77,27 @@ async function openInObsidianCommand(
   }
 }
 
+/** Copy the active file's `obs://` URI to the clipboard. */
+async function copyPathCommand(tracker: LocalIndexTracker): Promise<void> {
+  const editor = vscode.window.activeTextEditor;
+  if (editor?.document.uri.scheme !== SCHEME && editor?.document.uri.scheme !== "file") {
+    await vscode.window.showInformationMessage("No Obsidian VFS file active");
+    return;
+  }
+
+  const vaultPath =
+    editor.document.uri.scheme === SCHEME
+      ? toVaultPath(editor.document.uri)
+      : toVaultPathFromFile(editor.document.uri, tracker.context.physicalPath);
+
+  const obsUri = buildObsUri({
+    vaultName: tracker.context.name,
+    path: vaultPath,
+    section: undefined,
+  });
+  await vscode.env.clipboard.writeText(obsUri);
+}
+
 /** Search vault notes via Quick Pick and open the selected file. */
 async function searchNotesCommand(tracker: LocalIndexTracker): Promise<void> {
   const result = await tracker.listFiles();
@@ -111,5 +133,6 @@ export function registerCommands(
       openInObsidianCommand(tracker, outputChannel),
     ),
     vscode.commands.registerCommand("obsidianVFS.searchNotes", () => searchNotesCommand(tracker)),
+    vscode.commands.registerCommand("obsidianVFS.copyPath", () => copyPathCommand(tracker)),
   );
 }

packages/vscode/src/test-mocks.ts

@@ -96,6 +96,7 @@ export function createVscodeMock(
     mock.Uri = createMockUri();
   }
   if (parts.window) {
+    mock.env = { clipboard: { writeText: vi.fn() } };
     const outputChannel = { appendLine: vi.fn(), dispose: vi.fn() };
     mock.window = {
       createOutputChannel: vi.fn(() => outputChannel),