obsidian

Use search_files with target "content" and a regex pattern, adding file_glob "*.md" to restrict matches to markdown notes. For filename searches, use target "files" with a filename pattern under the resolved vault path.

Use write_file with the resolved absolute path and full markdown content. Link related notes using Obsidian's [[Note Name]] syntax inside the content so connections appear in the vault graph.

The vault path comes from the OBSIDIAN_VAULT_PATH environment variable, typically set in ~/.hermes/.env. If unset, it falls back to ~/Documents/Obsidian Vault. Always resolve to a concrete absolute path before calling file tools.

File tools do not expand shell variables, so paths containing $OBSIDIAN_VAULT_PATH fail. Resolve the variable first, optionally via terminal, then pass the concrete absolute path to read_file, write_file, patch, or search_files.

Read the note first, then use patch with a stable anchor such as an existing heading, replacing the anchor with the anchor plus new content. For appends with no stable context, a terminal command is acceptable.