Skip to content

Commit a6da23d

Browse files
authored
feat: perseus-vault connect -- one-command MCP client setup (PMB-inspired) (#333)
Add 'perseus-vault connect --client <name>' subcommand that auto-wires an MCP client's config file, eliminating manual JSON/YAML/TOML editing for first-time setup. Inspired by PMB's 'pmb connect' UX. - Supports: claude-desktop, claude-code, hermes, cursor, windsurf, vscode, zed, codex. - Merges into existing config (JSON objects, YAML mappings, TOML stanzas) without clobbering unrelated keys/servers already present. - Writes a timestamped backup of the existing file before any write. - --dry-run prints the would-be output without touching the filesystem. - Codex TOML re-runs replace the existing [mcp_servers.mimir] stanza in place instead of duplicating it. - Config path overridable via MIMIR_CONNECT_CONFIG (used by tests and non-standard installs). - perseus-vault doctor now mentions 'connect' as the recommended setup path. - 7 new unit tests (CLI parsing + real file writes/merges/idempotency across JSON/YAML/TOML backends); full suite 132 passed / 0 failed, stable across repeated runs (no test-order flakiness from set_current_dir / env var usage). - Version bump 2.10.0 -> 2.11.0.
1 parent 38f53aa commit a6da23d

4 files changed

Lines changed: 395 additions & 3 deletions

File tree

Cargo.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "perseus-vault"
3-
version = "2.10.0"
3+
version = "2.11.0"
44
edition = "2021"
55
description = "Persistent memory engine for AI agents — MCP JSON-RPC stdio server (formerly Mneme/Mimir)"
66
repository = "https://github.com/Perseus-Computing-LLC/perseus-vault"

docs/clients/README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@ mimir serve --db ~/.mimir/data/mimir.db
88
```
99

1010
Run `mimir doctor` to validate your install and print this matrix locally.
11+
Run `mimir connect --client <name>` to auto-wire a client's config file
12+
(merges a `mimir` MCP stanza into it, backing up the original first — no
13+
manual JSON/YAML/TOML editing required).
1114

1215
| Client | Status | Config file | Notes |
1316
|---|---|---|---|

0 commit comments

Comments
 (0)