Smart Environment for Obsidian

The shared local-first foundation behind Smart Plugins.

Smart Environment keeps sources, exclusions, models, indexing, and health consistent across the suite. Install the Smart Plugin for the workflow you want; Smart Environment coordinates the foundation behind it.

Inspect how the active note is prepared without leaving Obsidian.

Settings · FAQ · v3 update guide · Issues

Control what is indexed

Choose the sources and exclusions shared by Smart Plugins.

Choose the model

Select and test the embedding model used by shared semantic features.

See what is ready

Embedding health separates Current, Missing, Skipped, and Unexpected states for Sources and Blocks.

Coverage shows whether eligible sources and blocks are prepared for the selected model.

Export when needed

Export selected Sources, Blocks, and optional embedding vectors.

Local-first

Generated Environment data is stored under .smart-env/ in the vault. Embeddings run on your device after the runtime and selected model files are downloaded. Provider-backed workflows send their prompt and selected context to the provider you configured.

Updates

Update installed Smart Plugins together and restart Obsidian when prompted. When moving from older Smart Plugins, follow the v3 update guide.

For maintainers

Smart Environment is the shared first-party substrate for Smart Plugins. Repeated infrastructure belongs here; product-specific workflows stay in the plugin that owns them.

License

Smart Environment is source-available under the Smart Plugins License. See the plain-English license guide for common scenarios.