napkin-ai 0.4.2 → 0.6.0

package/README.md

@@ -59,6 +59,20 @@ napkin is designed as a memory system for agents. Instead of dumping the full va
 | 2 | `napkin search <query>` | ~2-5k | Ranked results with snippets |
 | 3 | `napkin read <file>` | ~5-20k | Full file content |
 
+## Benchmarks
+
+napkin includes agentic retrieval benchmarks in `bench/`. The headline result is [LongMemEval](https://arxiv.org/abs/2410.10813) (ICLR 2025), which tests long-term conversational memory across 500 questions.
+
+| Dataset | Sessions | pi + napkin | Best prior system | GPT-4o full context |
+|---------|----------|-------------|-------------------|---------------------|
+| Oracle | 1-6 | **92.0%** | 92.4% | 92.4% |
+| S | ~40 | **91.0%** | 86% | 64% |
+| M | ~500 | **83.0%** | 72% | n/a |
+
+Zero preprocessing. No embeddings, no graphs, no summaries. Just BM25 search on markdown files.
+
+See [`bench/README.md`](bench/README.md) for details and usage.
+
 ## Templates
 
 Scaffold a vault with a domain-specific structure:
@@ -94,14 +108,15 @@ napkin init --list               # List available templates
 napkin vault                          # Vault info
 napkin overview                       # Vault map with keywords
 napkin read <file>                    # Read file contents
-napkin create --name "Note" --content "Hello"
-napkin append --file "Note" --content "More text"
-napkin prepend --file "Note" --content "Top line"
-napkin move --file "Note" --to Archive
-napkin rename --file "Note" --name "Renamed"
-napkin delete --file "Note"           # Move to .trash
+napkin create "Note" "Hello"          # Create with content
+napkin append "Note" "More text"      # Append to file
+napkin prepend "Note" "Top line"      # Prepend after frontmatter
+napkin move "Note" Archive            # Move to folder
+napkin rename "Note" "Renamed"        # Rename file
+napkin delete "Note"                  # Move to .trash
 napkin search "meeting"               # Ranked search with snippets
 napkin search "TODO" --no-snippets    # Files only
+echo "piped content" | napkin append "Note"  # Stdin support
 ```
 
 ### Files & folders — `napkin file`
@@ -113,8 +128,8 @@ napkin file list --ext md             # Filter by extension
 napkin file list --folder Projects    # Filter by folder
 napkin file folder <path>             # Folder info
 napkin file folders                   # List all folders
-napkin file outline --file "note"     # Heading tree
-napkin file wordcount --file "note"   # Word + character count
+napkin file outline "note"             # Heading tree
+napkin file wordcount "note"          # Word + character count
 ```
 
 ### Daily notes — `napkin daily`
@@ -123,8 +138,8 @@ napkin file wordcount --file "note"   # Word + character count
 napkin daily today                    # Create today's daily note
 napkin daily path                     # Print daily note path
 napkin daily read                     # Print daily note contents
-napkin daily append --content "- [ ] Buy groceries"
-napkin daily prepend --content "## Morning"
+napkin daily append "- [ ] Buy groceries"
+napkin daily prepend "## Morning"
 ```
 
 ### Tags — `napkin tag`

package/dist/commands/aliases.js

@@ -28,7 +28,7 @@ function collectAliases(vaultPath, fileFilter) {
 }
 export async function aliases(opts) {
     const v = findVault(opts.vault);
-    const result = collectAliases(v.path, opts.file);
+    const result = collectAliases(v.contentPath, opts.file);
     output(opts, {
         json: () => {
             if (opts.total)

package/dist/commands/bases.js

@@ -7,7 +7,7 @@ import { bold, dim, error, output, success, } from "../utils/output.js";
 import { findVault } from "../utils/vault.js";
 export async function bases(opts) {
     const v = findVault(opts.vault);
-    const files = listFiles(v.path).filter((f) => f.endsWith(".base"));
+    const files = listFiles(v.contentPath).filter((f) => f.endsWith(".base"));
     output(opts, {
         json: () => ({ bases: files }),
         human: () => {
@@ -23,12 +23,12 @@ export async function bases(opts) {
 }
 export async function baseViews(opts) {
     const v = findVault(opts.vault);
-    const baseFile = resolveBaseFile(v.path, opts);
+    const baseFile = resolveBaseFile(v.contentPath, opts);
     if (!baseFile) {
         error("No base file specified. Use --file or --path");
         process.exit(EXIT_USER_ERROR);
     }
-    const content = fs.readFileSync(path.join(v.path, baseFile), "utf-8");
+    const content = fs.readFileSync(path.join(v.contentPath, baseFile), "utf-8");
     const config = parseBaseFile(content);
     const views = (config.views || []).map((view) => ({
         name: view.name || "(unnamed)",
@@ -45,14 +45,14 @@ export async function baseViews(opts) {
 }
 export async function baseQuery(opts) {
     const v = findVault(opts.vault);
-    const baseFile = resolveBaseFile(v.path, opts);
+    const baseFile = resolveBaseFile(v.contentPath, opts);
     if (!baseFile) {
         error("No base file specified. Use --file or --path");
         process.exit(EXIT_USER_ERROR);
     }
-    const content = fs.readFileSync(path.join(v.path, baseFile), "utf-8");
+    const content = fs.readFileSync(path.join(v.contentPath, baseFile), "utf-8");
     const config = parseBaseFile(content);
-    const db = await buildDatabase(v.path);
+    const db = await buildDatabase(v.contentPath);
     try {
         // Derive thisFile from the base file path
         const thisFile = baseFile
@@ -156,7 +156,7 @@ export async function baseCreate(opts) {
             ? opts.path
             : `${opts.path}/${opts.name}.md`
         : `${opts.name}.md`;
-    const fullPath = path.join(v.path, targetPath);
+    const fullPath = path.join(v.contentPath, targetPath);
     fs.mkdirSync(path.dirname(fullPath), { recursive: true });
     fs.writeFileSync(fullPath, opts.content || "");
     output(opts, {

package/dist/commands/bookmarks.js

@@ -3,8 +3,8 @@ import * as path from "node:path";
 import { EXIT_USER_ERROR } from "../utils/exit-codes.js";
 import { dim, error, output, success, } from "../utils/output.js";
 import { findVault } from "../utils/vault.js";
-function readBookmarks(vaultPath) {
-    const configPath = path.join(vaultPath, ".obsidian", "bookmarks.json");
+function readBookmarks(obsidianPath) {
+    const configPath = path.join(obsidianPath, "bookmarks.json");
     try {
         const content = fs.readFileSync(configPath, "utf-8");
         return JSON.parse(content);
@@ -13,8 +13,8 @@ function readBookmarks(vaultPath) {
         return [];
     }
 }
-function writeBookmarks(vaultPath, bookmarks) {
-    const configPath = path.join(vaultPath, ".obsidian", "bookmarks.json");
+function writeBookmarks(obsidianPath, bookmarks) {
+    const configPath = path.join(obsidianPath, "bookmarks.json");
     fs.writeFileSync(configPath, JSON.stringify(bookmarks, null, 2));
 }
 function flattenBookmarks(items) {
@@ -31,7 +31,7 @@ function flattenBookmarks(items) {
 }
 export async function bookmarks(opts) {
     const v = findVault(opts.vault);
-    const items = readBookmarks(v.path);
+    const items = readBookmarks(v.obsidianPath);
     const flat = flattenBookmarks(items);
     output(opts, {
         json: () => (opts.total ? { total: flat.length } : { bookmarks: flat }),
@@ -72,9 +72,9 @@ export async function bookmark(opts) {
         error("Specify --file, --folder, --search, or --url to bookmark");
         process.exit(EXIT_USER_ERROR);
     }
-    const items = readBookmarks(v.path);
+    const items = readBookmarks(v.obsidianPath);
     items.push(entry);
-    writeBookmarks(v.path, items);
+    writeBookmarks(v.obsidianPath, items);
     output(opts, {
         json: () => ({ added: entry }),
         human: () => success(`Bookmarked ${entry.path || entry.query || entry.url}`),

package/dist/commands/canvas.js

@@ -36,7 +36,7 @@ function writeCanvas(vaultPath, filePath, canvas) {
 }
 export async function canvases(opts) {
     const v = findVault(opts.vault);
-    const files = listFiles(v.path).filter((f) => f.endsWith(".canvas"));
+    const files = listFiles(v.contentPath).filter((f) => f.endsWith(".canvas"));
     output(opts, {
         json: () => (opts.total ? { total: files.length } : { canvases: files }),
         human: () => {
@@ -59,7 +59,7 @@ export async function canvasRead(opts) {
         error("No file specified. Use --file <name>");
         process.exit(EXIT_USER_ERROR);
     }
-    const { canvas, filePath } = readCanvas(v.path, opts.file);
+    const { canvas, filePath } = readCanvas(v.contentPath, opts.file);
     output(opts, {
         json: () => ({ path: filePath, ...canvas }),
         human: () => {
@@ -94,7 +94,7 @@ export async function canvasNodes(opts) {
         error("No file specified. Use --file <name>");
         process.exit(EXIT_USER_ERROR);
     }
-    const { canvas } = readCanvas(v.path, opts.file);
+    const { canvas } = readCanvas(v.contentPath, opts.file);
     let nodes = canvas.nodes;
     if (opts.type) {
         nodes = nodes.filter((n) => n.type === opts.type);
@@ -125,14 +125,14 @@ export async function canvasCreate(opts) {
         ? opts.file
         : `${opts.file}.canvas`;
     const targetPath = opts.path ? `${opts.path}/${fileName}` : fileName;
-    const fullPath = path.join(v.path, targetPath);
+    const fullPath = path.join(v.contentPath, targetPath);
     if (fs.existsSync(fullPath)) {
         error(`Canvas already exists: ${targetPath}`);
         process.exit(EXIT_USER_ERROR);
     }
     fs.mkdirSync(path.dirname(fullPath), { recursive: true });
     const canvas = { nodes: [], edges: [] };
-    writeCanvas(v.path, targetPath, canvas);
+    writeCanvas(v.contentPath, targetPath, canvas);
     output(opts, {
         json: () => ({ path: targetPath, created: true }),
         human: () => success(`Created ${targetPath}`),
@@ -149,7 +149,7 @@ export async function canvasAddNode(opts) {
         error("Invalid node type. Use: text, file, link, or group");
         process.exit(EXIT_USER_ERROR);
     }
-    const { canvas, filePath } = readCanvas(v.path, opts.file);
+    const { canvas, filePath } = readCanvas(v.contentPath, opts.file);
     // Auto-position: find rightmost node and place next to it
     const maxX = canvas.nodes.reduce((max, n) => Math.max(max, n.x + n.width), 0);
     const node = {
@@ -186,7 +186,7 @@ export async function canvasAddNode(opts) {
     if (opts.color)
         node.color = opts.color;
     canvas.nodes.push(node);
-    writeCanvas(v.path, filePath, canvas);
+    writeCanvas(v.contentPath, filePath, canvas);
     output(opts, {
         json: () => ({ id: node.id, type: node.type, added: true }),
         human: () => success(`Added ${node.type} node ${node.id}`),
@@ -202,7 +202,7 @@ export async function canvasAddEdge(opts) {
         error("Both --from and --to node IDs required");
         process.exit(EXIT_USER_ERROR);
     }
-    const { canvas, filePath } = readCanvas(v.path, opts.file);
+    const { canvas, filePath } = readCanvas(v.contentPath, opts.file);
     // Validate node IDs exist (match by full ID or prefix)
     const findNode = (ref) => canvas.nodes.find((n) => n.id === ref || n.id.startsWith(ref));
     const fromNode = findNode(opts.from);
@@ -229,7 +229,7 @@ export async function canvasAddEdge(opts) {
     if (opts.color)
         edge.color = opts.color;
     canvas.edges.push(edge);
-    writeCanvas(v.path, filePath, canvas);
+    writeCanvas(v.contentPath, filePath, canvas);
     output(opts, {
         json: () => ({
             id: edge.id,
@@ -246,7 +246,7 @@ export async function canvasRemoveNode(opts) {
         error("Both --file and --id required");
         process.exit(EXIT_USER_ERROR);
     }
-    const { canvas, filePath } = readCanvas(v.path, opts.file);
+    const { canvas, filePath } = readCanvas(v.contentPath, opts.file);
     const id = opts.id;
     const node = canvas.nodes.find((n) => n.id === id || n.id.startsWith(id));
     if (!node) {
@@ -256,7 +256,7 @@ export async function canvasRemoveNode(opts) {
     // Remove node and any connected edges
     canvas.nodes = canvas.nodes.filter((n) => n.id !== node.id);
     canvas.edges = canvas.edges.filter((e) => e.fromNode !== node.id && e.toNode !== node.id);
-    writeCanvas(v.path, filePath, canvas);
+    writeCanvas(v.contentPath, filePath, canvas);
     output(opts, {
         json: () => ({ id: node.id, removed: true }),
         human: () => success(`Removed node ${node.id}`),

package/dist/commands/config.js

@@ -4,7 +4,7 @@ import { bold, dim, error, output, } from "../utils/output.js";
 import { findVault } from "../utils/vault.js";
 export async function configShow(opts) {
     const v = findVault(opts.vault);
-    const config = loadConfig(v.path);
+    const config = loadConfig(v.configPath);
     output(opts, {
         json: () => config,
         human: () => {
@@ -35,7 +35,7 @@ export async function configSet(opts) {
         parsed = opts.value;
     }
     current[parts[parts.length - 1]] = parsed;
-    const updated = updateConfig(v.path, obj);
+    const updated = updateConfig(v.configPath, obj);
     output(opts, {
         json: () => updated,
         human: () => {
@@ -49,7 +49,7 @@ export async function configGet(opts) {
         error("Usage: napkin config get --key <path>");
         process.exit(EXIT_USER_ERROR);
     }
-    const config = loadConfig(v.path);
+    const config = loadConfig(v.configPath);
     const parts = opts.key.split(".");
     let value = config;
     for (const part of parts) {

package/dist/commands/crud.js

@@ -12,12 +12,12 @@ export async function read(fileRef, opts) {
         error("No file specified. Usage: napkin read <file>");
         process.exit(EXIT_USER_ERROR);
     }
-    const resolved = resolveFile(v.path, fileRef);
+    const resolved = resolveFile(v.contentPath, fileRef);
     if (!resolved) {
-        fileNotFound(fileRef, suggestFile(v.path, fileRef));
+        fileNotFound(fileRef, suggestFile(v.contentPath, fileRef));
         process.exit(EXIT_NOT_FOUND);
     }
-    const content = fs.readFileSync(path.join(v.path, resolved), "utf-8");
+    const content = fs.readFileSync(path.join(v.contentPath, resolved), "utf-8");
     output(opts, {
         json: () => ({ path: resolved, content }),
         human: () => console.log(content),
@@ -33,21 +33,21 @@ export async function create(opts) {
         const name = opts.name || "Untitled";
         targetPath = `${name}.md`;
     }
-    const fullPath = path.join(v.path, targetPath);
+    const fullPath = path.join(v.contentPath, targetPath);
     if (fs.existsSync(fullPath) && !opts.overwrite) {
         error(`File already exists: ${targetPath}. Use --overwrite to replace.`);
         process.exit(EXIT_USER_ERROR);
     }
     let content = opts.content || "";
     if (opts.template) {
-        const config = loadConfig(v.path);
-        const templateRef = resolveFile(v.path, opts.template) ||
-            resolveFile(v.path, `${config.templates.folder}/${opts.template}`);
+        const config = loadConfig(v.configPath);
+        const templateRef = resolveFile(v.contentPath, opts.template) ||
+            resolveFile(v.contentPath, `${config.templates.folder}/${opts.template}`);
         if (templateRef) {
-            content = fs.readFileSync(path.join(v.path, templateRef), "utf-8");
+            content = fs.readFileSync(path.join(v.contentPath, templateRef), "utf-8");
         }
         else {
-            const tmplFiles = listFiles(v.path, {
+            const tmplFiles = listFiles(v.contentPath, {
                 folder: config.templates.folder,
                 ext: "md",
             }).map((f) => path.basename(f, ".md"));
@@ -62,22 +62,35 @@ export async function create(opts) {
         human: () => success(`Created ${targetPath}`),
     });
 }
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return undefined;
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    const result = Buffer.concat(chunks).toString("utf-8").trimEnd();
+    return result || undefined;
+}
 export async function append(opts) {
     const v = findVault(opts.vault);
     if (!opts.file) {
-        error("No file specified. Use --file <name>");
+        error("No file specified. Use: napkin append <file> [content]");
         process.exit(EXIT_USER_ERROR);
     }
     if (!opts.content) {
-        error("No content specified. Use --content <text>");
+        opts.content = await readStdin();
+    }
+    if (!opts.content) {
+        error("No content specified. Use: napkin append <file> <content>");
         process.exit(EXIT_USER_ERROR);
     }
-    const resolved = resolveFile(v.path, opts.file);
+    const resolved = resolveFile(v.contentPath, opts.file);
     if (!resolved) {
-        fileNotFound(opts.file, suggestFile(v.path, opts.file));
+        fileNotFound(opts.file, suggestFile(v.contentPath, opts.file));
         process.exit(EXIT_NOT_FOUND);
     }
-    const fullPath = path.join(v.path, resolved);
+    const fullPath = path.join(v.contentPath, resolved);
     const existing = fs.readFileSync(fullPath, "utf-8");
     const separator = opts.inline ? "" : "\n";
     fs.writeFileSync(fullPath, existing + separator + opts.content);
@@ -89,19 +102,22 @@ export async function append(opts) {
 export async function prepend(opts) {
     const v = findVault(opts.vault);
     if (!opts.file) {
-        error("No file specified. Use --file <name>");
+        error("No file specified. Use: napkin prepend <file> [content]");
         process.exit(EXIT_USER_ERROR);
     }
     if (!opts.content) {
-        error("No content specified. Use --content <text>");
+        opts.content = await readStdin();
+    }
+    if (!opts.content) {
+        error("No content specified. Use: napkin prepend <file> <content>");
         process.exit(EXIT_USER_ERROR);
     }
-    const resolved = resolveFile(v.path, opts.file);
+    const resolved = resolveFile(v.contentPath, opts.file);
     if (!resolved) {
-        fileNotFound(opts.file, suggestFile(v.path, opts.file));
+        fileNotFound(opts.file, suggestFile(v.contentPath, opts.file));
         process.exit(EXIT_NOT_FOUND);
     }
-    const fullPath = path.join(v.path, resolved);
+    const fullPath = path.join(v.contentPath, resolved);
     const existing = fs.readFileSync(fullPath, "utf-8");
     const separator = opts.inline ? "" : "\n";
     // Insert after frontmatter if present
@@ -128,9 +144,9 @@ export async function move(opts) {
         error("No destination specified. Use --to <path>");
         process.exit(EXIT_USER_ERROR);
     }
-    const resolved = resolveFile(v.path, opts.file);
+    const resolved = resolveFile(v.contentPath, opts.file);
     if (!resolved) {
-        fileNotFound(opts.file, suggestFile(v.path, opts.file));
+        fileNotFound(opts.file, suggestFile(v.contentPath, opts.file));
         process.exit(EXIT_NOT_FOUND);
     }
     let destPath = opts.to;
@@ -138,8 +154,8 @@ export async function move(opts) {
     if (!destPath.endsWith(".md")) {
         destPath = path.join(destPath, path.basename(resolved));
     }
-    const srcFull = path.join(v.path, resolved);
-    const destFull = path.join(v.path, destPath);
+    const srcFull = path.join(v.contentPath, resolved);
+    const destFull = path.join(v.contentPath, destPath);
     fs.mkdirSync(path.dirname(destFull), { recursive: true });
     fs.renameSync(srcFull, destFull);
     output(opts, {
@@ -157,15 +173,15 @@ export async function rename(opts) {
         error("No new name specified. Use --name <name>");
         process.exit(EXIT_USER_ERROR);
     }
-    const resolved = resolveFile(v.path, opts.file);
+    const resolved = resolveFile(v.contentPath, opts.file);
     if (!resolved) {
-        fileNotFound(opts.file, suggestFile(v.path, opts.file));
+        fileNotFound(opts.file, suggestFile(v.contentPath, opts.file));
         process.exit(EXIT_NOT_FOUND);
     }
     const newName = opts.name.endsWith(".md") ? opts.name : `${opts.name}.md`;
     const destPath = path.join(path.dirname(resolved), newName);
-    const srcFull = path.join(v.path, resolved);
-    const destFull = path.join(v.path, destPath);
+    const srcFull = path.join(v.contentPath, resolved);
+    const destFull = path.join(v.contentPath, destPath);
     fs.renameSync(srcFull, destFull);
     output(opts, {
         json: () => ({ from: resolved, to: destPath }),
@@ -178,17 +194,17 @@ export async function del(opts) {
         error("No file specified. Use --file <name>");
         process.exit(EXIT_USER_ERROR);
     }
-    const resolved = resolveFile(v.path, opts.file);
+    const resolved = resolveFile(v.contentPath, opts.file);
     if (!resolved) {
-        fileNotFound(opts.file, suggestFile(v.path, opts.file));
+        fileNotFound(opts.file, suggestFile(v.contentPath, opts.file));
         process.exit(EXIT_NOT_FOUND);
     }
-    const fullPath = path.join(v.path, resolved);
+    const fullPath = path.join(v.contentPath, resolved);
     if (opts.permanent) {
         fs.unlinkSync(fullPath);
     }
     else {
-        const trashDir = path.join(v.path, ".trash");
+        const trashDir = path.join(v.contentPath, ".trash");
         fs.mkdirSync(trashDir, { recursive: true });
         const trashPath = path.join(trashDir, path.basename(resolved));
         fs.renameSync(fullPath, trashPath);

package/dist/commands/daily.js

@@ -51,15 +51,15 @@ export function getDailyPath(vaultPath, date) {
 }
 export async function daily(opts) {
     const v = findVault(opts.vault);
-    const dailyPath = getDailyPath(v.path);
-    const fullPath = path.join(v.path, dailyPath);
+    const dailyPath = getDailyPath(v.configPath);
+    const fullPath = path.join(v.contentPath, dailyPath);
     // Create if doesn't exist
     if (!fs.existsSync(fullPath)) {
         fs.mkdirSync(path.dirname(fullPath), { recursive: true });
-        const config = getDailyConfig(v.path);
+        const config = getDailyConfig(v.configPath);
         let content = "";
         if (config.template) {
-            const templatePath = path.join(v.path, `${config.template}.md`);
+            const templatePath = path.join(v.contentPath, `${config.template}.md`);
             if (fs.existsSync(templatePath)) {
                 content = fs.readFileSync(templatePath, "utf-8");
             }
@@ -73,7 +73,7 @@ export async function daily(opts) {
 }
 export async function dailyPath(opts) {
     const v = findVault(opts.vault);
-    const dp = getDailyPath(v.path);
+    const dp = getDailyPath(v.configPath);
     output(opts, {
         json: () => ({ path: dp }),
         human: () => console.log(dp),
@@ -81,8 +81,8 @@ export async function dailyPath(opts) {
 }
 export async function dailyRead(opts) {
     const v = findVault(opts.vault);
-    const dp = getDailyPath(v.path);
-    const fullPath = path.join(v.path, dp);
+    const dp = getDailyPath(v.configPath);
+    const fullPath = path.join(v.contentPath, dp);
     if (!fs.existsSync(fullPath)) {
         error(`Daily note not found: ${dp}`);
         process.exit(EXIT_NOT_FOUND);
@@ -99,8 +99,8 @@ export async function dailyAppend(opts) {
         error("No content specified. Use --content <text>");
         process.exit(EXIT_USER_ERROR);
     }
-    const dp = getDailyPath(v.path);
-    const fullPath = path.join(v.path, dp);
+    const dp = getDailyPath(v.configPath);
+    const fullPath = path.join(v.contentPath, dp);
     // Create if doesn't exist
     if (!fs.existsSync(fullPath)) {
         fs.mkdirSync(path.dirname(fullPath), { recursive: true });
@@ -120,8 +120,8 @@ export async function dailyPrepend(opts) {
         error("No content specified. Use --content <text>");
         process.exit(EXIT_USER_ERROR);
     }
-    const dp = getDailyPath(v.path);
-    const fullPath = path.join(v.path, dp);
+    const dp = getDailyPath(v.configPath);
+    const fullPath = path.join(v.contentPath, dp);
     if (!fs.existsSync(fullPath)) {
         fs.mkdirSync(path.dirname(fullPath), { recursive: true });
         fs.writeFileSync(fullPath, "");

package/dist/commands/files.js

@@ -11,12 +11,12 @@ export async function file(fileRef, opts) {
         error("No file specified. Usage: obsidian-cli file <name>");
         process.exit(EXIT_NOT_FOUND);
     }
-    const resolved = resolveFile(v.path, fileRef);
+    const resolved = resolveFile(v.contentPath, fileRef);
     if (!resolved) {
-        fileNotFound(fileRef, suggestFile(v.path, fileRef));
+        fileNotFound(fileRef, suggestFile(v.contentPath, fileRef));
         process.exit(EXIT_NOT_FOUND);
     }
-    const info = getFileInfo(v.path, resolved);
+    const info = getFileInfo(v.contentPath, resolved);
     output(opts, {
         json: () => info,
         human: () => {
@@ -31,7 +31,10 @@ export async function file(fileRef, opts) {
 }
 export async function files(opts) {
     const v = findVault(opts.vault);
-    const result = listFiles(v.path, { folder: opts.folder, ext: opts.ext });
+    const result = listFiles(v.contentPath, {
+        folder: opts.folder,
+        ext: opts.ext,
+    });
     output(opts, {
         json: () => (opts.total ? { total: result.length } : { files: result }),
         human: () => {
@@ -47,7 +50,7 @@ export async function files(opts) {
 }
 export async function folders(opts) {
     const v = findVault(opts.vault);
-    const result = listFolders(v.path, opts.folder);
+    const result = listFolders(v.contentPath, opts.folder);
     output(opts, {
         json: () => (opts.total ? { total: result.length } : { folders: result }),
         human: () => {
@@ -67,17 +70,17 @@ export async function folder(folderPath, opts) {
         error("No folder specified. Usage: obsidian-cli folder <path>");
         process.exit(EXIT_NOT_FOUND);
     }
-    const fullPath = path.join(v.path, folderPath);
+    const fullPath = path.join(v.contentPath, folderPath);
     if (!fs.existsSync(fullPath) || !fs.statSync(fullPath).isDirectory()) {
         error(`Folder not found: ${folderPath}`);
         process.exit(EXIT_NOT_FOUND);
     }
-    const fileCount = listFiles(v.path, { folder: folderPath }).length;
-    const folderCount = listFolders(v.path, folderPath).length;
+    const fileCount = listFiles(v.contentPath, { folder: folderPath }).length;
+    const folderCount = listFolders(v.contentPath, folderPath).length;
     let size = 0;
-    const allFiles = listFiles(v.path, { folder: folderPath });
+    const allFiles = listFiles(v.contentPath, { folder: folderPath });
     for (const f of allFiles) {
-        size += fs.statSync(path.join(v.path, f)).size;
+        size += fs.statSync(path.join(v.contentPath, f)).size;
     }
     if (opts.info) {
         const val = opts.info === "files"
@@ -111,9 +114,9 @@ export async function open(fileRef, opts) {
     const vaultName = encodeURIComponent(v.name);
     let uri;
     if (fileRef) {
-        const resolved = resolveFile(v.path, fileRef);
+        const resolved = resolveFile(v.contentPath, fileRef);
         if (!resolved) {
-            fileNotFound(fileRef, suggestFile(v.path, fileRef));
+            fileNotFound(fileRef, suggestFile(v.contentPath, fileRef));
             process.exit(EXIT_NOT_FOUND);
         }
         const encodedFile = encodeURIComponent(resolved.replace(/\.md$/, ""));

package/dist/commands/graph.js

@@ -427,13 +427,14 @@ async function openInBrowser(html) {
 }
 export async function graph(_args, options) {
     const { findVault } = await import("../utils/vault.js");
-    const vault = options.vault ? options.vault : findVault(process.cwd())?.path;
+    const vaultInfo = findVault(options.vault || process.cwd());
+    const vault = vaultInfo?.contentPath;
     if (!vault) {
         error("No vault found. Run napkin init or use --vault <path>");
         process.exit(1);
     }
     const { loadConfig } = await import("../utils/config.js");
-    const config = loadConfig(vault);
+    const config = loadConfig(vaultInfo.configPath);
     const renderer = config.graph?.renderer ?? "auto";
     const { nodes, links } = buildGraphData(vault);
     const graphDataB64 = Buffer.from(JSON.stringify({ nodes, links })).toString("base64");