brianpetro959k downloadsAI link discovery copilot. See related notes as you write. Lookup using semantic (vector) search across your vault. Zero-setup local model for embeddings, no API keys, private.
Save time linking, tagging, and organizing: Smart Connections finds relevant notes so you don't have to!
I just stumbled across a forgotten 20-page Google Doc I poured my heart into months ago, and the rush of lost momentum hit me like a punch.
— Brian (December 2022)
[!QUESTION] Is this you? You're an Obsidian power‑user, researcher, writer, or lifelong learner with hundreds or thousands of notes. You capture ideas quickly, but later struggle to find and connect them when it matters most.
[!WARNING] The Problem
Valuable insights disappear in a sea of unlinked notes, forcing endless scrolling, rereading, and duplicated work. Time you wanted for creativity leaks away into manual organization.

[!NOTE] What Smart Connections does
Smart Connections uses local embeddings and your Smart Environment to surface notes that are semantically related to what you are working on right now. Start with the overview, then jump into the Connections view guide, Lookup guide, and settings guide as your workflow gets deeper.
✔️ Zero-setup: ships with a local embedding model that just works
🔐 Private and offline by default
📲 Works on mobile devices
📦 Ultra-lightweight bundle with minimal third party dependencies
🔍 Streamlined codebase with minimal/no dependencies can be audited >3× faster than comparable AI plugins
🌐 Source available core, local-first data
⚔️ Mission driven, user aligned, community supported
[!SUCCESS] What success looks like
With Smart Connections running, ideas resurface when you need them, writing flows faster, and your note taking system finally feels like the trusted second brain you imagined.
[!FAILURE] The Cost of Doing Nothing Stay stuck sifting through files, forgetting past research, and wasting precious creative energy on housekeeping instead of creation. Without help, your vault keeps growing into a maze. You keep redoing work you already did once, and important ideas stay buried.
See Smart Connections (and how it pairs with Smart Chat) in action:
Watch on YouTube
Access the Getting Started guide from Smart Connections settings.
Watch the feature walkthrough slideshow or read the Getting Started guide to see how Smart Connections fits into your workflow, including Connections view, Lookup view, inline Pro features, and Smart Environment settings.
Core docs
| Path | Use it for |
|---|---|
| Smart Connections overview | Understand what Smart Connections does end-to-end. |
| Getting Started | Install and reach your first successful workflow fast. |
| Connections list feature | Learn the scan -> confirm -> act workflow for related notes. |
| Lookup view | Run semantic searches across your vault on demand. |
| Settings guide | Configure indexing, filters, ranking, and UI defaults. |
Pro surfaces
| Path | Use it for |
|---|---|
| Inline connections (Pro) | Trigger note suggestions while writing in the editor. |
| Bases integration (Pro) | Blend semantic context with Obsidian Bases workflows. |
| Pro plugins overview | Compare active Pro plugin capabilities and plans. |
Pick a path
| If you want to... | Start here |
|---|---|
| Reach your first win fast | Getting Started |
| Understand the core daily loop | Connections list feature |
| Search by meaning across the vault | Lookup view |
| Tune results for a large or specialized vault | Settings guide |
| Explore advanced workflows | Pro plugins overview |
Surface relationships between notes with zero-setup.
[!TLDR] 3 step plan
- Install and enable Smart Connections from Obsidian Community plugins.
- Keep writing. The built in local model automatically indexes your vault.
- Open the Connections view to see relevant notes and drag links directly into what you are working on.
Find Smart Connections in the Obsidian Community plugins.
A local model starts creating embeddings right away. No extra apps, no CLI tools, and no API key required.
Open it from the left ribbon (Connections icon) or from the command palette by running the Open: Connection view command.

Connections view results update automatically when you change notes. The name of the current note appears at the bottom left of the Connections view.

[!NOTE] Semantic search
Semantic queries do not behave like plain text search. A note that contains the exact query text might not appear if it is not actually similar in meaning.

Right click a result to hide it from the list:
Right click any result and use Unhide all to bring hidden items back:
Open it from the ribbon (Lookup icon) or from the command palette by running the Open: Lookup view command.

[!NOTE] Semantic search
Semantic queries do not work like regular search queries. For example, a note containing the exact query text may not be returned in the results.

Open: Random note from connections command from the command palette.Note: the random connection command requires the Connections view to be active.
Smart Connections v4 focuses the core plugin on a simple promise: install, enable, and AI-powered connections just work. Advanced configuration and power-user workflows now live in Pro plugins. Read Introducing Pro Plugins to learn more, then use the Pro plugins overview when you are ready to compare advanced workflows.

