navigate-memory

Query org-roam nodes by ID or title with org-roam-ql filtering.

Updated Mar 29, 2024
One-click install
npx skills add https://github.com/addisonbeck/nix --skill navigate-memory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: navigate-memory
Source: https://github.com/addisonbeck/nix/tree/main/bobert/skills/navigate-memory
Command: npx skills add https://github.com/addisonbeck/nix --skill navigate-memory

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires org-roam, org-roam-ql.

What problem does it solve?

Queries the org-roam knowledge base to locate, filter, and traverse nodes without modifying content.

Core Features & Use Cases

  • Dual execution modes: batch mode (BOBERT_EMACS set) and daemon mode (BOBERT_EMACS unset).
  • Node lookup by ID or title, org-roam-ql predicate filtering, and simple graph aggregation to surface connected nodes.
  • Read-only operations that let agents explore the knowledge graph without changing any content.

Quick Start

Run the navigate-memory.sh script with an elisp expression to query org-roam and print node titles and IDs.

Frequently Asked Questions about navigate-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search an org-roam knowledge base without modifying notes?

You can query the org-roam knowledge base in read-only mode to locate, filter, and traverse nodes without modifying content. The Skill routes queries through batch or daemon Emacs processes to return human-readable text output.

Can I filter org-roam nodes using org-roam-ql predicates?

Yes, org-roam-ql predicate filtering is supported for node lookup. You can locate specific nodes by ID or title and apply predicates to narrow down the knowledge graph results.

Does this approach work with both batch and daemon Emacs execution?

It supports dual execution modes: batch mode when the BOBERT_EMACS environment variable is set and daemon mode otherwise. The navigate-memory.sh script routes to the correct Emacs process accordingly.

What is the best way to traverse connected nodes in an org-roam graph?

Simple graph aggregation surfaces connected nodes within the org-roam knowledge base. You can traverse the graph by querying node relationships after initializing org-roam settings through the execution script.

Do I need org-roam and org-roam-ql installed to query my knowledge graph?

Yes, both org-roam and org-roam-ql are required dependencies. The Skill relies on these packages to initialize settings, execute elisp expressions, and perform node lookups within the Emacs environment.