vault-cortex 0.10.0 → 0.10.1-beta.48

package/README.md

@@ -15,7 +15,7 @@ and data files — see the
 The server runs as a Docker container; this CLI scaffolds the config and
 manages the container so you don't have to.
 
-![npx vault-cortex init — the interactive setup wizard picks a mode, finds your vault, offers the optional settings, generates the config, and starts the server](https://raw.githubusercontent.com/aliasunder/vault-cortex/main/assets/demo-cli-init.gif)
+![npx vault-cortex@latest init — the interactive setup wizard picks a mode, finds your vault, offers the optional settings, generates the config, and starts the server](https://raw.githubusercontent.com/aliasunder/vault-cortex/main/assets/demo-cli-init.gif)
 
 ## Commands
 
@@ -34,7 +34,7 @@ manages the container so you don't have to.
 - [`get-sync-token`](#get-sync-token) — generate an Obsidian Sync auth token
   for remote setups
 
-Run `npx vault-cortex <command> --help` for all flags.
+Run `npx vault-cortex@latest <command> --help` for all flags.
 
 ## init
 
@@ -49,9 +49,9 @@ What it does:
    - **Remote** — a VPS with [Obsidian Sync](https://obsidian.md/sync),
      reachable from any device
 2. Offers the most common optional settings — memory layer and folder,
-   file tools, semantic search, port, timezone (plus sync direction for
-   remote) — press enter to keep the defaults, or pick the ones you want to
-   change
+   daily notes folder and format, file tools, semantic search, port,
+   timezone (plus sync direction for remote) — press enter to keep the
+   defaults, or pick the ones you want to change
 3. Generates a `.env` file with a securely generated `MCP_AUTH_TOKEN`
 4. Optionally starts the container and waits for the health check
 5. Prints your connection details — the MCP URL, your auth token, and how to
@@ -85,11 +85,13 @@ Change optional settings on an existing setup:
 npx vault-cortex@latest configure
 ```
 
-Shows the same settings chooser as [`init`](#init) — memory layer and
-folder, file tools, semantic search, port, timezone (plus sync direction
-for remote) — pre-filled with your current values, saves your picks to
-`.env`, and offers to restart the container so they take effect. Settings not in the chooser
-live in `.env` too: edit the value there, then run [`restart`](#restart).
+Shows the same settings chooser as [`init`](#init), pre-filled with your
+current values, saves your picks to `.env`, and offers to restart the
+container so they take effect.
+
+Settings not in the chooser live in `.env` too: edit the value there, then
+run [`restart`](#restart). That's also how you clear a daily notes setting
+back to your vault's own configuration — comment out or delete its line.
 
 Use `--dir <path>` if your config isn't in `./vault-cortex`.
 

package/dist/configure.js

@@ -20,7 +20,10 @@ export const runConfigure = async (flags, deps) => {
     const envContent = readFileSync(envFilePath, "utf8");
     const pickedOverrides = await askOptionalSettings({ mode, envContent }, prompts);
     if (Object.keys(pickedOverrides).length === 0) {
-        prompts.log("No settings selected — nothing changed.");
+        // Covers both empty-overrides paths: nothing picked in the chooser, and
+        // picked-but-kept (an optionalText prompt left blank logs its own
+        // "Kept the current value" line, which this must not contradict).
+        prompts.log("No changes to apply.");
         prompts.outro("Done.");
         return 0;
     }

package/dist/env.js

@@ -61,12 +61,21 @@ FILE_TOOLS_ENABLED=true
 # Memory folder name in your vault (default: About Me).
 MEMORY_DIR=About Me
 
-# Comma-separated folders protected from deletion (default: MEMORY_DIR, Daily Notes).
-# If your daily notes folder has a custom name (e.g. "Journal"), override to include it.
+# Daily notes folder and filename format (default: read from the
+# vault's .obsidian/daily-notes.json, falling back to "Daily Notes" and
+# YYYY-MM-DD). Folder is any vault-relative path (Journal, Planner/Daily);
+# format takes the same tokens as Obsidian's date format setting.
+# DAILY_NOTES_FOLDER=Journal
+# DAILY_NOTES_FORMAT=YYYY-MM-DD
+
+# Comma-separated folders protected from deletion (default: MEMORY_DIR plus
+# the daily notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes").
+# A custom folder set only in daily-notes.json is not auto-protected.
 # PROTECTED_PATHS=About Me,Daily Notes
 
-# Comma-separated folders excluded from orphan detection
-# (default: Daily Notes, Templates, MEMORY_DIR).
+# Comma-separated folders excluded from orphan detection (default: the daily
+# notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes" — plus
+# Templates and MEMORY_DIR).
 # ORPHAN_EXCLUDE_FOLDERS=Daily Notes,Templates,About Me
 
 # URL shown in OAuth discovery metadata
@@ -154,12 +163,22 @@ FILE_TOOLS_ENABLED=true
 # Memory folder name in your vault (default: About Me).
 MEMORY_DIR=About Me
 
-# Comma-separated folders protected from deletion (default: MEMORY_DIR, Daily Notes).
-# If your daily notes folder has a custom name (e.g. "Journal"), override to include it.
+# Daily notes folder and filename format (default: read from the
+# vault's .obsidian/daily-notes.json, synced to the server via SYNC_CONFIGS
+# below; falls back to "Daily Notes" and YYYY-MM-DD). Folder is any
+# vault-relative path (Journal, Planner/Daily); format takes the same tokens
+# as Obsidian's date format setting.
+# DAILY_NOTES_FOLDER=Journal
+# DAILY_NOTES_FORMAT=YYYY-MM-DD
+
+# Comma-separated folders protected from deletion (default: MEMORY_DIR plus
+# the daily notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes").
+# A custom folder set only in daily-notes.json is not auto-protected.
 # PROTECTED_PATHS=About Me,Daily Notes
 
-# Comma-separated folders excluded from orphan detection
-# (default: Daily Notes, Templates, MEMORY_DIR).
+# Comma-separated folders excluded from orphan detection (default: the daily
+# notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes" — plus
+# Templates and MEMORY_DIR).
 # ORPHAN_EXCLUDE_FOLDERS=Daily Notes,Templates,About Me
 
 # URL shown in OAuth discovery metadata
@@ -192,6 +211,17 @@ CONFLICT_STRATEGY=merge
 
 # Sync direction: bidirectional | pull-only | push-only (default: bidirectional).
 SYNC_MODE=bidirectional
+
+# Obsidian settings categories to sync into the server's .obsidian/ folder
+# (default: the two the server reads — daily notes settings and community
+# plugin settings such as the Tasks plugin's format; "none" disables).
+# A category only syncs after your desktop pushes it: Obsidian Settings →
+# Sync → "Vault configuration sync" (per device). Some community plugins
+# keep API keys in their settings — server tools never read .obsidian/,
+# but synced settings do live on the server volume. Values: app,
+# appearance, appearance-data, hotkey, core-plugin, core-plugin-data,
+# community-plugin, community-plugin-data — comma-separated.
+SYNC_CONFIGS=core-plugin-data,community-plugin-data
 `;
 // sync:remote-optional:end
 export const buildLocalEnv = (answers) => `# vault-cortex — local quickstart

package/dist/messages.js

@@ -166,8 +166,8 @@ ${nonOauthBlocks}
 
 ${sectionRule("Settings")}
 
-Adjust optional settings (memory layer and folder, file tools,
-semantic search, port, timezone):
+Adjust optional settings (memory layer and folder, daily notes
+folder and format, file tools, semantic search, port, timezone):
   npx vault-cortex@latest configure --dir "${targetDir}"
 
 Or edit ${targetDir}/.env directly — change a value (uncommenting it
@@ -231,8 +231,9 @@ ${remoteHealthCheckBlock(`${publicUrl}/healthz`, started)}
 
 ${sectionRule("Settings")}
 
-Adjust optional settings (memory layer and folder, file tools,
-semantic search, port, timezone, sync direction):
+Adjust optional settings (memory layer and folder, daily notes
+folder and format, file tools, semantic search, port, timezone,
+sync direction):
   npx vault-cortex@latest configure --dir "${targetDir}"
 
 Or edit ${targetDir}/.env directly — change a value (uncommenting it

package/dist/optional-settings.js

@@ -17,6 +17,20 @@ const OPTIONAL_SETTINGS = [
         defaultValue: "About Me",
         requiresToggle: "MEMORY_ENABLED",
     },
+    {
+        kind: "optionalText",
+        name: "DAILY_NOTES_FOLDER",
+        label: "Daily notes folder",
+        question: "Vault folder for daily notes:",
+        placeholder: "blank = use your vault's daily notes settings",
+    },
+    {
+        kind: "optionalText",
+        name: "DAILY_NOTES_FORMAT",
+        label: "Daily notes format",
+        question: "Filename date format for daily notes (e.g. YYYY-MM-DD):",
+        placeholder: "blank = use your vault's daily notes settings",
+    },
     {
         kind: "toggle",
         name: "FILE_TOOLS_ENABLED",
@@ -176,7 +190,34 @@ const askFolder = async (params, prompts) => {
     prompts.error("The folder name can't be empty.");
     return askFolder(params, prompts);
 };
-/** Routes a picked setting to its kind's prompt and returns the .env value. */
+/**
+ * Text prompt for a setting whose absence is meaningful — the server falls
+ * back to the vault's own config when the var is unset. Blank-when-unset
+ * writes nothing; blank-when-set keeps the current value. Returns undefined
+ * on skip or no-op so the caller never rewrites for nothing. No removal
+ * path — clearing is a manual .env edit.
+ */
+const askOptionalText = async (params, prompts) => {
+    const { question, placeholder, currentValue } = params;
+    const answer = (await prompts.text(question, {
+        defaultValue: currentValue,
+        placeholder: currentValue === undefined
+            ? placeholder
+            : "blank = keep the current value",
+    })).trim();
+    if (answer !== "" && answer !== currentValue)
+        return answer;
+    if (currentValue === undefined) {
+        prompts.log("Left unset — the server reads this setting from your vault's own config.");
+        return undefined;
+    }
+    prompts.log(`Kept the current value (${currentValue}).`);
+    return undefined;
+};
+/**
+ * Routes a picked setting to its kind's prompt and returns the .env value —
+ * or undefined when an optionalText prompt was left blank (nothing to write).
+ */
 const askSettingValue = async (params, prompts) => {
     const { setting, currentValue } = params;
     switch (setting.kind) {
@@ -194,6 +235,12 @@ const askSettingValue = async (params, prompts) => {
                 currentValue,
                 defaultValue: setting.defaultValue,
             }, prompts);
+        case "optionalText":
+            return askOptionalText({
+                question: setting.question,
+                placeholder: setting.placeholder,
+                currentValue,
+            }, prompts);
         case "choice":
             return prompts.select(setting.question, setting.choices, currentValue ?? setting.defaultValue);
     }
@@ -222,12 +269,15 @@ export const askOptionalSettings = async (params, prompts) => {
     });
     const pickedNames = await prompts.multiselect("Any optional settings to change? (press enter to skip)", chooserOptions);
     // Sequential prompting: answers are gathered one at a time in the curated
-    // order, so the record builds up inside an honest loop.
+    // order, so the record builds up inside an honest loop. An undefined answer
+    // (an optionalText prompt left blank) writes nothing.
     const overrides = {};
     for (const setting of offeredSettings) {
         if (!pickedNames.includes(setting.name))
             continue;
-        overrides[setting.name] = await askSettingValue({ setting, currentValue: readOptionalValue(envContent, setting.name) }, prompts);
+        const value = await askSettingValue({ setting, currentValue: readOptionalValue(envContent, setting.name) }, prompts);
+        if (value !== undefined)
+            overrides[setting.name] = value;
     }
     return overrides;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vault-cortex",
-  "version": "0.10.0",
-  "description": "Set up a Vault Cortex MCP server for your Obsidian vault in one command: npx vault-cortex init",
+  "version": "0.10.1-beta.48",
+  "description": "Set up a Vault Cortex MCP server for your Obsidian vault in one command: npx vault-cortex@latest init",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -28,18 +28,23 @@
     "mcp-server",
     "model-context-protocol",
     "obsidian",
-    "obsidian-mcp",
+    "obsidian-mcp-server",
     "obsidian-vault",
+    "obsidian-sync",
+    "ai-agents",
     "ai-memory",
-    "memory",
+    "ai-memory-system",
     "knowledge-base",
     "note-taking",
-    "second-brain",
+    "pkm",
+    "personal-knowledge-management",
     "hybrid-search",
     "task-management",
     "semantic-search",
     "attachments",
     "pdf",
+    "self-hosted",
+    "docker",
     "claude",
     "cli"
   ],