wiki-switch

Switch between named Obsidian wiki vault profiles by re-pointing a config symlink.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-switch-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-switch
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/wiki-switch
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-switch-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing multiple Obsidian wiki vaults (personal, work, research) normally requires manually editing config files or juggling environment variables. This Skill lets you switch your active vault profile with a single command, keeping each vault's settings in its own named config file. ## Core Features & Use Cases - Profile Switching: Activate a named vault profile by re-pointing the config symlink to config.<name>, changing your persistent default for all future requests. - Profile Management: List all registered vaults with the active one marked, show a vault's full config (with secrets redacted), and scaffold new profiles from the current config as a template. - Use Case: You maintain a personal research wiki and a work projects wiki. Run /wiki-switch work on Monday morning to make the work vault your default, then /wiki-switch personal on the weekend — or use the inline @work override for a one-off query without changing your default. ## Quick Start Ask the assistant to switch to your work wiki by saying "/wiki-switch work" and it will activate that vault profile and confirm the vault path.

Frequently Asked Questions about wiki-switch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch between multiple Obsidian vaults?

Run /wiki-switch followed by the vault name, such as /wiki-switch work. This re-points the config symlink to that vault's config file, making it your persistent default for all future requests.

How do I query a different vault without changing my default?

Use the inline @name override in any request, for example @work save this or wiki-query @personal about X. This resolves that vault's config for one invocation only and never re-points the symlink.

Where are the vault config files stored?

Configs live in $XDG_CONFIG_HOME/obsidian-wiki (default ~/.config/obsidian-wiki), or the legacy ~/.obsidian-wiki directory if it already exists. Each vault is a file named config.<name>, and the active vault is whatever config symlinks to.

How do I create a new Obsidian vault profile?

Run /wiki-switch new <name>. It copies the active config as a template, prompts you for vault-specific values while keeping shared settings, and writes the new config file. It does not switch automatically.

Does showing a vault config expose my API keys?

No. The show action redacts any lines containing API_KEY or SECRET, displaying *** instead of the actual value, so credentials are never printed to the conversation.