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 gives you two complementary switchers for navigating your Obsidian setup without ever leaving Alfred. The workspace switcher (ow) lets you jump between named layouts inside your current vault, while the vault switcher (ov) lets you open any of your vaults in Obsidian, reveal it in Finder, drop into it in your terminal, or hand control of it to the workflow — all with a single keystroke modifier.

Workspace Switcher

Trigger the workspace switcher by typing ow in Alfred. A list of all your saved Obsidian workspaces appears immediately. Select any workspace and press to load it. Beyond just switching, this view also lets you manage your workspaces without opening Obsidian’s own settings panel:
  • Load a workspace — select any listed workspace and press to restore that layout.
  • Save the current workspace — select the “Save” entry (labelled with your currently active workspace name) to persist any layout changes you’ve made.
  • Manage workspaces — select “Manage Workspaces” to open the Workspaces manager directly inside Obsidian, where you can rename or delete existing workspaces.
The workspace switcher requires the Workspaces core plugin to be enabled inside Obsidian. Navigate to Settings → Core plugins → Workspaces and toggle it on before using ow.
Open the Workspaces plugin settings in Obsidian first and create a few named workspaces — for example, one for writing, one for review, and one for reference browsing. Once they exist, ow gives you instant one-keystroke access to each of them from Alfred.

Vault Switcher

Trigger the vault switcher by typing ov in Alfred. Shimmering Obsidian reads Obsidian’s own vault registry (~/Library/Application Support/obsidian/obsidian.json) and lists every vault it finds, along with its parent directory path for easy identification. The vault you are currently controlling is marked with a ✅ indicator.

Modifier keys

Each vault in the list responds to the following modifier keys:
KeyAction
Open the vault in Obsidian
⌃ + ⏎Open the vault root folder in your default Terminal
⌥ + ⏎Open the vault root folder in Finder
⇧ + ⏎Switch workflow control to this vault (sets it as the active vault for all o commands)
At the bottom of the list you will also find a Vault Menu entry. Selecting it opens Obsidian’s built-in vault manager, where you can create or delete vaults.
Every vault you want to control with Shimmering Obsidian must have both the Advanced URI plugin and the Metadata Extractor plugin installed, enabled, and configured. Without these two plugins active in a vault, workflow features like note search, tag search, and URI-based navigation will not work for that vault.
Alfred’s default terminal can be changed under Alfred Preferences → Features → Terminal. If you prefer iTerm2, Warp, Ghostty, or any other terminal emulator, configure it there and ⌃ + ⏎ in the vault switcher will use it automatically.

Build docs developers (and LLMs) love