Repository navigation
Compartment 4.14.0 upgrades associative memory recall and adds zero-effort encrypted vault backup and multi-machine merge across the macOS, Windows, and Linux GUIs and CLI — 100% offline, with zero network calls of any kind and zero plaintext ever touching disk.
Downloads
| File | For |
|---|---|
Compartment-4.14.0.pkg |
macOS on Apple silicon, one click, with the menu bar app |
Compartment-4.14.0.dmg |
macOS on Apple silicon, drag to Applications |
Compartment-4.14.0-intel.pkg |
macOS on Intel, one click |
Compartment-4.14.0-intel.dmg |
macOS on Intel, drag to Applications |
compartment-4.14.0.mcpb |
Claude Desktop extension (attached a few minutes after publishing) |
compartment-4.14.0-py3-none-any.whl |
pip and offline installs, any OS |
compartment-4.14.0.tar.gz |
source |
SHA256SUMS.txt |
checksums of all of the above |
pipx install compartment && compartment init # or: uv tool install compartmentWhat's New
One-Click Encrypted Backup & Lossless Multi-Machine Merge
- One-click encrypted
.vaultbackup in macOS, Windows, and Linux GUIs (Back up…) + CLI (compartment backup): Exports a verifiedFORMAT.mdv1 encrypted image (NUCV, Argon2id + XChaCha20-Poly1305, Ed25519 manifest check when signed) while locked or unlocked, without prompting for a passphrase or writing plaintext to disk. Automatically strips any unacknowledged crashed journal tail, writes atomically at mode0600withfsync, and re-parses + SHA-256 verifies the finished file. - One-click lossless encrypted
.vaultmerge in macOS, Windows, and Linux GUIs (Merge…) + CLI (compartment merge): Reconciles another machine's.vaultbackup strictly in RAM without modifying the backup file. Same-key backups merge with zero passphrase prompt; independent backups prompt via stdin only. Reuses stored vectors directly whenmodel_sha256matches (zero ONNX inference), re-embeds offline when models differ, skips duplicate starter memories inO(1), and mergesaffirmedtimestamps, descriptivetags,importance,superseded_bytombstones, andrelations. - Portable organic & graph JSONL (
--organic-only,--include-relations):compartment exportcan exclude starter/pack records and includerelationsedges;compartment importrestores relation edges, remapssrc_idlinks, and preservesprovenance.
Associative Recall & Multi-Project Relevance
- 1-hop relation-graph spreading activation in
search: Queries now probe indexedrelations(rel_subject,rel_object,rel_src) within the caller's allowed namespaces and active[valid_from, valid_to]windows, surfacing memories linked viasrc_id, co-linked entities, or rare 1-hop neighbor entities even with zero lexical overlap — calibrated in log-probability space (W_GRAPH = 0.55) strictly below direct literal and saturated semantic matches. - Bidirectional
camelCase/PascalCase↔snake_caseidentifier recall: FTS indexing andinformation_coveragematch split and compound code identifiers in both directions (maxMemoryChars↔max_memory_chars↔max memory chars) without altering_tokens()or matching substrings inside ordinary words (keynever matcheskeyboard). - Multi-query faceted search (
queries):Vault.searchand MCPmemory_searchaccept optional decomposedqueries: list[str], batch-embedding all facets in a single encoder/daemon pass (embed_queries) and fusing evidence by per-record maximum so multi-part prompts never dilute into one averaged vector. - Zero-config cross-OS git project context prior: Stores from the MCP server, CLI, and Claude hooks automatically detect normalized
owner/reposlugs from.git/config(including worktrees and submodules, in pure Python with zero subprocesses) and apply a gentle ordering tie-break (W_PROJECT = 0.08) tofusedscores when working inside the matching repository without inflatingstaticmembership floors.