backup: 2026-06-17 07:36

azosorg-roam.org

@@ -0,0 +1,19 @@
+:PROPERTIES:
+:ID: c945da4f-de5c-4eb8-bd99-810576a2545a
+:END:
+
+#+title: azos/org-roam
+#+filetags: :project: :knowledge: :org-roam:
+
+* Setup
+
+- Directory: =~/roam/=
+- Database: =~/.emacs.d/org-roam.db= (sqlite-builtin connector)
+- MCP server: =org-roam-mcp= registered in =~/.claude.json= via home-manager activation
+- org-agenda includes =~/roam/= so TODOs in roam files appear in agenda
+
+* Gotchas
+
+- org-roam-mcp is forked at =anerisgreat/org-roam-mcp= (not upstream =aserranoni/org-roam-mcp=); fork fixes: =create_node= writes directly to SQLite so new nodes are immediately searchable (no emacsclient needed), and =cli_main= is defined natively (no postPatch needed)
+- emacsql stores all Emacs strings in SQLite with surrounding ="..."= — the Python DB layer strips these with =_clean_path=/_clean_string=
+- org-roam timestamps in SQLite are Emacs =(HIGH LOW USEC PSEC)= tuples: =HIGH = secs >> 16=, =LOW = secs & 0xFFFF=