Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/chrisgrieser/shimmering-obsidian/llms.txt

Use this file to discover all available pages before exploring further.

Shimmering Obsidian’s search features rely on metadata files generated by the Metadata Extractor plugin, and your vault’s plugins occasionally need updating. The oupdate command handles plugin updates in one step, and the workflow also provides a separate metadata refresh action to keep its search index current.

​
Updating Plugins with oupdate

Type oupdate in Alfred and press ⏎. The workflow triggers two update operations back to back:
1

Update BRAT beta plugins

Sends the BRAT-checkForUpdatesAndUpdate command to Obsidian via Advanced URI. BRAT checks each beta plugin it manages against its GitHub source and installs any newer version that is available. This step is a no-op if BRAT is not installed in your vault.
2

Update community plugins

Sends the updateplugins Advanced URI command to Obsidian, which checks the community plugin registry and installs any available updates — the same action as clicking Check for updates inside Obsidian’s plugin settings, but without opening the settings panel.

​
Refreshing Workflow Metadata

All of Shimmering Obsidian’s search features read from JSON metadata files that the Metadata Extractor plugin writes on a configurable schedule. This means:
  • A note you created five minutes ago may not appear in o search results yet.
  • A note you renamed will still show up under its old name until the next refresh cycle.
  • Tags added or removed since the last write cycle will not be reflected in ot tag search.
The workflow includes a dedicated metadata refresh action (separate from oupdate) that forces an immediate regeneration of these files so that the search index is fully up to date right now, without waiting for the next scheduled interval.
After a bulk import, a large reorganization of folders, or a session where you created and renamed many notes, trigger the metadata refresh action before switching back to Alfred search. This ensures every new note and tag change is immediately findable through the workflow.

​
BRAT and Beta Plugins

BRAT (Beta Reviewers Auto-update Tester) is a community plugin that lets you install and track Obsidian plugins directly from GitHub repositories before they are published to the official community plugin list. When BRAT is installed and you have beta plugins managed through it, oupdate automatically includes those in the update check — no separate step required.
If BRAT is not installed in your vault, the BRAT update step is simply skipped. You do not need to install BRAT to use oupdate for standard community plugin updates.

Build docs developers (and LLMs) love

Get started for freeTalk to us