Examples of Pro features:
score_connection and list_connections in Obsidian Bases to show similarity columns and related note lists in tables. Connections Pro is part of the Pro plugins family and is available to active project supporters. It is still built on the same source-available Smart Environment. Supporting Pro helps fund development of all Smart Plugins and the free core.
Examples of events you might see:
Objectives of the new Events system:
User-aligned means privacy and local first are design constraints, not optional checkboxes.
Privacy should not be a premium feature. Smart Plugins are private by default!
The Obsidian community opened my eyes to user-aligned software. Smart Connections is built on a set of principles designed to keep power in the hands of individuals, not platforms.
[!INFO] Your guide
Built by Brian, a fellow Obsidian user who felt the same pain, Smart Connections pairs hard won experience with source available AI expertise to lead you from overwhelm to insight.
[!NOTE] Why Smart Connections
Smart Connections started as a personal tool. The Obsidian community turned it into a shared project and helped refine it into something that can actually keep up with real workflows.
Smart Connections exists so you can:
It is not about features for their own sake. It is about empowerment.
Hearing from those who use Smart Connections brings to life the impact it has on individuals' workflows and creativity.
Here's what some of them have to say:
Even more love for Smart Connections 🥰
Smart Chat is no longer bundled inside Smart Connections, as planned in the last major release, it has been moved to its own dedicated plugin. You can now install Smart Chat directly from the Obsidian Community plugins or learn more here.
To keep the Core Smart Connections plugin simple and “just works,” all API‑based model integrations (cloud and local) have moved into Smart Chat Pro, the Pro version of the Smart Chat plugin. This lets advanced model routing and multi‑provider support be maintained sustainably, while the free Smart Plugins stay focused on essential core features that work with third-party interfaces like ChatGPT, Claude and Gemini.
For more about Pro plugins, read Introducing Pro Plugins.
Smart Connections is one piece of a larger ecosystem of local first, user aligned tools. I build Smart Plugins to explore new ideas, ship practical workflows, and keep complexity manageable inside Obsidian. Smart Connections is the piece that handles the space between notes (connections).
Most AI features need continuous maintenance. As providers and APIs change, deeply configurable options require far more support, testing, and refactoring than simple defaults.
Introducing Pro plugins: how the project stays sustainable without compromising the open core. Core Smart Plugins remain free and source available. Pro plugins sit on top of that core, built on the same open Smart Environment. They do not remove the essentials from the free plugins; instead they collect advanced options in one place and fund the work needed to maintain them. Pro plugins (including Connections Pro) are available to all past project supporters. Not yet a supporter? Get Pro plugins here.
Smart Environment is the shared local core that powers Smart Connections, Smart Chat, and the rest of the Smart Ecosystem.
Smart Environment is undergoing major upgrades to better enable local-first AI tooling. If you have joined Community Lean Coffee sessions, you have already seen glimpses of what this future looks like.
In short, Smart Environment aims to be your local-first core: a PKM inspired backend for your personal data that will eventually let you vibe code your own frontend components on top of your notes.
Learn more about Connections Pro.
Quickly assemble many notes into a single prompt or document using context selectors, links, and templates with Smart Context. Want to know how I manage thousands of ChatGPT threads from Obsidian? Start a new thread inside of a note and come back to it later with Smart Chat!
See the currently available Core Smart Plugins.
Together with Smart Environment, Smart Plugins are an experiment in how AI can empower individuals to do extraordinary work without sacrificing privacy to data hungry giants.
[!NOTE] Welcome to our Smart Community 😊 Hey there! I'm 🌴 Brian. I built Smart Connections to help solve my organization problems. My hope is that it can save you from the same chaos!
- How does it feel when you realize you forgot something that was important to you? Why capture more notes if the ideas get lost in oblivion?
- What if you didn't spend so much time organizing? What could you have done with all that lost time spent organizing?
These are the questions I'm trying to answer. Smart Connections is one piece, albeit a corner piece, representing an important first step in exploration of how AI can empower individuals like you and I.
Smart Connections isn't a silver-bullet. But, it is the a key Smart Tool that can empower us to do more!
Smart Connections license (Smart Plugins License): https://smartconnections.app/legal/license/
This repository is source available. You may use, modify, and redistribute the code, with a restriction on general-purpose competing Obsidian offerings. See the license page above for a plain-English summary, scenarios, FAQ, and full text.