Smart Context

Copy the right Obsidian notes into AI without rebuilding context by hand.

Smart Context helps you send AI the notes, links, and source material the work actually needs.

Use it when an answer is weak because the AI did not have the right context, had too much context, or could not tell which notes mattered.

[!NOTE] Best first move Start with the current note at Depth 0. Use Depth 1 only when directly linked notes contain details the AI needs.

Why this works:

• Works out of the box
• Clipboard-first: paste into ChatGPT, Claude, Gemini, Smart Chat, or another AI tool
• Starts small, then expands when the task needs more support
• Uses templates so copied context can include source paths, depth, modified times, and a file tree
• Built for local-first Obsidian workflows

Learn the workflows in depth:

• Getting started guide - copy the current note first, then branch when the work needs it.
• Copy current note - use Depth 0 first and Depth 1 for directly linked support.
• Clipboard workflows - understand modal copy, direct copy, link depth, and export behavior.
• Builder guide - review, trim, save, and reopen context sets.
• Named contexts - save repeated sets.
• Codeblocks - keep a visible context list attached to a note.
• Settings reference - adjust templates and output controls.

Quick start: copy the current note first

Use this when one note already owns the work.

1. Open the note that contains the task, question, draft, decision, meeting, or project brief.
2. Run the current-note copy command.
3. Choose Depth 0 first.
4. Paste into your AI tool.
5. Ask the model to use only the provided context.

Prompt starter:

Use only this context.
First extract the constraints.
Then answer the request.
If something important is missing, list the exact missing note, section, or source instead of guessing.

You know it worked when:

• the copied context is small enough to inspect after paste
• the answer uses details from your note
• or the answer clearly names what is missing

When to use Depth 1

Depth means how many link steps Smart Context includes.

If the answer is generic, do not immediately copy more notes.

First improve the starting note:

• add the actual question
• add What done looks like
• add constraints
• add or fix links to supporting notes
• remove stale or noisy sources

Then copy again at the smallest useful depth.

Learn more in Copy current note as context.

Choose the right way to copy

Copy selected notes or folders

Use file navigator actions when you already know the right scope.

Copy selected notes

Select multiple notes, then right-click and choose Copy selected notes as context.

Copy a folder

Use this when the project already lives in one folder.

Right-click a folder, then choose Copy contents.

Copy folder command

You can also run the folder-copy command from the command palette and assign a hotkey.

[!TIP] Selected-note and folder-copy actions are fast direct-copy flows. They do not open the same link-depth chooser as current-note copy. If the copied context feels too broad, use a smaller selection or open the set in Builder.

Learn more about file nav actions.

Use Builder when the set needs cleanup

Builder is for reviewing, trimming, and saving context before copying.

Use Builder when:

• the right notes are scattered
• one long note only needs a few sections
• the first copy was too large
• you want to save the set for later

How it works:

1. Run Smart Context: Open Selector for New Context.
2. Search for notes or use the available suggestions.
3. Press Enter to add a note.
4. Press Right Arrow to choose blocks or sections when a full note is too much.
5. Remove anything that does not help the task.
6. Copy the set.
7. Add a name only when you expect to reuse it.

Learn more about the Context Builder.

Block selection

Use blocks when one note has useful source material mixed with unrelated text.

Turn Connections results into context

Smart Connections can help you find related notes. Smart Context packages the useful ones.

Workflow:

1. Open the Connections view while working in a note.
2. Send useful results to Smart Context when your version supports it.
3. Remove noise in Builder.
4. Copy the final set.

Save repeated sets as named contexts

Named contexts are saved Smart Context sets you can reopen, copy, and refine later.

Use this rule:

If you rebuild the same set twice, save it as a named context.

Good named context examples:

• project working set
• meeting prep pack
• writing voice pack
• bug triage set
• client handoff pack

Learn more in Named contexts.

Keep context attached to one note with codeblocks

Use a Smart Context codeblock when the note should carry a visible context list.

Learn more in Smart Context codeblocks.

Commands worth hotkeying

Use Obsidian Settings -> Hotkeys -> search Smart Context.

Recommended command families:

• Copy current note with link-depth control - best first workflow.
• Open Selector for New Context - open Builder for a curated set.
• Copy selected notes as context - fast direct export from the file navigator.
• Copy folder contents - fast project-folder snapshot.
• Show named contexts - browse and reopen saved sets.
• Help: Show getting started - open a quick reference inside Obsidian.

Templates

Open Settings -> Community plugins -> Smart Context.

Context templates wrap the full export. The default XML template includes {{FILE_TREE}} so the copied text can show a file tree.

Item templates wrap each note or item. Useful variables include {{KEY}}, {{TIME_AGO}}, and {{LINK_DEPTH}}.

Templates only change copied/exported text. They do not change your vault files.

Learn more in the context settings reference.

Pro: richer sources and finer control

Core Smart Context is for trusted note-based context.

Context Pro helps when the work needs more than plain notes.

• Richer sources: media, PDFs, Bases, repos, and external files on supported Pro workflows.
• Finer control: dynamic groups, exclusions, heading filters, and advanced context workflows on supported Pro workflows.

Use Pro when the assignment needs those sources or controls. Pro is not required for the first win.

Mission-driven

The Obsidian community proved user-aligned software can out-innovate closed platforms. Smart Context follows that spirit: source-available tools that empower individuals, not gatekeepers.

Read about the Smart Principles that guide development.

Private by Design

Smart Context prepares clipboard exports inside Obsidian.

Copied content can leave Obsidian when you paste or send it into another tool, chat provider, or enabled provider workflow. Review the pasted context before sending when your target tool allows.

FAQs

Thanks to the Community

Your feedback and support keep the project alive. Thank you!