You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit ea2e36a
Browse filesBrowse the repository at this point in the historyBrowse files
Merge main into fix/issue-2078 for the release batch
Conflict in tests/test_parse_coverage.c: this branch's DeusData#2078 tests and main's DeusData#1967 line-count test (DeusData#2336) were both appended before the suite; both kept, every TEST still registered.
Signed-off-by: Martin Vogel <martin.vogel.tech@gmail.com>
Copy file name to clipboardExpand all lines: docs/CONFIGURATION.md
+27Lines changed: 27 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -236,6 +236,33 @@ be indexed and later returned. And the credential list is a denylist, so it
236
236
raises the cost of a mistake rather than closing the class — a directory it does
237
237
not name is permitted.
238
238
239
+
### Shared / HPC filesystems
240
+
241
+
On clusters and other shared machines, home directories often live on a network
242
+
filesystem (NFS, Lustre, GPFS, SMB/CIFS), and `~/.cache` is sometimes a symlink
243
+
into a shared tree. Three rules keep CBM working there:
244
+
245
+
-**Put the cache and the rendezvous on local storage.** Set `CBM_CACHE_DIR` (indexes,
246
+
`_config.db`) and, if needed, `CBM_RUNTIME_DIR` (the daemon rendezvous) to a
247
+
local disk you own, for example `/local/scratch/$USER/cbm` or `/tmp/$USER-cbm`.
248
+
Set the same values in your MCP client's environment and your shell.
249
+
-**Do not route the cache into another account's tree.** A symlinked `~/.cache` is
250
+
resolved and allowed, but every directory on the *resolved* path must be owned
251
+
by you or by root. If a parent such as `/shared/fs` belongs to another account,
252
+
that account can rename or replace anything below it, so CBM refuses the path
253
+
and names the directory and its owner:
254
+
255
+
```text
256
+
... (cache-private) - '/shared/fs' is owned by uid 1234 (alice), not by you (uid 1000) or root; ...
257
+
```
258
+
259
+
This check has no override. Choose a location with a safe ancestry instead.
260
+
-**Avoid network filesystems for the cache.** The indexes are SQLite databases in
261
+
WAL mode, which needs shared-memory locking that network filesystems do not
262
+
provide reliably. On Linux, CBM logs one `daemon.cache_root_network_fs` warning
263
+
at startup when the cache root is on NFS, Lustre, GPFS, CIFS or SMB2. The cache
264
+
still works there, but it can be slow, and a database can be corrupted.
265
+
239
266
## 5. Agent and Editor Integration Files
240
267
241
268
The `install` command can also write MCP entries and instruction blocks into agent/editor config files such as Claude Code, Codex, Gemini, VS Code, Cursor, Zed, and others.
0 commit comments