Smart Context Pro v3.4

Build the full evidence set without losing control of it

Real projects rarely fit in Markdown alone. Smart Context Pro extends the redesigned Builder with media, PDFs, embedded Bases, saved Contexts, and local rule overrides while keeping the complete source set visible before anything is copied or exported.

More source types do not have to mean a more mysterious payload. Build first, inspect second, then choose exactly how the package should leave Obsidian.

Update all installed Smart Plugins together, then restart Obsidian. Smart Context Pro v3.4 requires Smart Environment v3.

One Builder for mixed evidence

Review notes, sections, named Contexts, images, PDFs, folders, and supported embedded Bases in the same tree. The source count, token estimate, rule count, and per-source contribution remain visible even when the project grows beyond ordinary Markdown.

Media-aware Context codeblocks and menus use that same Builder state. You no longer need one mental model for notes and another for the files that travel with them.

Rules no longer hide in settings

The Builder now shows the include and exclude rules that shape one Context. See which folder or saved Context introduced a source, restore an exact exclusion, or turn off a broader global exclusion only for this package.

The exception stays local. The wider folder, named-context, or global rule continues protecting the rest of the vault, so one deliberate override does not become future cleanup work.

Choose the output, not just the sources

Copy text and Copy media are now separate actions. A text prompt no longer shares one ambiguous clipboard operation with images and PDFs.

Copy the reviewed text from the Builder, a Context codeblock, or supported menus.
Choose the supported media files that should travel with the current Context depth.
Export the full package as a ZIP when the destination needs files rather than clipboard content.
See progress and clearer handling when a ZIP is too large to complete normally.

Embedded Bases stay grounded in their source

Supported Bases views can render as part of the Context package, including relative this.file and this.note queries. The Builder can keep that output tied to the note that gives the query meaning, and a missing Bases file no longer has to derail the rest of the package.

You can also decide whether embedded Bases render inline, keeping a dense package readable without removing the source entirely.

Smart Environment v3 supplies the stronger rails

Context Pro inherits v3's faster suite startup, broader built-in local embedding-model catalog, and non-destructive model switching. Drag-and-drop preserves the source you moved, and source menus behave more consistently across the suite.

The improved Environment inspector also makes it easier to verify what was imported or embedded when a semantic source workflow behaves unexpectedly.

Supported Pro integrations can now keep API keys in Obsidian's native keychain-backed secret storage instead of ordinary plugin settings.

Learn more about the release of Smart Environment v3.

Before / After

Before	With Smart Context Pro v3.4
Mixed notes and media became difficult to inspect as one package.	The redesigned Builder keeps richer source types in one visible tree.
Text and media relied on one copy path with destination-dependent behavior.	Choose explicit text, media, or ZIP outputs after reviewing the source set.
Dynamic Bases could lose the source needed for relative queries.	Embedded Bases resolve from the Context source, including `this.file` and `this.note`.
One local exception could tempt you to weaken a global exclusion.	Override the rule for one Context while preserving broader defaults.
Large, file-heavy context had to fit through the clipboard.	Export a ZIP with visible progress and safer oversized-output handling.

Supporting improvements

Media-aware Context codeblocks, commands, ribbon actions, and menus.
Better handling for missing Bases files and source-relative Base compilation.
More resilient rule restoration across folders and included named Contexts.
Fixed Context codeblocks whose names contain a plus sign.
Shared Smart Environment v3 actions across file menus, commands, ribbons, and codeblocks.

Learn more

Release notes

`v3.4.2`

Bring Base views directly into Context

Use the results of an individual Base view alongside notes in the same Context. Views render on demand as Markdown tables and can resolve queries relative to the current note. Different views of the same Base stay distinct, so each can contribute its own results and links.

Add images alongside your notes

Images can now join Context as Smart Sources and appear in Builder suggestions. Before copying, the media chooser shows how much media was detected so you can decide whether to include it.

Check the detected media count and total size before deciding whether to include it.

Use Context Pro through Smart Connect Pro

Context Pro now includes tool actions that Smart Connect Pro can expose through its supported connector channels. With both plugins installed, connected clients can create and list named Contexts, update descriptions, add or remove sources, and retrieve a Context as a manifest, compiled text, file tree, or ZIP data.

You can also export the registered Smart Sources in a folder without first creating a named Context. External-folder scans apply your active exclusions before counting files toward the scan limit.

Context Pro provides the Context actions; Smart Connect Pro provides access to them through Obsidian CLI, Local MCP, or both.

