LinkPilot

LinkPilot is an Obsidian desktop plugin for people who want to actively shape their backlink network instead of just browsing it.

It focuses on five workflows:

1. Scan the whole vault and generate measurable backlink metrics.
2. Send that report to an OpenAI-compatible model to get concrete linking advice and a reusable "knowledge style persona".
3. Quickly summon link suggestions for the current note.
4. Use PostgreSQL + pgvector for vector storage and combine it with local BM25 retrieval.
5. Present everything inside an Obsidian-native dashboard that is ready to evolve into a community plugin release.

Current feature set

• Vault-wide backlink analysis with:
  • resolved link count
  • unresolved link count
  • orphan note count
  • backlink coverage
  • link saturation
  • reciprocal link ratio
  • hub concentration
  • network health score
• Optional CLI-assisted scanning through ripgrep
• AI-generated action plan and persona profile from an OpenAI-compatible endpoint
• Current-note suggestion modal for fast wikilink insertion
• PostgreSQL + pgvector embedding sync
• Hybrid retrieval that combines:
  • local BM25
  • pgvector semantic search
  • heuristic boosts from tags, folder context, and backlink strength
• Right-side dashboard view inside Obsidian

Getting started

1. Open the LinkPilot settings tab in Obsidian.
2. Run Analyze vault backlinks and metrics to generate a local backlink report.
3. Optionally configure an OpenAI-compatible model endpoint to generate AI guidance and a reusable linking persona.
4. Optionally configure PostgreSQL + pgvector if you want semantic retrieval blended with BM25.
5. Run Suggest wikilinks for current note inside any note to insert recommended double links quickly.

LinkPilot works without any external service for the base backlink scan. If ripgrep isn't available, it automatically falls back to Obsidian's native metadata scan.

Privacy and external services

• No hardcoded credentials are included in this repository.
• No telemetry or analytics are built into the plugin.
• LLM calls are opt-in and only sent to the user-configured OpenAI-compatible endpoint.
• PostgreSQL + pgvector sync is opt-in and only connects to the user-configured database.
• API keys and database credentials are stored in Obsidian's local plugin data, not in git.

Development

npm install
npm run build

For live development:

npm run dev

Recommended local setup

Use a symlink from your Obsidian vault to this repository's build output directory:

ln -s "$(pwd)" /path/to/your-vault/.obsidian/plugins/linkpilot

Then enable LinkPilot from Obsidian's community plugin settings.

Community plugin release notes

This repository is structured for the Obsidian community plugin review flow:

• stable plugin ID in manifest.json
• standalone GitHub repository
• desktop-only flag enabled
• release assets published through GitHub Releases
• explicit disclosure of optional network and database usage

Acknowledgements

LinkPilot was originally scaffolded from the official Obsidian sample plugin and Obsidian ESLint template, then extended into a standalone backlink analysis workflow.