START HERE / CORE

Welcome to Smart Connections

Bring earlier work back into view from the note you are writing.

Preview one source. Keep only what helps.

Use the arrows or tap to continue at your pace.

The first useful workflow needs no search query or prior links.
Open guide

FIRST USE / 1 OF 7

Start with meaningful text

Open a project, meeting, draft, research, or decision note.

Use the work already in progress. An empty test note gives little to compare.

Example: Landing Page Messaging is the note that owns the work.
Start from a note

FIRST USE / 2 OF 7

Only if it is not ready

If prompted, select Load Smart Environment.

Continue when the status says Smart Environment ready or Ready.

Core retrieval uses local embeddings by default. No API key is needed.

Already seeing results? Continue to the next step.
Check readiness

FIRST USE / 3 OF 7

Open the Connections view

Use the Command Palette command for your edition:

Core: Smart Connections: Open: Connections view

Pro: Smart Connections Pro: Open: Connections view

Pro is pictured. Core uses the same command suffix. Leave auto-refresh running.
Open view steps

FIRST USE / 4 OF 7

Preview before you trust it

Expand one promising row to read the source.

Treat the score as review order, not confidence or quality.

Open the source when the excerpt is not enough.

An expanded result exposes the source before you decide to use it.
Read result rows

FIRST USE / 5 OF 7

Open a source. Keep your place.

Before opening a result, select Pause auto-refresh to keep the starting target.

Check the editor and target names. They should now differ.

Resume when results should follow the active note again.

1: Open source. 2: Fixed target. 3: Resume control. 4: Ranked rows.
Keep the anchor

FIRST USE / 6 OF 7

Use one reviewed source

Return to the note that owns the work.

Write the useful conclusion, keep the source open, or drag it in when the relationship should become a link.

The link is optional. Progress in the original work is the goal.

The composite shows one way to make a reviewed relationship durable. Linking is not required.
Use the result

FIRST USE / 7 OF 7

You know it worked when...

You can name the source, what it contributed, and what should change.

Here, Beta Reader Feedback argues for concrete language.

Use that evidence to revise the draft, or reject it when it does not fit.

A populated list is not the finish line. The value is what you do with a source.
Use the result

CORE LOOP COMPLETE

Use it when you lose the thread

When you think, "I wrote this somewhere," let the note in view surface candidates.

Inspect only enough context to continue the work, then apply what helps.

Stop when the original note, decision, or next action advances. Everything after this is optional.

Repeat only when the current work needs recovered context. No cleanup project is required.
Make it routine

RECOVERY / ONLY IF STUCK

Empty or stale results?

Try a note with more meaningful text.

Check that auto-refresh is running.

After major edits or settings changes, use Refresh connections.

Try the smallest recovery first, then test the same note again.
Fix empty results

RECOVERY / ONE NOTE

One note still missing?

Keep the missing note active.

Select Inspect active note from the Smart Environment status menu.

Check eligibility and current source or block state before changing ranking.

Check this note, not a generic Milestones screen.
Inspect the note

RECOVERY / SEVERAL NOTES

Check eligible coverage

Choose Show stats from the status menu, or Environment stats from the status view.

Compare Eligible, Current embeddings, and Needs embedding.

Finish preparation, then preview a result from the same meaningful note.

Nonzero coverage alone does not mean preparation is complete.
Check coverage

CONTINUE / CORE CONTROLS

Keep the useful. Hide the noise.

Pin a useful reference. Hide a recurring distraction.

Use Copy as list of links when the visible set belongs in a review note.

Unpin All and Unhide All reverse those states.

Copying links is not the same as packaging source contents for AI.
Use list controls

CONTINUE / CORE MINI GRAPH

A map, not new links

Version 4.0 (Graph + List) adds the Core Connections mini graph.

Use it to scan the current candidate neighborhood, then inspect a source.

Its lines do not create links in your notes.

1: Active note. 2: Target. 3: Mini graph. 4: Result list.
Read mini graph guide

CONTINUE / RESULT TYPE

Whole notes or smaller sections?

Sources returns whole-note candidates.

Blocks returns smaller sections when block indexing is available.

Change Connection results type, not Change target -> Blocks.

Start broad. Use Blocks when a long note hides the useful part.
Read Sources vs Blocks

CONTINUE / TUNE AFTER VALUE

Useful, but too much?

Lower the result limit or choose Sources versus Blocks.

Move the sidebar where it fits your workspace.

Connections Pro filters displayed results; Environment exclusions change indexing scope.

Change one layer, then compare the same note again.
Tune in order

CONTINUE / CORE FOOTER

Review at the end of a note

Enable Footer connections, then scroll to the note ending.

Expand one result before opening or linking it.

Footer has its own component choice. List only keeps it compact.

Core, also included with Pro. Desktop shown; mobile controls can differ.
Use Footer connections

ANOTHER START / SMART LOOKUP

Starting from a question?

Use Smart Lookup when a typed question or remembered idea should determine the results.

Keep Connections for the note in view.

Use native Obsidian search for exact words, filenames, or tags.

Different starting point, not another required setup step.
Start with Lookup

OPTIONAL / CONNECTIONS PRO

Need context for one passage?

Run Smart Connections Pro: Toggle: Inline connections.

