Smart Context FAQs
What is Smart Context for Obsidian?
#Smart Context helps you copy the Obsidian notes, links, and source material AI needs for the work you are asking it to do.
It is useful when AI answers are weak because the right context is missing, too broad, stale, or hard to check.
What should I copy first?
#Start with the note that already owns the assignment.
- Open the note with the question, draft, decision, meeting, or project brief.
- Copy the current note as context.
- Choose Depth 0 first.
- Paste into ChatGPT, Claude, Gemini, Smart Chat, or another AI tool.
- Ask the AI to use only the provided context.
- Use Depth 1 only when directly linked notes contain details the AI needs.
How do I know Smart Context worked?
#There are two proof layers.
| Proof layer | You know it worked when... |
|---|---|
| Product proof | Smart Context copied the context, and source, path, depth, or size cues are visible where supported. |
| Value proof | The AI answer uses details from the starting note, or names missing context instead of guessing. |
Copying proves the plugin did its job. A grounded answer, or a precise missing-context request, proves the workflow is working.
Why start with Depth 0?
#Depth 0 copies just the starting note.
That keeps the first copy small enough to check after paste. It also teaches the most important Smart Context habit:
Copy only the context the assignment needs.
After that first copy works, expand only when the answer shows a real gap or when you already know linked notes are needed.
What does Depth 1 mean?
#Depth 1 copies the starting note plus notes it directly links to.
Use Depth 1 when the starting note links to useful support, such as:
- source notes
- examples
- definitions
- decisions
- requirements
- meeting history
Do not use Depth 1 just because the answer was weak. First check whether the starting note has the actual question, outcome, constraints, and useful links.
How does link depth work?
#Depth controls how many link steps Smart Context includes in copy flows that support linked context.
| Depth | Plain meaning | Best use |
|---|---|---|
| Depth 0 | Copy just the starting note or selected starting items. | First copy, focused drafts, clear briefs. |
| Depth 1 | Add directly linked notes. | Hub notes, specs, source links, meeting continuity. |
| Depth 2 | Add links of links. | Small, carefully chosen research or implementation sets. |
| Depth 3+ | Wider expansion. | Rare; use only when the starting set is already tight. |
What should I do if the answer is generic?
#Tighten the starting note and scope before copying more.
Try this:
- Add the actual request.
- Add what done should mean.
- Add the most important constraints.
- Remove repeated, stale, or irrelevant context.
- Add or fix links to supporting notes only when they matter.
- Ask:
Use only this context. If anything is missing, list exactly what context is missing. - Re-copy at Depth 1 only when directly linked support is needed.
Use Builder when the copied set needs pruning.
What if AI still ignores the notes I pasted?
#First, make the instruction and the starting note more explicit.
Use this recovery prompt:
Use only the provided context.
If the answer cannot be grounded in this context, say what is missing instead of guessing.
List the exact missing note, section, source, or decision.
Then check the starting note:
- Does it state the task or question?
- Does it say what done should mean?
- Does it include the constraints that matter?
- Do the links actually point to supporting notes?
- Is there stale, repeated, or irrelevant text making the request harder to follow?
If those are fixed and the answer still needs support, then increase depth or use Builder.
Can I use Smart Context with ChatGPT, Claude, Gemini, or Smart Chat?
#Yes. Smart Context is clipboard-based, so you can paste copied context into ChatGPT, Claude, Gemini, Smart Chat, or another AI tool.
That portability is the point: copy the right context into the AI workflow you already use.
Does Smart Context upload my notes?
#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.
See the Privacy Policy.
Does Smart Context change my notes?
#Copying context does not rewrite your notes.
Settings and templates change how copied text is formatted. Builder and named contexts save context selections. Codeblocks write a visible context list only when you choose to use that workflow.
How do I know what was included?
#Use the copy method that gives you the right amount of review.
- Current-note copy lets you choose depth before export.
- Builder shows selected sources and size cues before copy.
- File and folder actions are faster direct-copy flows when the scope is already obvious.
- Templates can include source paths, modified times, depth, and a file tree in the pasted output.
After pasting into an AI tool, inspect the copied context before sending when the target tool allows.
Should I copy the current note, selected files, a folder, or use Builder?
#Use the smallest method that matches the task.
| What is true? | Use this | Why |
|---|---|---|
| One note owns the task. | Current-note copy | Fastest first win and best Depth 0 starting point. |
| Files or folders are already selected. | File navigator copy | Fast direct export when scope is already chosen. |
| Context is scattered or noisy. | Builder | Review, trim, and copy the right sources. |
| The same set repeats. | Named context | Save and reuse it instead of rebuilding it. |
| Context should stay attached to one note. | Codeblock | Keep a visible context list inside the note. |
| The task needs richer sources or finer control. | Context Pro | Add media, PDFs, Bases, repos, external files, dynamic groups, exclusions, or heading filters. |
Do selected-note or folder copy actions open the depth chooser?
#No. Selected-note, selected-folder, and folder-copy actions are designed for fast export when the scope is already chosen.
Use current-note copy when you need link-depth control.
See file nav actions and Clipboard.
Can I save reusable context sets?
#Yes. Builder lets you create, name, reopen, and reuse trusted context sets.
Use this rule:
If you rebuild the same set twice, save it as a named context.
How do I save, reopen, or delete a named context?
#Type a name in Builder to save the current selection.
Open the named contexts dashboard to reopen, copy, edit, or delete saved contexts. Slash names can group related contexts, such as Client/Project/Working Set.
See Named contexts.
Does a named context replace my current selection?
#No. A named context is a saved set you can reopen, adjust, and copy.
It does not need to replace the one-off set you are building right now.
What is the difference between a named context and a codeblock?
#Use a named context when the same set should be reused across many notes.
Use a Smart Context codeblock when the context should stay attached to one specific note and remain visible in the note body.
Simple rule:
Named context = reuse across many notes. Codeblock = visible context list attached to one note.
What is a Smart Context codeblock?
#A Smart Context codeblock keeps a visible context list inside the note that needs it.
Use it when the note body contains the instructions, brief, or prompt, and the codeblock lists the notes or named contexts that should travel with those instructions.
Context Pro can also include external files and folders in supported desktop workflows.
Can I use Smart Connections results to build context?
#Yes. Send useful results from the Connections view to Smart Context, remove noise, and copy the curated set.
This is the natural handoff:
Discovery finds candidates. Context packages the sources the assignment needs.
How do I keep copied context under token limits?
#Start smaller.
- Use Depth 0 first.
- Use Depth 1 only when supporting notes live one link away.
- Check scope or size cues where shown.
- Replace long notes with relevant blocks in Builder.
- Remove repeated, stale, or irrelevant sources before increasing depth.
Token estimates are directional. Different AI tools count tokens differently.
Can I include only part of a long note?
#Yes. Builder supports block selection so you can export only relevant sections.
Use blocks when one note contains useful source material mixed with unrelated text.
See Builder.
Can I customize the copied format and file tree?
#Yes. Smart Context settings let you customize context templates, item templates, wrappers, file paths, and file tree output.
Templates make pasted context easier to inspect because each item can include its source path and metadata.
Can I exclude private or irrelevant headings?
#Yes, in Pro. Heading filters can include or exclude specific headings without changing the source note.
Configure this in settings.
What does Context Pro add over Core?
#Core covers trusted note-based context:
- current-note copy with link-depth control
- selected-note and folder direct-copy flows
- Builder
- blocks
- named contexts
- codeblocks for notes and named contexts
- template-driven exports
Context Pro adds richer sources and finer control when the assignment needs them.
- 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.
Pro is not required for the first win.
Can I include images, PDFs, repos, or external files?
#Yes, with Pro on supported workflows.
- Copy with media handles images and PDFs where supported.
- Codeblock can include external repos, folders, or files where supported.
- Bases context can turn a filtered Base into copied context where supported.
Use Pro when the task needs richer sources or finer control. Pro is not required for the first win.
Can I copy context from Obsidian Canvas files?
#Yes. Smart Context can start from a .canvas file, resolve canvas node links into note references, and apply link-depth rules.
See Canvas context.
Can Smart Context include embedded Obsidian Bases?
#Yes, in Pro on supported workflows.
Embedded Bases can render into copied context, and links in Bases can be treated like normal links during copy flows.
See Bases context.
Does Smart Context work on mobile?
#Core Smart Context is mobile friendly for note-based workflows. Context Pro includes desktop-oriented features, such as external files and folders, that may not be compatible with mobile.