Graphnosis

Indexed, local, encrypted job memory for your Obsidian vault, powered by Graphnosis.

• Recall — semantic search across your entire cortex from the command palette; click any result to insert it at the cursor
• Remember — save the current note to your encrypted cortex with a single command
• Vault sync — automatically push modified .md files to memory on save
• Catch-up sync — on every launch, the plugin picks up notes edited outside Obsidian (Terminal, Cursor, cloud sync) and pushes them without any action from you
• Engram routing — direct vault notes into a specific memory graph (engram) to keep topics cleanly separated
• Token-budget control — tune recall depth per query from 100 to 8,000 tokens in Settings
• Insert at cursor — recall results drop straight into your note at the cursor
• Status bar — live cortex vitality score so you always know the bridge is up
• Local-only — talks to the Graphnosis sidecar on localhost; AES-256-GCM encryption at rest; nothing leaves your machine

Prerequisites

1. Graphnosis desktop app — download here. The app must be running and your cortex unlocked.
2. Bearer token — open Graphnosis → Settings → VS Code tab and copy the token shown there. (The same token works for Obsidian — it's a local-only bridge.)

Installation

Via BRAT (pre-release / beta)

1. Install the BRAT plugin from Obsidian's community plugin list.
2. Open BRAT settings → Add Beta Plugin → paste nehloo/graphnosis-obsidian-plugin.
3. Enable Graphnosis in Settings → Community plugins.

Via Obsidian Marketplace (once listed)

Search "Graphnosis" in Settings → Community plugins → Browse, then install and enable.

Configuration

Open Settings → Graphnosis:

Use Test connection to confirm the bridge is reachable after pasting the token.

[!IMPORTANT] Enabling vault sync imports your whole vault. The first time you turn it on, catch-up sync treats every existing .md file as unsynced and pushes all of them to the Target engram in one pass (then only edited notes sync thereafter). If you don't want a bulk import, point Target engram at a dedicated engram first, or enable sync on a small vault. The target engram must already exist — if it doesn't, the Graphnosis app shows a one-click banner to create it on first write.

Commands

Related

• nehloo-interactive/graphnosis-app — desktop app monorepo (Tauri shell, Node sidecar, VS Code extension)
• @nehloo/graphnosis — core memory SDK (npm)
• nehloo-interactive/graphnosis-secure-sync — encryption, op-log, and federation layer the SDK is built on

License

Apache-2.0 — see LICENSE.

Demo