feat(memory): Graphnosis provider UI, MCP install, and onboarding

src/main/installer.ts

@@ -1385,6 +1385,10 @@ export function discoverMemoryProviders(
       description: "memory.providers.byterover",
       envVars: ["BRV_API_KEY"],
     },
+    graphnosis: {
+      description: "memory.providers.graphnosis",
+      envVars: [],
+    },
   };
 
   const results: MemoryProviderInfo[] = [];

src/main/ssh-remote.ts

@@ -3368,6 +3368,7 @@ known = {
     "holographic": {"description": "memory.providers.holographic", "envVars": []},
     "openviking": {"description": "memory.providers.openviking", "envVars": ["OPENVIKING_ENDPOINT", "OPENVIKING_API_KEY"]},
     "byterover": {"description": "memory.providers.byterover", "envVars": ["BRV_API_KEY"]},
+    "graphnosis": {"description": "memory.providers.graphnosis", "envVars": []},
 }
 roots = [
     os.path.expanduser("~/.hermes/plugins/memory"),

src/renderer/src/assets/main.css

@@ -1157,6 +1157,43 @@ body:has(.shell-vibrant),
   margin-top: 32px;
 }
 
+/* ---- Graphnosis pairing card ---- */
+.onboard-graphnosis {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 14px;
+  width: 100%;
+  max-width: 420px;
+  margin-top: 34px;
+  padding: 18px 20px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 16px;
+  background: rgba(255, 255, 255, 0.04);
+  -webkit-backdrop-filter: blur(6px);
+  backdrop-filter: blur(6px);
+  text-align: left;
+}
+
+.onboard-graphnosis-title {
+  font-size: 15px;
+  font-weight: 600;
+  color: #c3c8d8;
+}
+
+.onboard-graphnosis-body {
+  margin: 6px 0 0;
+  font-size: 13px;
+  line-height: 1.6;
+  color: #8b91a5;
+  text-wrap: pretty;
+}
+
+.onboard-graphnosis .onboard-btn-glass {
+  padding: 10px 20px;
+  font-size: 14px;
+}
+
 /* ---- Field + info card (Install / Setup) ---- */
 .onboard-field-label {
   align-self: flex-start;
@@ -3373,7 +3410,8 @@ body:has(.shell-vibrant),
   align-items: center;
   gap: 10px;
   padding: 14px 16px;
-  border-bottom: 1px solid color-mix(in srgb, var(--text-primary) 7%, transparent);
+  border-bottom: 1px solid
+    color-mix(in srgb, var(--text-primary) 7%, transparent);
 }
 .profile-switch-search-icon {
   flex-shrink: 0;
@@ -14966,6 +15004,25 @@ body:has(.shell-vibrant),
   border-radius: var(--radius-md);
 }
 
+.tools-graphnosis-promo {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 16px;
+  padding: 14px 16px;
+  border: 1px solid var(--border-subtle);
+  border-radius: 12px;
+  background: var(--surface-elevated, rgba(255, 255, 255, 0.03));
+}
+
+.tools-graphnosis-promo-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
 .tools-mcp-card {
   cursor: default;
 }

src/renderer/src/screens/Memory/MemoryProviders.tsx

