Master of Knowledge

Turn your Obsidian vault into a Gemini File Search and Agent-powered knowledge workspace. Ask your notes, inspect sources, run Antigravity/AGY jobs from inside Obsidian, and apply the result back into notes.

Features

Master Dashboard

• Chat, Agent, Budget, and _omg workspace tabs in one Obsidian sidebar
• Shared Sources, Apply, and Copy actions for both Gemini answers and Agent results
• Agent results can be saved into the _omg workspace without touching source notes

Folder-based Auto-Sync

• Automatically sync markdown files from one or more designated folders (including subfolders) to Gemini
• File changes (create/modify/delete/rename) are tracked and synced in real-time
• Content-based change detection using SHA-256 hashing to minimize API calls

Chat with Your Notes (RAG)

• Dedicated chat interface in the right sidebar
• AI answers are grounded in your synced notes
• Citations: Clickable links to source notes mentioned in responses
• Chat history maintained during session

Agent Workspace

• Run Antigravity/AGY from the dashboard using the Agent tab
• Active vault context, selected sync folders, trust mode, and _omg workspace are passed to the agent prompt
• Agent output uses the same Apply, Copy, Create Note, Select Note, and Save to _omg actions as chat

Budget Guard

• Monthly USD budget setting
• Dashboard budget meter for Gemini API chat usage
• Agent/Antigravity runs are not counted because they do not use the plugin Gemini API key
• Budget totals are reconciled from _omg/logs/budget-YYYY-MM.jsonl

Smart Status Management

• Status Bar: Shows sync status at a glance
• Settings Dashboard: View total synced files, pending uploads, and errors
• Debounced sync to reduce API calls during rapid edits

File Search Upload Diagnostics

• Separate diagnostic for Gemini File Search sync
• Checks model access, File Search store access, Files API upload, and File Search import
• Helps distinguish "API key works for chat" from "API key can upload/index notes"
• Useful when Sync Dashboard only shows error files or when a new AQ... API key returns upload/import 403

Installation

From Source

1. Clone this repository into your vault's .obsidian/plugins/ directory
2. Run npm install to install dependencies
3. Run npm run build to build the plugin
4. Enable "Master of Knowledge" in Obsidian's Community Plugins settings

Manual

1. Download the latest release (main.js, manifest.json, styles.css)
2. Create a folder .obsidian/plugins/master-of-knowledge in your vault
3. Copy the downloaded files into the folder
4. Enable the plugin in Obsidian settings

Note: version 2.0.0 changes the plugin ID to master-of-knowledge for official Obsidian Community Plugin submission compatibility. If you installed an older BRAT build under obsidian-gemini-sync, install this release into the new folder name and copy your settings if needed.

Setup

1. Get a Gemini API Key

   • Go to Google AI Studio
   • Create a new API key
   • Copy the key

2. Configure the Plugin

   • Open Obsidian Settings > Master of Knowledge
   • Paste your API key and click "Verify"
   • If you plan to sync notes, click "Diagnose File Search" to confirm upload/import access
   • Select one or more folders to sync (e.g., "Notes" and "Knowledge")
   • Click "Sync Now" for initial synchronization

3. Start Chatting

   • Click the chat icon in the left ribbon (or use the command palette)
   • Ask questions about your notes!

Usage

Chat Commands

• Open Dashboard: Click the ribbon icon or use Ctrl/Cmd + P > "Open Master of Knowledge"
• Clear Chat: Click the trash icon in the chat header
• Force Sync: Settings > Actions > "Sync Now"
• Run Agent: Open the Agent tab and enter an Antigravity/AGY task

Example Prompts

• "What are the main topics in my notes?"
• "Summarize my notes about [topic]"
• "Find connections between [topic A] and [topic B]"
• "What did I write about [specific subject]?"

Configuration Options

Important Notes

API Key Security

• Your API key is stored locally in the plugin's data file
• Never share your data.json file as it contains your API key

API Key Compatibility

• The normal "Verify" button checks whether the key can call Gemini model endpoints.
• Sync uses additional File Search and Files API endpoints.
• If "Verify" passes but every synced file becomes an error, run Diagnose File Search in settings.
• Some users have reported 403 failures with newer AQ... Google AI Studio keys on File Search upload/import flows. If the diagnostic fails at files_upload or import_file, try a fresh Google Cloud project/key or an older AIza... key if you already have one.
• Related references: Gemini API key docs, Gemini File Search docs, AQ key File Search discussion

Cost Considerations

• Google Gemini API has usage-based pricing
• Free tier available but heavy usage may incur costs
• Monitor your usage in Google Cloud Console

Limitations

• Desktop only (Mac/Windows)
• Markdown files only
• Large vaults may take time for initial sync
• Context length limits may affect very large notes

Troubleshooting

"API key is invalid" / Verify fails on models

• Create a fresh key at Google AI Studio
• Keys commonly start with AIza
• Ensure the Generative Language API is enabled for the project

Verify succeeds but Sync fails / importFile HTTP 401 UNAUTHENTICATED (v2.0.37+)

1. Restricted keys: Set Application restrictions = None (HTTP referrer/IP restrictions often break Obsidian desktop for File Search even when /models works).
2. Stale store after key change: After switching keys/projects, click Reset store (or re-paste the key — store binding is cleared) then Sync Now.
3. Multi-step Verify: Verify probes both /models and /fileSearchStores. If models pass but File Search fails, the notice explains File Search denial.
4. Upload path: Sync prefers uploadToFileSearchStore, with fallback to Files API + importFile.
5. Still stuck? Run Diagnose File Search for a stage-by-stage report.

"API key is invalid" (legacy note)

• Verify your API key in Google AI Studio
• Make sure the Gemini API is enabled in your Google Cloud project

"Sync not working"

• Check if the sync folder is correctly selected
• Look at the status dashboard for error messages
• Try "Force Sync" in settings

"Verify passes, but every file is an error"

• Open Obsidian Settings > Master of Knowledge
• Click Diagnose File Search
• Read the failed stage:
  • models: the API key itself is not valid for Gemini model calls
  • file_search_store: the key cannot create/list File Search stores
  • files_upload: the key cannot upload files to the Gemini Files API
  • import_file: the file uploaded, but File Search import failed
• If the key starts with AQ and the failure is 403 at upload/import, this is likely a Gemini File Search key compatibility issue rather than a folder-selection issue.

"Chat not responding"

• Verify your API key is still valid
• Check your internet connection
• Look for errors in the developer console (Ctrl+Shift+I)

Development

# Install dependencies
npm install

# Development mode (watch)
npm run dev

# Production build
npm run build

License

MIT

Credits

• Built with Obsidian Plugin API
• Powered by Google Gemini API