diff --git a/packages/cli/src/browser/manager.test.ts b/packages/cli/src/browser/manager.test.ts
index bc52014694e..04397cefe96 100644
--- a/packages/cli/src/browser/manager.test.ts
+++ b/packages/cli/src/browser/manager.test.ts
@@ -1623,6 +1623,7 @@ describe("downloadBrowser — install failure surfaces HYPERFRAMES_BROWSER_PATH
       expect(caught.message).toContain(rawMsg);
       expect(caught.message).toContain("HYPERFRAMES_BROWSER_PATH");
       expect(caught.message).toContain("No Chrome or Chromium was found on this machine");
+      expect(caught.message).toContain("hyperframes doctor");
       expect(caught.message).not.toContain('export HYPERFRAMES_BROWSER_PATH="');
       expect(caught.message).not.toContain("set HYPERFRAMES_BROWSER_PATH=");
       expect(caught.cause).toBe(originalError);
diff --git a/packages/cli/src/browser/manager.ts b/packages/cli/src/browser/manager.ts
index 8dcd87ff1df..bd7af0f00dd 100644
--- a/packages/cli/src/browser/manager.ts
+++ b/packages/cli/src/browser/manager.ts
@@ -721,7 +721,8 @@ function wrapDownloadFailureWithBrowserPathHint(
       `  export HYPERFRAMES_BROWSER_PATH="${installed}"\n\n` +
       `Run \`hyperframes doctor\` to see which Chrome was found. Then re-run your command. `
     : `No Chrome or Chromium was found on this machine. Install Google Chrome, then set ` +
-      `HYPERFRAMES_BROWSER_PATH to its executable and re-run your command. `;
+      `HYPERFRAMES_BROWSER_PATH to its executable. Run \`hyperframes doctor\` to see which ` +
+      `Chrome was found. Then re-run your command. `;
   const message =
     `Failed to install chrome-headless-shell ${managedChromeVersion()}: ${original}${unzipErrors}\n\n` +
     pointAt +