AI-Powered Knowledge Vault Generator For Obsidian
Give Mesh A Topic. Get Back A Second Brain.
Most AI Tools Answer Questions. Mesh Builds Knowledge.
Give Mesh A Topic And It Generates An Entire Obsidian Vault: A Structured Collection of Markdown Notes Organized Into Folders, Interlinked With Wiki-Links, And Enriched With Metadata, Diagrams, And Navigation Aids. The Result Isn't A Single Document. It's A Complete Knowledge System, Ready To Explore And Expand.
A Topic Like Machine Learning Becomes A Navigable Vault With Dedicated Notes On Every Sub-Concept: Linear Algebra, Probability, Supervised Learning, Neural Networks, Regression, Classification. Each Note Is Cross-Referenced With The Others, Tagged, And Formatted Natively For Obsidian.
Recursive Generation: Mesh Breaks A Topic Into A Full Concept Hierarchy And Generates A Dedicated Note For Every Node, No Matter How Deep.
Flexible Depth: Choose Between Three Tiers To Match Your Goal:
| Depth | Notes | Best For |
|---|---|---|
| Concise | ~30 | Quick Overview or Topic Primer |
| Standard | ~80 | Solid, Well-Rounded Coverage |
| Deep | ~150 | Exhaustive Reference Vault |
Any AI Model: Mesh Routes Through OpenRouter, Giving You Access To Claude, GPT-4, Gemini, DeepSeek, And Hundreds of Other Models From A Single API Key. Pick The Model That Fits Your Budget And Quality Bar.
Custom Instructions: Append Your Own Instructions To Every Note Prompt. Focus On Practical Examples, A Specific Language, A Teaching Style, or Any Other Constraint. Mesh Also Picks Up An INSTRUCTIONS.md File From An Existing Vault Automatically.
Obsidian-Native Output: Every Note Ships With Frontmatter, Wiki-Links, Tags, Aliases, And Dataview-Compatible Metadata Out of The Box.
Vault Navigation Files: Mesh Auto-Generates A Map of Content, Glossary, And Learning Path For The Entire Vault.
Resumable Generation: If Generation Is Interrupted, Mesh Picks Up Exactly Where It Left Off On The Next Run.
Mermaid Diagrams: Relevant Notes Include Diagrams: Flowcharts, Mind Maps, Dependency Graphs, And More.
- Node.js 18 or Later
- An OpenRouter API Key
- Obsidian (To Open And Explore The Generated Vault)
# Clone The Repository
git clone https://github.com/your-username/mesh.git
cd mesh
# Install Dependencies
npm install
# Build
npm run build
# Link Globally (Optional, Lets You Run `mesh` From Anywhere)
npm linkmeshMesh Walks You Through Setup In A Single Interactive Session:
- Enter A Topic: Anything From Quantum Computing To Renaissance Art
- Paste Your OpenRouter API Key: Stored Only In Memory For The Session
- Pick A Model: Browse The Full OpenRouter Catalog With Live Pricing
- Configure The Vault: Set An Output Path, Choose Depth, And Optionally Add Custom Instructions
- Review The Cost Estimate: Confirm Before Any Generation Begins
- Watch It Build: Mesh Generates Your Vault Note By Note With A Live Progress Display
When It Finishes, Open The Output Folder As A Vault In Obsidian.
meshnpm run devnode dist/main.jsMesh Is Configured Interactively. There Are No Config Files To Edit Before You Start. Every Setting Is Prompted During The Session:
| Setting | Description | Default |
|---|---|---|
| Output Path | Directory Where The Vault Folder Will Be Created | ./vault |
| Depth | How Many Notes To Generate (Concise / Standard / Deep) |
Standard |
| Custom Instructions | Extra Instructions Appended To Every Note Prompt | None |
If An INSTRUCTIONS.md File Exists Inside The Target Vault Folder, Mesh Detects It Automatically And Uses Its Contents As Custom Instructions, No Prompt Needed. This Is Useful For Re-Running Generation On An Existing Vault With A Consistent Style.
Mesh Connects To The Full OpenRouter Model Catalog. Any Text Generation Model Available On OpenRouter Can Be Used. A Few Well-Suited Choices:
| Model | Price (Blended) | Notes |
|---|---|---|
DeepSeek/DeepSeek-r1 |
~$0.70 / 1m Tokens | Best Value For Large Vaults |
Anthropic/Claude-Sonnet-4-5 |
~$4.50 / 1m Tokens | Strong Quality / Cost Balance |
OpenAI/GPT-4.1 |
~$4.00 / 1m Tokens | Reliable And Consistent |
Google/Gemini-2.5-Pro |
~$5.00 / 1m Tokens | Long Context, Detailed Notes |
Anthropic/Claude-Opus-4 |
~$22.50 / 1m Tokens | Highest Quality Output |
Prices Are Estimates. See OpenRouter pricing For Current Rates.
- Local Model Support (Ollama, LM Studio)
- Web Research And Wikipedia Enrichment
- Automatic Citations And References
- Anki Sync And Quiz Generation
- Image Generation For Visual Notes
- Export As ZIP, HTML, PDF, Or JSON
- Web Dashboard And Desktop Application
- Cloud Vault Synchronization
Contributions Are Welcome. The Highest-Value Areas To Contribute Are:
- Prompt Improvements: Better Note Structure, Richer Content, Improved Diagrams
- Writing Style Templates: New Styles Beyond The Built-In Set
- Export Formats: ZIP, HTML, PDF, JSON, And Beyond
- Provider Integrations: Direct Connections To Anthropic, OpenAI, Ollama, etc.
Please Open An Issue Before Starting Any Large Change So We Can Discuss The Approach First.
# Fork And Clone
git clone https://github.com/your-username/mesh.git
# Install And Build
npm install && npm run build
# Run In Dev Mode (No Build Step Needed)
npm run devMIT. Free To Use, Modify, And Distribute.
Mesh: Generate Knowledge. Build Connections. Learn Anything.