obsidian-gemini-helper

Gemini Helper for Obsidian is a free, open-source plugin that integrates Google Gemini into your note-taking workflow. It provides streaming AI chat with vault operations, allowing you to read, create, and edit notes directly through conversation. The plugin includes a visual workflow builder with 24 node types for automating multi-step tasks, RAG (Retrieval-Augmented Generation) for intelligent semantic search across your vault, and support for MCP tools. You can attach files, use slash commands for reusable prompts, set usage tracking to monitor API costs, and limit AI folder access for privacy. Works with free or paid Gemini API keys, with advanced features like image generation available on paid plans.

[{"step":"Install and Configure","description":"Ensure the obsidian-gemini-helper is installed in your Obsidian vault. Configure the plugin to connect to your Gemini API key or CLI tools. Set the vault path in the plugin settings if it’s not auto-detected.","tip":"Use the command `obsidian-gemini-helper --setup` to initialize the plugin with default configurations. Verify the connection by running `obsidian-gemini-helper --test` to ensure the API or CLI tools are responding."},{"step":"Define Your Task or Query","description":"Use the prompt template to craft a specific request. Replace [PLACEHOLDERS] with your vault path, task, and priorities. For example, `Use the obsidian-gemini-helper to automate client onboarding tasks in my vault at ~/vaults/business-ops. Focus on high-priority clients and prioritize due dates within the next 7 days.`","tip":"Be specific about the area of focus (e.g., `client onboarding`, `project management`, `knowledge retrieval`). Include criteria like due dates, tags, or file types to narrow the scope."},{"step":"Execute the Command","description":"Run the command in your terminal or Obsidian command palette. For CLI users, use `obsidian-gemini-helper --task \"[YOUR_TASK]\"`. For Obsidian users, open the command palette (Ctrl/Cmd + P) and select `Obsidian Gemini Helper: Execute Task`.","tip":"For complex tasks, break them into smaller commands. For example, first run a semantic search to gather context, then automate specific workflows based on the results."},{"step":"Review and Refine","description":"Check the output in your Obsidian vault. Review the generated files, tables, or notes. Use the provided backlinks and file links to verify the changes integrate smoothly with your existing knowledge base.","tip":"If the output isn’t as expected, adjust your prompt by adding more specific criteria or re-running the command with refined parameters. For example, add `only include tasks tagged #high-priority` to filter results."},{"step":"Integrate into Workflow","description":"Use the generated content as a starting point for your next actions. For example, copy the draft email into your email client, or use the priority matrix to assign tasks in your project management tool.","tip":"Save frequently used prompts as templates in your vault (e.g., `[[Automation Templates/Client Onboarding]]`) to reuse them later with minimal adjustments."}]