An Obsidian plugin that saves web-clipped links into your knowledge base. One command extracts a title and summary using AI, picks the right KB file and section, and inserts a table row.
- Supports Anthropic (Claude), Ollama (local/free), and OpenRouter
- Never files a link into a note the model didn't actually choose
- Creates a new note, named after the subject area, when nothing existing fits — matching the structure of your hand-written notes
- Skips links already filed anywhere in your KB, and tells you which note holds them
- Maintains an auto-generated index of your KB files and sections, never touching your curated notes
- All prompts are customisable via template variables
- Retries transient errors (rate limits, 5xx) with exponential backoff
- Debug mode for inspecting raw LLM responses
- Clip a web page into your Inbox folder, via Obsidian Web Clipper or any other method
- Open the clipped note and run "LinkVault: Process link to KB" from the command palette
- LinkVault extracts a title and summary, then picks a KB note and a section within it
- If the URL is already filed anywhere in your KB, you're told where and nothing is written
- A table row is inserted, and the inbox note is moved to trash (configurable)
If no existing note covers the link, LinkVault creates one named after the subject area rather than filing it somewhere approximate. See Routing for what it does and doesn't guess at.
- Open Settings → Community plugins → Browse
- Search for "LinkVault"
- Click Install, then Enable
Requires Obsidian 1.11.4 or later, which introduced the secret store used for API keys.
- Install BRAT if you haven't already
- In BRAT settings, add
calghar/LinkVault - Enable the plugin
git clone https://github.com/calghar/LinkVault.git
cd LinkVault
npm install
npm run buildCopy main.js, manifest.json, and styles.css into your vault at .obsidian/plugins/linkvault/.
- Open Settings → LinkVault
- Set your KB folder (where your knowledge base notes live)
- Set your Inbox folder (where clipped notes land)
- Choose a provider and enter your API key (not needed for Ollama)
- Click Test connection to verify
- Open a note in your Inbox and run "LinkVault: Process link to KB" from the command palette (Ctrl/Cmd+P)
Each link uses roughly 1000 tokens across the AI calls. With Claude Haiku, that costs fractions of a cent per link.
| Page | Contents |
|---|---|
| Routing | How a note and section are chosen, when new notes are created, duplicate handling |
| KB structure | The file layout LinkVault expects, and the auto-generated index region |
| Web Clipper setup | Clipper template and the frontmatter LinkVault reads |
| Configuration | Providers, every setting, prompt variables |
| Troubleshooting | What each message means |
npm install
npm run dev # watch build
npm test # unit tests
npm run lint
npm run build # typecheck + production bundleSee CONTRIBUTING.md for setup details and guidelines.
See CHANGELOG.md for a list of changes in each release.