@@ -10,6 +10,7 @@ const PROVIDER_URLS: Record<string, string> = {
   retaindb: "https://retaindb.com",
   supermemory: "https://supermemory.ai",
   byterover: "https://app.byterover.dev",
+  graphnosis: "https://graphnosis.com/download",
 };
 
 interface MemoryProvidersProps {

src/renderer/src/screens/Tools/Tools.tsx

@@ -594,6 +594,36 @@ function Tools({
       })
     : mcpServers;
 
+  const graphnosisMcpInstalled = mcpServers.some((s) => s.name === "graphnosis");
+
+  async function handleInstallGraphnosisMcp(): Promise<void> {
+    setMcpError("");
+    setMcpMessage("");
+    setMcpBusy("install:graphnosis");
+    try {
+      const result = await window.hermesAPI.addMcpServer(
+        {
+          name: "graphnosis",
+          type: "stdio",
+          command: "npx",
+          args: ["-y", "@graphnosis/mcp-relay", "${HOME}/.graphnosis/mcp.sock"],
+          env: {},
+        },
+        profile,
+      );
+      if (!result.success) {
+        setMcpError(result.error || t("tools.mcpInstallFailed"));
+        return;
+      }
+      setMcpMessage(t("tools.mcpInstalled"));
+      await reloadMcp();
+    } catch (err) {
+      setMcpError((err as Error).message || t("tools.mcpInstallFailed"));
+    } finally {
+      setMcpBusy("");
+    }
+  }
+
   if (loading) {
     return (
       <div className="tools-container">
@@ -736,6 +766,43 @@ function Tools({
               {mcpError && <div className="tools-error">{mcpError}</div>}
               {mcpMessage && <div className="tools-success">{mcpMessage}</div>}
 
+              {!graphnosisMcpInstalled && (
+                <div className="tools-graphnosis-promo">
+                  <div>
+                    <div className="tools-card-label">
+                      {t("tools.graphnosisMcpTitle")}
+                    </div>
+                    <div className="tools-card-description">
+                      {t("tools.graphnosisMcpDescription")}
+                    </div>
+                  </div>
+                  <div className="tools-graphnosis-promo-actions">
+                    <button
+                      type="button"
+                      className="btn btn-primary btn-sm"
+                      disabled={mcpBusy === "install:graphnosis"}
+                      onClick={() => void handleInstallGraphnosisMcp()}
+                    >
+                      <TinyIcon kind="install" />
+                      {mcpBusy === "install:graphnosis"
+                        ? t("tools.mcpInstallWorking")
+                        : t("tools.graphnosisMcpInstall")}
+                    </button>
+                    <button
+                      type="button"
+                      className="btn btn-secondary btn-sm"
+                      onClick={() =>
+                        void window.hermesAPI.openExternal(
+                          "https://graphnosis.com/download",
+                        )
+                      }
+                    >
+                      {t("tools.graphnosisMcpDownload")}
+                    </button>
+                  </div>
+                </div>
+              )}
+
               {mcpServers.length === 0 ? (
                 <div className="tools-empty">
                   <div className="tools-card-icon">

src/renderer/src/screens/Welcome/Welcome.tsx

@@ -411,6 +411,28 @@ function Welcome({
         <p className="onboard-note">{t("welcome.installSizeHint")}</p>
       </div>
 
+      <div className="onboard-graphnosis">
+        <div>
+          <div className="onboard-graphnosis-title">
+            {t("welcome.graphnosisTitle")}
+          </div>
+          <p className="onboard-graphnosis-body">
+            {t("welcome.graphnosisBody")}
+          </p>
+        </div>
+        <button
+          type="button"
+          className="onboard-btn onboard-btn-glass"
+          onClick={() =>
+            void window.hermesAPI.openExternal(
+              "https://graphnosis.com/download",
+            )
+          }
+        >
+          <span>{t("welcome.graphnosisDownload")}</span>
+        </button>
+      </div>
+
       <div className="onboard-divider">
         <span>{t("welcome.dividerOr")}</span>
       </div>

src/shared/i18n/locales/en/memory.ts

@@ -58,5 +58,7 @@ export default {
     openviking:
       "Session-managed memory with tiered retrieval and knowledge browsing",
     byterover: "Persistent knowledge tree with tiered retrieval via brv CLI",
+    graphnosis:
+      "Local encrypted engram graph — auto-prefetch, recall, remember. Requires Graphnosis app (no API key)",
   },
 } as const;

src/shared/i18n/locales/en/tools.ts

@@ -141,5 +141,11 @@ export default {
   mcpCatalogLoadFailed: "Failed to load MCP catalog.",
   mcpCatalogEmpty: "No catalog entries available.",
   mcpInstall: "Install",
+  mcpInstallWorking: "Installing…",
   mcpInstalledStatus: "Installed",
+  graphnosisMcpTitle: "Graphnosis memory (recommended)",
+  graphnosisMcpDescription:
+    "Install the Graphnosis MCP server for recall, remember, edit, and cross-engram search. Requires the Graphnosis app running with cortex unlocked.",
+  graphnosisMcpInstall: "Install Graphnosis MCP",
+  graphnosisMcpDownload: "Get Graphnosis app",
 } as const;

src/shared/i18n/locales/en/welcome.ts

@@ -21,4 +21,8 @@ export default {
   connect: "Connect",
   remoteHint:
     "Leave the key empty if the server accepts unauthenticated requests (e.g. via SSH tunnel to localhost).",
+  graphnosisTitle: "Pair with Graphnosis",
+  graphnosisBody:
+    "Add local encrypted memory to Hermes — auto-prefetch, recall, and MCP tools. Install Graphnosis, unlock your cortex, then enable the Graphnosis memory provider and MCP catalog in Settings.",
+  graphnosisDownload: "Download Graphnosis",
 } as const;