Hover a marker to see related results for that passage.

The line range identifies the anchor. The marker is not a saved link.

A different placement for discovery, not a prerequisite for the Core loop.
Use Inline connections

OPTIONAL / CONNECTIONS PRO

Inspect without switching notes

On desktop, hold Cmd/Ctrl while hovering an Inline result to use Hover Preview.

Inspect the source before changing context.

Click when you need to open the note.

The image shows the result popover; Hover Preview is the next action.
Preview Inline results

OPTIONAL / CONNECTIONS PRO

One block, more room

Select the popover header with Connections and its line range.

The main Connections view opens the full result set for that block.

Use it when the small popover is not enough.

Use the header for the full list. Click a result to open its source.
Open the full list

OPTIONAL / CONNECTIONS PRO

Rank a collection in Bases

With a .base file active, run Smart Connections Pro: Add: Connections score bases column.

Choose a reference note. Filter the Base, then sort by score.

Treat values as relative within that Base and reference.

Missing command? Check Pro is active and the Base has a supported note-file column.
Add a score column

OPTIONAL / CONNECTIONS PRO

Put related links beside each row

Use file.list_connections() in a Bases formula column.

It returns related links with connection scores.

Use score_connection for a numeric value to sort or filter.

Open and review a source before using it.

file.list_connections()
Formula example, not a new screenshot of a completed Base.
Use Bases formulas

OPTIONAL / CONNECTIONS PRO

Right scope, wrong order?

Fix candidate scope and limits first.

Scoring sets the primary relevance value. Ranking changes the final order.

Change one control, refresh the same target, and keep it only when useful results improve.

Advanced controls are for a repeated limitation, not for first-use readiness.
Tune scoring and rank

ANOTHER JOB / SMART GRAPH PRO

Need a broader visual scope?

Use Smart Graph to explore a topic as a visual source set.

It is a separate Pro plugin, not the Core Connections mini graph.

Review selected sources before using them or sending them onward.

Separate Graph example. It is not a recording of a Connections handoff.
Explore Smart Graph

ANOTHER JOB / SMART CONTEXT

Package sources only when needed

Choose Send to Smart Context to open a reviewable set of Connections results.

Confirm the source identities. Remove what does not belong.

Copy only after review. Sending to Context does not send the set to an AI provider.

Install Smart Context

Requires Smart Context. Complete any Store reload action, then return here.
Build reviewed context

WHAT DOES THE WORK NEED NEXT?

Question or source set?

Smart Lookup: start from a question or remembered idea. It returns sources to inspect, not a written answer.

Smart Context: when another tool needs a bounded set of reviewed notes, build and inspect the package before sending it.

Smart Context getting started

Choose from the starting state: question -> Lookup; reviewed source set -> Context.
Start with Smart Lookup

REUSE / CONTINUITY

Repeating the request or conversation?

Smart Templates: when a useful request shape repeats, combine reviewed context, reusable structure, and the instruction unique to this run. Current Templates ends at Copy prompt.

Smart Chat: when a conversation belongs with a note, keep the provider thread attached so you can return to the same work without rebuilding where it belongs.

Smart Chat getting started

SMART TEMPLATES

reviewed context + reusable structure + this task's instruction -> Copy prompt

SMART CHAT

owning note + provider thread -> visible response -> return to the same conversation later

Reuse only what reduces reconstruction. The current work still owns acceptance and the result.
Use Smart Templates

EXPLORE / REVIEW / ACT

Need a different kind of next step?

Smart Graph: explore how several notes relate, then open or select the sources that matter.

Smart Dedupe: compare likely overlap before deciding to keep, clarify, consolidate, archive, or ignore.

Connect Pro: let a trusted client invoke bounded vault actions; use the review path for consequential proposed changes.

Graph | Dedupe | Connect Pro

DEDUPE

candidate pair -> inspect both -> human decision

CONNECT PRO

bounded request -> proposal/review -> apply or reject

Do not enable more plugins because they exist. Choose the smallest route that completes the actual job.
Choose a Pro workflow

HELP / MATCH THE SYMPTOM

Still blocked?

For missing results, check note eligibility and preparation.

For controls or editions, use the current documentation.

After the fix, return to the same note and preview one source.

Meaningful note
Ready environment
One reviewed result
A recovery is complete when the original note becomes useful again.
Open Connections FAQ

BACK TO THE WORK

Let one source help what comes next

Open a meaningful note. Open Connections.

Preview one related source, then decide what to use or ignore.

The note, decision, or next action is the destination - not this slideshow. Add another plugin only when the next job needs it.

Explore Smart Loop

The two remaining pages are optional videos. No form or upgrade is required.
Repeat the core loop

OPTIONAL VIDEO / 01:56-09:04

Watch related notes appear

See meaningful text change which related notes surface.

This older demonstration explains the idea; use this guide for current commands and controls.

Preserved segment: 116-544 seconds. Play when useful; continue when done.
Watch the segment

OPTIONAL VIDEO / FULL WALKTHROUGH

Watch Wanderloots' walkthrough

See the broader workflow in action.

Some interface and plugin details have changed. Follow the current guide when they differ.

Read the current guide

Original walkthrough retained as the final story page.
Watch on YouTube