Skip to content

Official Smart Plugins site Independent plugins for Obsidian.

On this page

Getting started with Smart Context

Copy a note from your vault into the AI tool you use.

When to use Smart Context

Use Smart Context to give an AI tool selected notes or sections from your vault.

Before you start

Copy the current note

Edition: Core and Pro. Use the path for your installed edition.

1. Open the note you want to copy

Choose the note whose content you want to use. If the note embeds another note, that embedded content can be included at Depth 0. Ordinary links are not followed until you choose a wider depth.

2. Open the current-note copy controls

Use the path for your installed edition:

Smart Context current-note menu with link-depth choices

The Pro menu begins with Choose link depth... and then lists direct depth choices. Use the direct Depth 0 path for this first result.

3. Copy at Depth 0

Copy context chooser with current note, outlinks, and backlinks depths

Use the path that matches the interface in front of you:

Use outlinks or backlinks only when the current note is not enough.

4. Paste and inspect the result

Paste into a clean note or composer. With the default structured output, confirm that:

When you use a different output template, check the equivalent source names, paths, and content in that format.

The copy notice reports the number of files and characters.

Context confirms copy completion and shows the copied-file and character counts.

If nothing pastes, keep the source note active. Repeat the path for your edition. In Core, selecting the depth row copies immediately. In Pro, make sure that you choose Copy text from the depth submenu. Paste into a plain note first. This separates a clipboard problem from a destination-specific paste problem.

See Start from the current note for depth behavior, output choices, and recovery.

When to use Depth 1

Use Depth 1 to include linked notes alongside the current note and its embeds.

After pasting, check which linked notes were included. Return to Depth 0 to omit ordinary linked notes, or use Builder to select specific sources.

When to open Context Builder

Use Builder to select sections, combine sources, or save a named context. Core supports reviewed note and block selection, named contexts, and codeblocks. Pro adds dynamic folder rules and selection of currently matching tagged notes, exclusions and heading filters, media, external files and repositories, and richer Bases workflows.

From the Command Palette, run the Builder command for your installed edition:

In either edition, you can also choose the Smart Context: Open Builder ribbon action.

Context Builder reviewing the Newsletter Launch source tree

Before copying, check the source count, token estimate, and source tree. In Pro, also check the Rules count. Search results remain suggestions until you add them.

Core Builder provides Notes, Sections, and Named contexts. Pro adds Media, Folders, Linked notes, Similar notes, Tags, and External files. Choose Notes for a whole note or Sections for a specific passage.

Continue with the Builder guide.

Check Rules for dynamic sources

Edition: Pro.

Dynamic folder rules and named-context inclusions can expand into several items; Tags adds current matches as direct sources without following later tag membership changes. Open the rule-count control before copying.

Context Builder Rules view with the Template exclusion enabled

An Include rule contributes sources. An Exclude rule keeps matching material out. A global heading exclusion can be switched off for one context without deleting the global rule. Recheck the compiled output after any override.

Add a folder rule and copy its sources

  1. In Builder, choose Folders. Use the folder suggestion's modifier action shown in the search footer to add a dynamic folder rule.
  2. Open the rule-count control. Check the resolved folder sources and any existing exclusions. You do not need to change a shared rule for this exercise.
  3. Select Copy text and paste into an empty note.
  4. Check that the expected file paths appear and excluded sections are absent.

Example copied Context output with the Template section excluded and surrounding content retained

Example output with the Template section excluded.

Continue with Inspect and recover Context rules.

Reopen a named context before reuse

Named contexts dashboard with Newsletter Launch Evidence actions open

The dashboard shows saved names and item counts. Open the named context. Recheck its resolved sources and estimate before copying. In Pro, also recheck its Rules. Copy with Template appears only when Smart Templates is installed and the resolved package contains items.

See Save and reuse named contexts.

Find the other Context surfaces

Tool How to open it Ready when... Learn more
Current-note copy In Core, run Smart Context: Copy current text to clipboard (choose link depth). In Pro, choose Smart Context: Copy current. The chosen depth is visible and the pasted package matches it. Copy the current note
Context Builder In Core, run Smart Context: Open new context in builder. In Pro, run Smart Context Pro: Open new context in builder. The intended sources and estimate are reviewable. In Pro, Rules are also reviewable. Build a reviewed package
Source chooser In Core Builder, choose Notes, Sections, or Named contexts. Pro adds the other six source modes. The intended mode is highlighted and its candidates are visible. Choose a source mode
Context rules In Pro, choose the rule-count control beside the source and token summary. Include, exclude, and package-specific override behavior is clear. Inspect Rules
Named contexts Name a reviewed package in Builder. Reopen it through the dashboard or Named contexts under Add sources. The saved name, source count, and package actions are visible. Save and reuse named contexts
Smart Context codeblock Run Smart Context: Insert codeblock in Core or Smart Context Pro: Insert codeblock in Pro. Compare source and Reading view. The fenced ctx manifest and rendered tree describe the same sources. Use a codeblock
Media In Pro Builder, choose Media. The reviewed images or PDF pages also appear after paste. Copy media

If the answer is generic

Clarify the request, remove unrelated material, and add missing sources:

  1. Put the real question and desired outcome in the task-owning note.
  2. Remove unrelated or stale sources.
  3. Replace a long note with one relevant Section.
  4. Check whether a folder or tag added unexpected children.
  5. Ask the model to name missing evidence instead of guessing.

For symptom-specific recovery, use Smart Context FAQs.

What done looks like

Check Done when...
Source review The source tree contains the intended notes and sections, with the chosen exclusions applied.
Product result The pasted content matches the selected depth or reviewed Builder package.