
Wiki Switch
- 1.8k installs
- 3.1k repo stars
- Updated August 4, 2026
- ar9av/obsidian-wiki
wiki-switch manages named Obsidian wiki vault configs via symlinks under ~/.obsidian-wiki/.
About
The wiki-switch skill manages multiple Obsidian wiki vault profiles stored as config files at ~/.obsidian-wiki/config.<name> with the active vault determined by a symlink at ~/.obsidian-wiki/config. Dispatch routes /wiki-switch name to switch, list to enumerate profiles, show to print a config with secrets redacted, and new to scaffold from the active template. Switch verifies the named config exists, runs ln -sf to repoint the symlink, reads OBSIDIAN_VAULT_PATH from the activated file, and confirms the vault path. List resolves the current symlink, reads optional comment headers as descriptions, and marks the active profile. New copies the active config, asks for vault-specific field updates while preserving global sections, updates the top comment, and does not auto-switch. API_KEY and SECRET lines are redacted in show output.
- Activates vaults by symlinking ~/.obsidian-wiki/config to config.<name>.
- Lists profiles with optional comment descriptions and active marker.
- Shows configs verbatim while redacting API_KEY and SECRET values.
- Scaffolds new vault configs from the active template without auto-switching.
- Parses /wiki-switch subcommands for switch, list, show, and new flows.
Wiki Switch by the numbers
- 1,764 all-time installs (skills.sh)
- +30 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #304 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
wiki-switch capabilities & compatibility
- Capabilities
- vault switching · profile listing · config scaffolding · secret redaction
- Use cases
- planning · orchestration
What wiki-switch says it does
Each vault is a complete config file at `~/.obsidian-wiki/config.<name>`. The active vault is whichever file `~/.obsidian-wiki/config` symlinks to.
Switching vaults means re-pointing that symlink.
npx skills add https://github.com/ar9av/obsidian-wiki --skill wiki-switchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.8k |
|---|---|
| repo stars | ★ 3.1k |
| Security audit | 3 / 3 scanners passed |
| Last updated | August 4, 2026 |
| Repository | ar9av/obsidian-wiki ↗ |
How do I switch between multiple Obsidian wiki vault profiles from chat?
Switch, list, show, or scaffold Obsidian wiki vault profiles via ~/.obsidian-wiki/config.NAME symlinks.
Who is it for?
Users maintaining multiple Obsidian wiki vault profiles on one machine.
Skip if: Obsidian note editing inside vaults without profile switching needs.
When should I use this skill?
User says wiki-switch, switch vault, list my wikis, or create vault config.
What you get
Active vault symlink updated with confirmed OBSIDIAN_VAULT_PATH or new config scaffolded.
- Active vault symlink
- Named vault config files
- Vault profile listing
By the numbers
- Stores vault profiles at ~/.obsidian-wiki/config.<name>
- Activates vaults by symlinking ~/.obsidian-wiki/config to the chosen profile
Files
Wiki Switch — Manage Multiple Vault Profiles
Each vault is a complete config file at ~/.obsidian-wiki/config.<name>. The active vault is whichever file ~/.obsidian-wiki/config symlinks to. Switching vaults means re-pointing that symlink.
Dispatch
Parse the invocation and route to the right section:
| Invocation | Action |
|---|---|
/wiki-switch <name> | → Switch |
/wiki-switch list | → List |
/wiki-switch show [name] | → Show |
/wiki-switch new <name> | → New |
/wiki-switch (no args) | → List (treat as list) |
---
Switch (default action)
Activate a named vault profile.
1. Verify ~/.obsidian-wiki/config.<name> exists. If not, tell the user the vault doesn't exist and list what's available (run List). 2. Run:
ln -sf ~/.obsidian-wiki/config.<name> ~/.obsidian-wiki/config3. Read OBSIDIAN_VAULT_PATH from the newly active config. 4. Confirm to the user:
Switched to vault: <name>
Vault path: <value of OBSIDIAN_VAULT_PATH from the config>---
List
Show all registered vault profiles and which is active.
1. Find all files matching ~/.obsidian-wiki/config.* (exclude config itself — that's the symlink). 2. Resolve the current symlink target: readlink ~/.obsidian-wiki/config 3. For each config file, read the first non-empty comment line (lines starting with #) as a human description of the vault. Fall back to the file's suffix as the label if no comment exists. 4. Display:
Vaults:
personal My personal research wiki ← active
work Work projects wikiMark the active one with ← active. If the symlink is broken or config doesn't exist, show (none active).
---
Show
Print the full config for a vault.
- If a name is given, read
~/.obsidian-wiki/config.<name>. - If no name given, read
~/.obsidian-wiki/config(the active vault). - If the file doesn't exist, tell the user and list what's available.
- Print the file contents verbatim (redact any lines containing
API_KEYorSECRET— show***instead of the value).
---
New
Scaffold a new vault config from the current active config as a template.
1. Check ~/.obsidian-wiki/config.<name> doesn't already exist. Abort if it does. 2. Copy the active config:
cp ~/.obsidian-wiki/config ~/.obsidian-wiki/config.<name>3. Read the copied config. Config files use # --- Section name --- comment headers to group fields into sections (e.g., # --- Vault-specific ---, # --- Vault-independent ---, # --- Secrets ---). Use these sections to determine what to ask about:
- Fields in sections labeled "vault-specific", "paths", or similar → ask the user for new values
- Fields in sections labeled "vault-independent", "global", "shared" → keep as-is (copy over unchanged)
- Fields in sections labeled "secrets" → ask if the new vault uses the same credentials or different ones
- If there are no section headers, present all fields and let the user decide which to change
4. Ask the user for updated values for the vault-specific fields. Use the current values as visible defaults — the user only needs to supply what differs. 5. Write the updated values into ~/.obsidian-wiki/config.<name>. 6. Update the top comment line to describe the new vault (e.g., # Obsidian Wiki — <name> vault). 7. Confirm:
Created: ~/.obsidian-wiki/config.<name>
Run `/wiki-switch <name>` to activate it, then run `wiki-setup` to initialise the new vault.Do not switch automatically — let the user decide when to activate.
Related skills
How it compares
Use wiki-switch for obsidian-wiki multi-profile switching; use general note skills when documentation lives outside Obsidian vault configs.
FAQ
Where are vault configs stored?
At ~/.obsidian-wiki/config.<name> with ~/.obsidian-wiki/config as the active symlink.
Does new auto-activate the vault?
No. It creates config.<name> and tells the user to run wiki-switch to activate.
Are secrets shown in show output?
Lines containing API_KEY or SECRET are redacted to ***.
Is Wiki Switch safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.