wiki-switch
GitHub管理多个 Obsidian Wiki 配置档案。支持切换默认激活的 Vault、列出所有可用档案、查看配置详情及创建新档案,通过符号链接实现持久化切换。
Trigger Scenarios
Install
npx skills add Ar9av/obsidian-wiki --skill wiki-switch -g -y
SKILL.md
Frontmatter
{
"name": "wiki-switch",
"description": "Switch between multiple Obsidian wiki vault profiles. Use this skill when the user says \"\/wiki-switch NAME\", \"switch to my work wiki\", \"switch vault\", \"change wiki\", \"which wiki am I on\", \"list my wikis\", \"show my vaults\", \"create a new vault config\", or \"add a new wiki profile\". The skill manages named config files at ~\/.obsidian-wiki\/config.NAME and activates one by symlinking it to ~\/.obsidian-wiki\/config."
}
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.
Switch vs. inline targeting. /wiki-switch <name> changes your persistent default (re-points
the symlink, affecting all future requests). To touch a different vault for just one request without
changing your default, use the inline @name override in any request (e.g. @work save this,
wiki-query @personal about X). The @name override is handled by the Config Resolution Protocol
in llm-wiki/SKILL.md, not by this skill — it resolves ~/.obsidian-wiki/config.<name> for that one
invocation and never re-points the 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) |
@<name> … (inline, in any request) |
→ Not this skill — the Config Resolution Protocol resolves that vault for one invocation without re-pointing the symlink |
Switch (default action)
Activate a named vault profile.
- Verify
~/.obsidian-wiki/config.<name>exists. If not, tell the user the vault doesn't exist and list what's available (run List). - Run:
ln -sf ~/.obsidian-wiki/config.<name> ~/.obsidian-wiki/config - Read
OBSIDIAN_VAULT_PATHfrom the newly active config. - 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.
- Find all files matching
~/.obsidian-wiki/config.*(excludeconfigitself — that's the symlink). - Resolve the current symlink target:
readlink ~/.obsidian-wiki/config - 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. - Display:
Mark the active one withVaults: personal My personal research wiki ← active work Work projects wiki← active. If the symlink is broken orconfigdoesn'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.
- Check
~/.obsidian-wiki/config.<name>doesn't already exist. Abort if it does. - Copy the active config:
cp ~/.obsidian-wiki/config ~/.obsidian-wiki/config.<name> - 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
- 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.
- Write the updated values into
~/.obsidian-wiki/config.<name>. - Update the top comment line to describe the new vault (e.g.,
# Obsidian Wiki — <name> vault). - Confirm:
Do not switch automatically — let the user decide when to activate.Created: ~/.obsidian-wiki/config.<name> Run `/wiki-switch <name>` to activate it, then run `wiki-setup` to initialise the new vault.
Version History
- 1f290b0 Current 2026-07-05 15:00


