Obsidian_Vault tool is easier for smaller models to understand and 1-shot

Modules/Obsidian_Vault.py

@@ -16,25 +16,26 @@ from ._docstrings import autodoc
 TOOL_SUMMARY = (
     "Browse and search the Obsidian vault in read-only mode. "
     "Actions: list, read, info, search, help. "
-    "All paths resolve within the vault root."
+    "All paths resolve within the vault root. Start paths with '/' (e.g., /Notes)."
 )
 
 HELP_TEXT = (
     "Obsidian Vault — actions and usage\n\n"
     "Root: Tools/Obsidian (override with OBSIDIAN_VAULT_ROOT). "
+    "Start paths with '/' to reference the vault root (e.g., /Projects/note.md). "
     "Absolute paths are disabled unless UNSAFE_ALLOW_ABS_PATHS=1.\n\n"
     "Actions and fields:\n"
-    "- list: path='.' (default), recursive=false, show_hidden=false, max_entries=20\n"
-    "- read: path, offset=0, max_chars=4000 (shows next_cursor when truncated)\n"
+    "- list: path='/' (default), recursive=false, show_hidden=false, max_entries=20\n"
+    "- read: path (e.g., /Projects/note.md), offset=0, max_chars=4000 (shows next_cursor when truncated)\n"
     "- info: path\n"
     "- search: path (note or folder), query text in the Search field, recursive=false, show_hidden=false, max_entries=20, case_sensitive=false, offset=0\n"
     "- help: show this guide\n\n"
     "Errors are returned as JSON with fields: {status:'error', code, message, path?, hint?, data?}.\n\n"
     "Examples:\n"
-    "- list current: action=list, path='.'\n"
-    "- read note: action=read, path='Projects/note.md', max_chars=500\n"
-    "- show metadata: action=info, path='Inbox'\n"
-    "- search notes: action=search, path='Projects', query='deadline', recursive=true, max_entries=100\n"
+    "- list current: action=list, path='/'\n"
+    "- read note: action=read, path='/Projects/note.md', max_chars=500\n"
+    "- show metadata: action=info, path='/Inbox'\n"
+    "- search notes: action=search, path='/Projects', query='deadline', recursive=true, max_entries=100\n"
     "- case-sensitive search: action=search, query='TODO', case_sensitive=true\n"
     "- page search results: action=search, query='TODO', offset=20\n"
 )
@@ -106,15 +107,22 @@ def _display_path(abs_path: str) -> str:
 
 def _resolve_path(path: str) -> tuple[str, str]:
     try:
-        user_input = (path or ".").strip()
-        raw = os.path.expanduser(user_input)
-        if os.path.isabs(raw):
+        user_input = (path or "/").strip() or "/"
+        if user_input.startswith("/"):
+            rel_part = user_input.lstrip("/") or "."
+            raw = os.path.expanduser(rel_part)
+            treat_as_relative = True
+        else:
+            raw = os.path.expanduser(user_input)
+            treat_as_relative = False
+
+        if not treat_as_relative and os.path.isabs(raw):
             if not ALLOW_ABS:
                 return "", _err(
                     "absolute_path_disabled",
                     "Absolute paths are disabled in safe mode.",
                     path=raw.replace("\\", "/"),
-                    hint="Use a path relative to / (e.g., Notes/index.md).",
+                    hint="Use a path relative to / (e.g., /Notes/index.md).",
                 )
             abs_path = os.path.abspath(raw)
         else:
@@ -378,7 +386,7 @@ def _info(abs_path: str) -> str:
 @autodoc(summary=TOOL_SUMMARY)
 def Obsidian_Vault(
     action: Annotated[str, "Operation to perform: 'list', 'read', 'info', 'search', 'help'."],
-    path: Annotated[str, "Target path, relative to the vault root." ] = ".",
+    path: Annotated[str, "Target path, relative to the vault root." ] = "/",
     query: Annotated[Optional[str], "Text to search for when action=search."] = None,
     recursive: Annotated[bool, "Recurse into subfolders when listing/searching."] = False,
     show_hidden: Annotated[bool, "Include hidden files when listing/searching."] = False,
@@ -463,7 +471,7 @@ def build_interface() -> gr.Interface:
                 choices=["list", "read", "info", "search", "help"],
                 value="help",
             ),
-            gr.Textbox(label="Path", placeholder=". or Notes/todo.md", max_lines=1, value="."),
+            gr.Textbox(label="Path", placeholder="/ or /Notes/todo.md", max_lines=1, value="/"),
             gr.Textbox(label="Search text (search)", lines=3, placeholder="Text to search for..."),
             gr.Checkbox(label="Recursive (list/search)", value=False),
             gr.Checkbox(label="Show hidden (list/search)", value=False),