vaults

1# /bedrock:vaults — Vault Management
2 
3## Plugin Paths
4 
5The vault registry lives in the plugin root directory, not in any vault.
6Use the "Base directory for this skill" provided at invocation to resolve paths:
7 
8- Vault registry: `<base_dir>/../../vaults.json`
9- Plugin CLAUDE.md: `<base_dir>/../../CLAUDE.md` (auto-injected into context)
10 
11Where `<base_dir>` is the path shown in "Base directory for this skill".
12 
13---
14 
15## Overview
16 
17This skill manages the global vault registry — the file that maps vault names to
18filesystem paths and tracks which vault is the default.
19 
20**You are a management agent.** This skill is read-only with respect to vaults themselves —
21it never reads or modifies vault entities, never runs git operations inside vaults, and
22never touches `.bedrock/config.json`. It only reads and writes the registry file (`vaults.json`).
23 
24---
25 
26## Phase 0 — Parse Input
27 
28Parse the user's input to determine the command mode:
29 
30| Input pattern | Mode | Variables |
31|---|---|---|
32| No flags / empty / `list` | **list** | — |
33| `--set-default <name>` | **set-default** | `TARGET_NAME = <name>` |
34| `--remove <name>` | **remove** | `TARGET_NAME = <name>` |
35 
36If the input doesn't match any pattern, default to **list** mode.
37 
38---
39 
40## Phase 1 — Read Registry
41 
42Resolve the registry path:
43 
44```
45REGISTRY_PATH = <base_dir>/../../vaults.json
46```
47 
48Read the registry file:
49 
50```bash
51cat <REGISTRY_PATH> 2>/dev/null
52```
53 
54**If the file does not exist or is empty:**
55…