1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
title: Memory server
description: A persistent JSONL knowledge graph.
Start the server:
```bash
tuls memory \
--memory-file /work/state/memory.jsonl \
--allow memory.read \
--allow memory.write
```
If `--memory-file` is omitted:
1. 2.
The server also exposes the knowledge graph as:
```text
memory://knowledge-graph
```
Grant `memory.read` when resource access is required. The resource is an
auxiliary surface: an exact single-tool grant like `--allow memory/read_graph`
keeps the tool but hides the resource (see
[capability policy](../guide/capability-policy)).
The graph is stored as JSONL and mutations rewrite a complete validated graph
atomically. Existing Unix file permissions are preserved when replacing an
existing regular file.
No-op mutations — duplicate entity/relation/observation creates, or deletes
that match nothing — change nothing: they do not rewrite the file and do not
send resource-update notifications.
Read-only memory:
```bash
tuls memory \
--memory-file /work/state/memory.jsonl \
--allow memory.read
```
::: tip Related
-
:::