diff --git a/.env.example b/.env.example
index 850282e..231f4a3 100644
--- a/.env.example
+++ b/.env.example
@@ -8,6 +8,20 @@
 # Path to your SSH private key for Gitea authentication
 # GITEA_SSH_KEY_PATH=~/.ssh/id_ed25519_nexus
 
+# =============================================================================
+# OBSIDIAN INTEGRATION
+# =============================================================================
+# Obsidian API key for agent integration with your notes vault
+# Get your API key from Obsidian → Settings → Community Plugins → API
+# Enables agents to read/write project notes, knowledge base updates
+OBSIDIAN_API_KEY=your_obsidian_api_key_here
+
+# Obsidian vault path (optional - for local file access)
+# OBSIDIAN_VAULT_PATH=~/Documents/ObsidianVault
+
+# Obsidian note template for project documentation
+# OBSIDIAN_PROJECT_TEMPLATE=templates/project-template.md
+
 # =============================================================================
 # APPLICATION MODE
 # =============================================================================