In Smart Connect Pro, choose whether Context Pro actions are available through Obsidian CLI, Local MCP, or both.

Full release notes

Bases and media

Added a Bases view type that makes its results available as context items.
Individual Bases views render on demand when read as sources.
Bases views support Markdown table output and relative queries, including this.file and this.note.
Each Bases view stores its own links and embeddings, without a separate Bases cache collection.
Previously imported Bases blocks can be repaired when view indexes or block metadata are incomplete.
Links in context-dependent Bases views resolve without changing the indexed Base data.
Improved reading and rendering of embedded Bases.
Images can now be registered as Smart Sources, with media suggestions available when building context.

Smart Connect Pro actions

Context Pro now provides the Context-management tool actions that Smart Connect Pro can expose through its connector channels.
With Smart Connect Pro, connected clients can create, retrieve, and list named Contexts, and add or remove their included sources without editing the source notes.
Add a description when creating a Context, update it later through context_update, and read descriptions in Context listings.
When two names resolve to the same saved Context identity, the new Context receives a different name. The tool response includes the requested name and whether it was renamed.
External-folder scans apply active exclusions before counting files toward the scan limit.

Retrieval and export

Context retrieval through Smart Connect Pro supports a manifest, compiled text, a file tree, or ZIP output.
Export the registered Smart Sources in a folder as a file tree or ZIP without first creating a named Context.
ZIPs returned through tool actions are built in memory and delivered as base64-encoded data; they are not automatically saved to disk.

Compatibility and maintenance

The deprecated context_read action has been removed. Integrations using Context Pro through Smart Connect Pro should use context_get, exposed as smart_context_get.
Context Pro tool actions include clearer descriptions and usage guidance.
Expanded automated checks for Context management and export.

`v3.4.1`

Updated: Smart Environment

`v3.4.0`

Enhanced: context codeblock should support media files

Improved: removed the Copy media by default setting and replaced it with an explicit Copy current media command.

Improved: Smart Context copy UX now separates Copy text and Copy media actions instead of presenting media as a default copy mode to resolve mixed clipboard payloads pasting inconsistently across destinations..

Added: ribbon icon for copying media from current context to clipboard

Improved: enhance embedded base rendering by adding a toggle in settings to control inline rendering of embedded bases in source items.

Added: context renders embedded bases with relative (this.) queries

Added: implement media copy functionality with context menu integration

Fixed: should handle missing bases files when rendering bases embeds

Improved: file-nav menu options should use menu action pattern

Added: implement context export as ZIP file functionality

Improved: embedded base file handling when compiling context

Migrated: commands and ribbon icons to command actions architecture

Resolved: codeblock failing to work with context names that include plus sign

removed dependency on data.blocks to support v3 transition

Added: copy ribbon icon now opens menu

Improved: New v2 context builder UI

feat: implement rule management for SmartContext

Add rules_list.js to handle dynamic include and exclude rules for contexts.
Introduce functions to restore exclusions, open contexts, and group rule entries.
Enhance context exclusion utilities to support rule entries and improve data structure.
Update tests to cover new functionalities for context rules and exclusions.

Improved: ZIP export functionality with oversized handling and progress notifications

Improved: source_get_context for better handling bases

Improved: copy ribbon icon menu actions with sub-menus for copy types

Added: override global-level exclusion settings inside individual context rules

Refactor SmartContext exclusion handling and enhance tests

Improved exclusion pattern retrieval in SmartContext to include selected named contexts and normalize exclusion keys.
Added functionality to restore local exclusions when adding items, ensuring broader rules remain intact.
Enhanced removal logic to handle surviving folder and named context rules without hydration.
Introduced new utility functions for explicit exclusion identity and normalization of exclusion match keys.
Updated context exclusion tests to cover new behaviors and edge cases, ensuring robust handling of exclusions.

Updated: Smart Environment v3

Refactor exclusion handling across context and item management

v3.4.0

Extended the redesigned Context Builder with Pro media, Bases, rule, and export workflows.
Added explicit Copy text and Copy media actions across the Builder, codeblocks, commands, ribbons, and supported menus.
Added media-aware Context codeblocks and a dedicated media chooser.
Added embedded Bases rendering, relative this.file and this.note queries, inline-rendering control, and safer missing-file handling.
Added per-context exclusion overrides and improved rule restoration across folders and named Contexts.
Added ZIP export with progress and oversized-output handling.
Fixed Context codeblock names containing a plus sign.
Updated Smart Context Pro to Smart Environment Pro v3.2.0.
Requires Smart Environment v3.0.0 or newer.