diff --git a/packages/vscode/README.md b/packages/vscode/README.md
index b2884f9..64271ea 100644
--- a/packages/vscode/README.md
+++ b/packages/vscode/README.md
@@ -4,7 +4,7 @@ Utilities for viewing and editing the π-base data repository in VSCode.
 
 ## Publishing
 
-Run `pnpm publish` to publish. (`prepublish` handles bundling with `pnpm`, which is otherwise unsupported by `vsce`.)
+Run `pnpm run publish` to publish. (`prepublish` handles bundling with `pnpm`, which is otherwise unsupported by `vsce`.)
 
 <!--TODO
 ## Features
diff --git a/packages/vscode/package.json b/packages/vscode/package.json
index 99f7f33..e5bfe42 100644
--- a/packages/vscode/package.json
+++ b/packages/vscode/package.json
@@ -10,7 +10,7 @@
   "homepage": "https://topology.pi-base.org/",
   "license": "ISC",
   "author": "James Dabbs <james.dabbs@gmail.com> (https://jdabbs.com)",
-  "version": "0.0.13",
+  "version": "0.0.16",
   "repository": {
     "type": "git",
     "url": "https://github.com/pi-base/web.git"
diff --git a/packages/vscode/src/extension.ts b/packages/vscode/src/extension.ts
index c1f1317..b84e1bd 100644
--- a/packages/vscode/src/extension.ts
+++ b/packages/vscode/src/extension.ts
@@ -5,11 +5,17 @@ import { EntityIdHoverProvider } from './providers/EntityIdHoverProvider'
 import { EntityIdLinkProvider } from './providers/EntityIdLinkProvider'
 import { ExternalLinkProvider } from './providers/ExternalLinkProvider'
 import { setupDecorationProvider } from './providers/decorationProvider'
+import debug from 'debug'
 
 export function activate(context: vscode.ExtensionContext) {
   findRootFolder().then(uri => {
     if (uri) {
-      setup(context, uri)
+      try {
+        debug('Initializing π-base extension')
+        setup(context, uri)
+      } catch (error) {
+        console.error('Failed to initialize π-base extension', error)
+      }
     } else {
       console.log(
         'No data folder found in workspace. Skipping π-base initialization.',
diff --git a/packages/vscode/src/providers/EntityIdHoverProvider.ts b/packages/vscode/src/providers/EntityIdHoverProvider.ts
index 99239fb..eb4dce2 100644
--- a/packages/vscode/src/providers/EntityIdHoverProvider.ts
+++ b/packages/vscode/src/providers/EntityIdHoverProvider.ts
@@ -17,10 +17,21 @@ export class EntityIdHoverProvider
 
     const { uri, name, description } = entity
 
-    return new vscode.Hover(
-      new vscode.MarkdownString(
-        [`# [${name}](${uri})`, '', description].join('\n'),
-      ),
-    )
+    // Hover text only supports an allow list of schemes (https://github.com/microsoft/vscode/issues/153277), which
+    // doesn't include the `vscode-vfs` scheme used by github.dev, so we instead use a command link to open the file.
+    //
+    // See also
+    // - https://code.visualstudio.com/api/extension-guides/command
+    // - https://code.visualstudio.com/api/references/commands
+    const openCommand = `command:vscode.open?${encodeURIComponent(
+      JSON.stringify([uri]),
+    )}`
+    const nameLink = new vscode.MarkdownString(`# [${name}](${openCommand})`)
+    nameLink.isTrusted = true
+
+    return new vscode.Hover([
+      nameLink,
+      new vscode.MarkdownString(`\n\n${description}`),
+    ])
   }
 }