Install The Vault Backend - alexherrero/crickets GitHub Wiki
Note
Goal: Install the obsidian-vault plugin and point the engine at your MemoryVault so storage.backend=vault resolves to it. obsidian-vault has been the only live vault backend since agentm v5.5.0 (the V5-3 cutover, 2026-06-17) — the kernel's built-in vault backend was deleted at that release, so there is no parallel-run step and nothing to fall back to.
Prereqs: an agentm engine present (the backend only runs under it); an existing MemoryVault directory (a plain folder, optionally Drive-synced — see Back the vault with Drive); the crickets plugin marketplace registered (claude plugin marketplace add alexherrero/crickets).
-
Install the
obsidian-vaultplugin.claude plugin install obsidian-vault@crickets
Dogfooding a sibling checkout instead of the installed plugin cache? Point
$OBSIDIAN_VAULT_SCRIPTSat<crickets-checkout>/src/obsidian-vault/scripts— discovery checks that env override first, then a siblingcrickets/src/obsidian-vault/scriptscheckout next to your agentm checkout, then the installed plugin cache last. -
Point the engine at your vault and select the
vaultbackend — one command does both:python3 scripts/agentm_config.py --vault-path "/path/to/your/MemoryVault"(run from your agentm checkout, or wherever
agentm_config.pyis installed). This writesplugins.obsidian-vault.vault_pathand setsstorage.backend=vaultin~/.claude/.agentm-config.json. -
Confirm the engine discovers the plugin and resolves to it — run the verify step below; a
[OK]on thebackendrow means selection resolved toobsidian-vault.
Run the vault-doctor skill (or its read-only probe directly) for a one-pass health check — it confirms the configured vault_path is a real MemoryVault, that selection resolves vault to this plugin, and that no GDrive/DriveFS sync-conflict files remain:
python3 "$CLAUDE_PLUGIN_ROOT/scripts/doctor_vault.py"
# three [OK]/[WARN]/[FAIL] rows: vault-path / backend / conflicts; exit 1 only on a FAILThe probe is read-only (constructs no backend, writes neither the vault nor ~/.claude/.agentm-config.json). Three [OK] rows and exit 0 mean the plugin is wired up.
-
Engine refuses loudly on
storage.backend=vault: the plugin isn't discoverable — not installed at the native plugin cache, not found via$OBSIDIAN_VAULT_SCRIPTS, and no sibling checkout. Install it (step 1) or point$OBSIDIAN_VAULT_SCRIPTSat itsscripts/dir. The engine never silently demotes todevice-local— a loud refusal is by design. -
Vault path unreachable (e.g. GDrive unmounted):
python3 "$CLAUDE_PLUGIN_ROOT/scripts/doctor_vault.py"reports thevault-pathrow as[FAIL]rather than the engine silently falling back — remount the drive and re-run. -
No session-start nudge on Antigravity: expected — Antigravity has no
SessionStartevent, so the conflict-merger nudge is Claude-Code-only. The detector stays reachable on demand via thevault-doctorskill anddoctor_vault.py'sconflictscheck (run it at session start). See Antigravity limitations → Hooks.
- Obsidian vault backend — the reference for the seam verbs, capability descriptor, and discovery/lock contract.
- Install crickets plugins — the general plugin install paths.
- CI gates — the gate battery the conformance-suite proof joins.