knowmind 0.3.4 → 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.de.md ADDED
@@ -0,0 +1,207 @@
1
+ # knowmind
2
+
3
+ **Ihr KI-Assistent kennt Ihr Unternehmen nicht.** Er beginnt jedes Gespräch bei null, und Sie
4
+ erklären ihm zum wiederholten Mal dieselben Zusammenhänge. knowmind ist das Gedächtnis darunter:
5
+ Was Sie einmal ablegen, steht in Claude, ChatGPT, Cursor und Ihren eigenen Anwendungen zur
6
+ Verfügung. Betrieben in Deutschland, im Rechenzentrum Nürnberg.
7
+
8
+ **Der Privat-Tarif kostet dauerhaft nichts und verlangt keine Zahlungsdaten.** Schnittstelle,
9
+ Kommandozeile und MCP-Server sind in jedem Tarif enthalten, auch dort.
10
+
11
+ <!-- mcp-name: io.github.Schubeler-Consulting/knowmind -->
12
+
13
+ [![npm](https://img.shields.io/npm/v/knowmind)](https://www.npmjs.com/package/knowmind) · [knowmind.de](https://knowmind.de) · dieses Paket unter Apache-2.0
14
+
15
+ ## Installation
16
+
17
+ ```
18
+ npm install -g knowmind
19
+ ```
20
+
21
+ Oder ohne Installation direkt als MCP-Server: `npx -y knowmind mcp`
22
+
23
+ ## Einrichtung
24
+
25
+ 1. Kostenloses Konto auf [knowmind.de](https://knowmind.de) anlegen und dort einen Zugangsschlüssel
26
+ erzeugen: Dashboard → API-Tokens
27
+ 2. Lokal speichern:
28
+
29
+ ```
30
+ knowmind login --token kmt_xxxxxxxx
31
+ ```
32
+
33
+ Alternativ über ENV:
34
+
35
+ ```
36
+ export KNOWMIND_TOKEN=kmt_xxxxxxxx
37
+ export KNOWMIND_API_URL=https://knowmind.de
38
+ ```
39
+
40
+ ## Befehle
41
+
42
+ ```
43
+ npx -y knowmind install <ide> MCP-Server im KI-Client verdrahten (claude, cursor, vscode …)
44
+ knowmind init Automatische Gedächtnis-Pflege im KI-Client einrichten
45
+ knowmind search "Wo läuft die OKR-App?"
46
+ knowmind upload notizen.md --title "Meeting Notizen 2026-05-12"
47
+ knowmind stats
48
+ knowmind health
49
+ knowmind status Lebenszeichen des Gedächtnisses (Report)
50
+ knowmind status --line Einzeilige Statusline für Ihr KI-Werkzeug
51
+ knowmind config
52
+ ```
53
+
54
+ Die Statusline (`knowmind status --line`) zeigt knowmind als grüne Lampe direkt in Ihrem
55
+ KI-Werkzeug: ruhig grün, wenn erreichbar, grünes Flackern wie eine Festplatten-LED, während
56
+ knowmind arbeitet, rot bei Ausfall. `knowmind init --client claude-code` bindet sie
57
+ automatisch ein (eine bereits vorhandene eigene Statusline bleibt unangetastet).
58
+
59
+ ## Automatische Pflege einrichten (`knowmind init`)
60
+
61
+ Damit Ihre KI knowmind selbsttätig pflegt — **Recall vor jeder Aufgabe**, **Sichern nach
62
+ jeder sicherungswürdigen Runde** — richtet `knowmind init` die passenden Mechanismen für
63
+ Ihren Client ein. Der Befehl erkennt den Client am Projekt- und Home-Verzeichnis
64
+ (`.claude/`, `.cursor/`, `~/.codex/`) oder Sie wählen ihn explizit.
65
+
66
+ ```
67
+ knowmind init # Client automatisch erkennen
68
+ knowmind init --client claude-code # gezielt für Claude Code
69
+ knowmind init --client cursor # gezielt für Cursor
70
+ knowmind init --dry-run # zeigt nur, was geschähe (schreibt nichts)
71
+ ```
72
+
73
+ **Was eingerichtet wird:**
74
+
75
+ - **Claude Code** — projektlokale Hooks in `.claude/`:
76
+ - *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall` auf und reicht die
77
+ Top-Treffer als Kontext nach (Memory-First, automatisch).
78
+ - *Stop* → erinnert die KI daran, mit `knowmind_store_memory` zu sichern, wenn die Runde
79
+ Sicherungswürdiges enthielt (Deploy/Commit, neue Regel, Entscheidung) und noch nichts
80
+ gespeichert wurde.
81
+ - ein **Memory-First-Block** in `./CLAUDE.md` (mit `<!-- BEGIN/END knowmind -->`-Markern).
82
+ - **Cursor** — `.cursor/rules/knowmind.mdc` mit der Memory-First-Regel (`alwaysApply`).
83
+ - **Claude Desktop / Codex / generisch** — kein automatischer Hook-Mechanismus vorhanden;
84
+ der Befehl zeigt den Memory-First-Text zum manuellen Einfügen (siehe Grenze unten).
85
+
86
+ **Idempotent & nicht-destruktiv:** Ein zweiter Lauf erzeugt keine Duplikate
87
+ (marker-/befehls-basierte Ersetzung); bestehende fremde Dateien und Hooks bleiben
88
+ unangetastet. Mit `--dry-run` sehen Sie jede Aktion vorab.
89
+
90
+ > **Grenze der Automatik:** Eine *harte* Erzwingung der Pflege gibt es nur in Clients mit
91
+ > Hook-/Rule-Mechanismus (Claude Code, Cursor). In Clients ohne solchen Mechanismus
92
+ > (z. B. Claude Desktop, Codex CLI) greifen die **MCP-instructions** (werden beim
93
+ > Verbinden gelesen) und die **MCP-prompts** — eine modellabhängige Steuerung ohne
94
+ > technische Garantie.
95
+
96
+ ## MCP-Server einrichten
97
+
98
+ knowmind ist ein MCP-Server (`npx -y knowmind mcp`, stdio). Token aus dem knowmind.de-Dashboard
99
+ (→ API-Tokens) als `KNOWMIND_TOKEN`; optional `KNOWMIND_API_URL` (Standard `https://knowmind.de`).
100
+
101
+ **Claude Code**
102
+ ```
103
+ claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx --env KNOWMIND_API_URL=https://knowmind.de -- npx -y knowmind mcp
104
+ ```
105
+
106
+ **Claude Desktop / Cursor / Windsurf / Cline / Continue / Goose / Zed** (`claude_desktop_config.json`, `~/.cursor/mcp.json`, …)
107
+ ```json
108
+ {
109
+ "mcpServers": {
110
+ "knowmind": {
111
+ "command": "npx",
112
+ "args": ["-y", "knowmind", "mcp"],
113
+ "env": { "KNOWMIND_TOKEN": "kmt_xxx", "KNOWMIND_API_URL": "https://knowmind.de" }
114
+ }
115
+ }
116
+ }
117
+ ```
118
+ > Windows-Hinweis: falls `npx` nicht direkt startet, `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
119
+
120
+ **VS Code / GitHub Copilot** (`.vscode/mcp.json` — Top-Level `servers` + `inputs`)
121
+ ```json
122
+ {
123
+ "inputs": [{ "id": "knowmind_token", "type": "promptString", "description": "Knowmind API token", "password": true }],
124
+ "servers": {
125
+ "knowmind": {
126
+ "command": "npx",
127
+ "args": ["-y", "knowmind", "mcp"],
128
+ "env": { "KNOWMIND_TOKEN": "${input:knowmind_token}", "KNOWMIND_API_URL": "https://knowmind.de" }
129
+ }
130
+ }
131
+ }
132
+ ```
133
+
134
+ **Codex CLI** (`~/.codex/config.toml`)
135
+ ```toml
136
+ [mcp_servers.knowmind]
137
+ command = "npx"
138
+ args = ["-y", "knowmind", "mcp"]
139
+ env = { KNOWMIND_TOKEN = "kmt_xxx", KNOWMIND_API_URL = "https://knowmind.de" }
140
+ ```
141
+
142
+ **Gemini CLI** (`~/.gemini/settings.json`) — gleiche `mcpServers`-Struktur wie Claude Desktop.
143
+
144
+ **Remote (ohne lokale Installation)** — für Clients mit HTTP-MCP-Support direkt der gehostete Endpoint:
145
+ ```json
146
+ { "type": "http", "url": "https://knowmind.de/api/mcp/v1", "headers": { "Authorization": "Bearer kmt_xxx" } }
147
+ ```
148
+
149
+ Token kann statt per `env` auch lokal via `knowmind login --token kmt_xxx` (→ `~/.knowmind/config.json`) hinterlegt werden.
150
+
151
+ ## Tools (im MCP-Modus)
152
+
153
+ Der MCP-Modus ist seit 0.1.18 ein reiner Proxy auf die Plattform: Tool-Namen,
154
+ Schemas und Safety-Annotations kommen direkt vom Server und sind damit immer
155
+ identisch mit dem Remote-Connector (`https://knowmind.de/api/mcp/v1`).
156
+
157
+ - `knowmind_recall` — Hybride Suche im Wissensspeicher des Mandanten
158
+ - `knowmind_recall_at_time` — Recall mit Zeitfilter (bi-temporal)
159
+ - `knowmind_store_memory` — Neue Erinnerung anlegen (Titel + Inhalt)
160
+ - `knowmind_upload_document` — Längeren Text als Dokument ingestieren (Upsert-per-Titel: gleicher Titel ersetzt die alte Version)
161
+ - `knowmind_update_fact` — Fakt bi-temporal aktualisieren (Historie bleibt)
162
+ - `knowmind_link` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
163
+ - `knowmind_unlink` — Beziehung wieder entfernen (samt Inverse)
164
+ - `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
165
+ - `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
166
+ - `knowmind_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
167
+ - `knowmind_health` — Verfügbarkeits-Status der Plattform
168
+
169
+ Inverse-Beziehungen (z. B. `IS_EMPLOYEE_OF` zu `HAS_EMPLOYEE`) werden
170
+ serverseitig automatisch mit angelegt. Hinweis: `knowmind upload` als
171
+ CLI-Befehl läuft über die REST-Schnittstelle (`/api/documents`), nicht über MCP.
172
+
173
+ ## Daten in Deutschland
174
+
175
+ knowmind wird in Deutschland betrieben: Ihre Inhalte (Memories, Account- und Metadaten) werden
176
+ ausschließlich auf Servern in Deutschland (Hetzner-Rechenzentrum) gespeichert und verlassen Deutschland nicht.
177
+ Auftragsverarbeitung (AVV) nach Art. 28 DSGVO verfügbar: https://knowmind.de/legal/avv
178
+
179
+ **Hinweis (Bring-your-own-Key):** Wenn Sie eigene Schlüssel externer KI-Anbieter hinterlegen, werden Ihre
180
+ Anfragen direkt an den von Ihnen gewählten Anbieter übermittelt. Sitzt dieser außerhalb der EU, kann dabei
181
+ ein Drittlandtransfer stattfinden, für den Sie als Verantwortlicher zuständig sind.
182
+
183
+ ## Haftung & Nutzung (Disclaimer)
184
+
185
+ - **Software:** Dieses Paket steht unter der **Apache-Lizenz 2.0** und wird „AS IS" ohne jegliche
186
+ Gewährleistung bereitgestellt; die Haftung ist im Rahmen der Lizenz (Abschnitte 7 und 8)
187
+ ausgeschlossen bzw. beschränkt. Siehe `LICENSE`.
188
+ - **Eigenes Konto, eigener Token:** knowmind bündelt keine Zugangsdaten. Sie nutzen Ihren eigenen
189
+ knowmind.de-Account und API-Token. Anlegen: https://knowmind.de/dashboard/api-tokens
190
+ - **Eigene Kosten/Verbrauch:** Jede Nutzung (API-Anfragen, Token-/Kontingentverbrauch, ggf.
191
+ modellbezogene Kosten) erfolgt über Ihren eigenen Account und auf Ihre Verantwortung. Verbrauch
192
+ und Kosten sind im knowmind.de-Dashboard transparent einsehbar.
193
+ - **Service-Bedingungen:** Für die Nutzung der gehosteten Plattform gelten die AGB und die
194
+ Datenschutzerklärung von knowmind.de:
195
+ [AGB](https://knowmind.de/legal/agb) · [Datenschutz](https://knowmind.de/legal/datenschutz) ·
196
+ [AVV](https://knowmind.de/legal/avv) · [Impressum](https://knowmind.de/legal/impressum)
197
+ - **Kein Einsatz in sicherheitskritischen Bereichen:** knowmind ist ein Gedächtnis-/Recall-Dienst und
198
+ **nicht** für den Betrieb von selbstfahrenden Fahrzeugen, kritischer Infrastruktur, medizinischen oder
199
+ lebenserhaltenden Systemen oder sonstigen Anwendungen bestimmt, bei denen ein Fehler oder Ausfall zu Tod,
200
+ Personen-, Umwelt- oder schweren Sachschäden führen kann. Ein Einsatz in solchen Umgebungen erfolgt auf
201
+ alleiniges Risiko des Nutzers.
202
+
203
+ Anbieter: Schübeler Consulting — Johann Jörgen Schübeler. Kontakt: info@schuebeler-consulting.de
204
+
205
+ ---
206
+
207
+ Die englische Fassung steht in [README.md](README.md).
package/README.md CHANGED
@@ -1,203 +1,207 @@
1
1
  # knowmind
2
2
 
3
- **Ihr KI-Assistent kennt Ihr Unternehmen nicht.** Er beginnt jedes Gespräch bei null, und Sie
4
- erklären ihm zum wiederholten Mal dieselben Zusammenhänge. knowmind ist das Gedächtnis darunter:
5
- Was Sie einmal ablegen, steht in Claude, ChatGPT, Cursor und Ihren eigenen Anwendungen zur
6
- Verfügung. Betrieben in Deutschland, im Rechenzentrum Nürnberg.
7
-
8
- **Der Privat-Tarif kostet dauerhaft nichts und verlangt keine Zahlungsdaten.** Schnittstelle,
9
- Kommandozeile und MCP-Server sind in jedem Tarif enthalten, auch dort.
10
3
 
11
4
  <!-- mcp-name: io.github.Schubeler-Consulting/knowmind -->
12
5
 
13
- [![npm](https://img.shields.io/npm/v/knowmind)](https://www.npmjs.com/package/knowmind) · [knowmind.de](https://knowmind.de) · [Discord](https://discord.gg/nRguXx5hDQ) · dieses Paket unter Apache-2.0
14
-
15
- ## Installation
16
-
17
- ```
18
- npm install -g knowmind
19
- ```
20
-
21
- Oder ohne Installation direkt als MCP-Server: `npx -y knowmind mcp`
6
+ **Persistent memory for your AI tools.** Store something once, and it is available in Claude Code, Cursor, and any other MCP client that runs a local (stdio) server — as a typed knowledge graph with provenance, confidence, and a bitemporal history for every fact. Hosted in Germany (Hetzner, Nuremberg data center); the CLI and MCP server in this repository are Apache-2.0.
22
7
 
23
- ## Einrichtung
8
+ **The free tier is permanently free and requires no payment details.** The API, CLI, and MCP server are included in every tier.
24
9
 
25
- 1. Kostenloses Konto auf [knowmind.de](https://knowmind.de) anlegen und dort einen Zugangsschlüssel
26
- erzeugen: Dashboard → API-Tokens
27
- 2. Lokal speichern:
10
+ [![npm](https://img.shields.io/npm/v/knowmind)](https://www.npmjs.com/package/knowmind) · [knowmind.de](https://knowmind.de)
28
11
 
29
- ```
30
- knowmind login --token kmt_xxxxxxxx
31
- ```
12
+ ## Connect your AI tool in three steps
32
13
 
33
- Alternativ über ENV:
14
+ 1. Create a free account at [knowmind.de](https://knowmind.de) and generate an access token: Dashboard → API tokens.
15
+ 2. Store the token locally:
34
16
 
35
17
  ```
36
- export KNOWMIND_TOKEN=kmt_xxxxxxxx
37
- export KNOWMIND_API_URL=https://knowmind.de
18
+ npx -y knowmind login --token kmt_xxxxxxxx
38
19
  ```
39
20
 
40
- ## Befehle
21
+ 3. Wire up your client:
41
22
 
23
+ **Claude Code** (one command)
42
24
  ```
43
- npx -y knowmind install <ide> MCP-Server im KI-Client verdrahten (claude, cursor, vscode …)
44
- knowmind init Automatische Gedächtnis-Pflege im KI-Client einrichten
45
- knowmind search "Wo läuft die OKR-App?"
46
- knowmind upload notizen.md --title "Meeting Notizen 2026-05-12"
47
- knowmind stats
48
- knowmind health
49
- knowmind status Lebenszeichen des Gedächtnisses (Report)
50
- knowmind status --line Einzeilige Statusline für Ihr KI-Werkzeug
51
- knowmind config
25
+ claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx -- npx -y knowmind mcp
52
26
  ```
53
27
 
54
- Die Statusline (`knowmind status --line`) zeigt knowmind als grüne Lampe direkt in Ihrem
55
- KI-Werkzeug: ruhig grün, wenn erreichbar, grünes Flackern wie eine Festplatten-LED, während
56
- knowmind arbeitet, rot bei Ausfall. `knowmind init --client claude-code` bindet sie
57
- automatisch ein (eine bereits vorhandene eigene Statusline bleibt unangetastet).
58
-
59
- ## Automatische Pflege einrichten (`knowmind init`)
60
-
61
- Damit Ihre KI knowmind selbsttätig pflegt — **Recall vor jeder Aufgabe**, **Sichern nach
62
- jeder sicherungswürdigen Runde** — richtet `knowmind init` die passenden Mechanismen für
63
- Ihren Client ein. Der Befehl erkennt den Client am Projekt- und Home-Verzeichnis
64
- (`.claude/`, `.cursor/`, `~/.codex/`) oder Sie wählen ihn explizit.
65
-
66
- ```
67
- knowmind init # Client automatisch erkennen
68
- knowmind init --client claude-code # gezielt für Claude Code
69
- knowmind init --client cursor # gezielt für Cursor
70
- knowmind init --dry-run # zeigt nur, was geschähe (schreibt nichts)
71
- ```
72
-
73
- **Was eingerichtet wird:**
74
-
75
- - **Claude Code** — projektlokale Hooks in `.claude/`:
76
- - *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall` auf und reicht die
77
- Top-Treffer als Kontext nach (Memory-First, automatisch).
78
- - *Stop* → erinnert die KI daran, mit `knowmind_store_memory` zu sichern, wenn die Runde
79
- Sicherungswürdiges enthielt (Deploy/Commit, neue Regel, Entscheidung) und noch nichts
80
- gespeichert wurde.
81
- - ein **Memory-First-Block** in `./CLAUDE.md` (mit `<!-- BEGIN/END knowmind -->`-Markern).
82
- - **Cursor** — `.cursor/rules/knowmind.mdc` mit der Memory-First-Regel (`alwaysApply`).
83
- - **Claude Desktop / Codex / generisch** — kein automatischer Hook-Mechanismus vorhanden;
84
- der Befehl zeigt den Memory-First-Text zum manuellen Einfügen (siehe Grenze unten).
85
-
86
- **Idempotent & nicht-destruktiv:** Ein zweiter Lauf erzeugt keine Duplikate
87
- (marker-/befehls-basierte Ersetzung); bestehende fremde Dateien und Hooks bleiben
88
- unangetastet. Mit `--dry-run` sehen Sie jede Aktion vorab.
89
-
90
- > **Grenze der Automatik:** Eine *harte* Erzwingung der Pflege gibt es nur in Clients mit
91
- > Hook-/Rule-Mechanismus (Claude Code, Cursor). In Clients ohne solchen Mechanismus
92
- > (z. B. Claude Desktop, Codex CLI) greifen die **MCP-instructions** (werden beim
93
- > Verbinden gelesen) und die **MCP-prompts** — eine modellabhängige Steuerung ohne
94
- > technische Garantie.
95
-
96
- ## MCP-Server einrichten
97
-
98
- knowmind ist ein MCP-Server (`npx -y knowmind mcp`, stdio). Token aus dem knowmind.de-Dashboard
99
- (→ API-Tokens) als `KNOWMIND_TOKEN`; optional `KNOWMIND_API_URL` (Standard `https://knowmind.de`).
100
-
101
- **Claude Code**
102
- ```
103
- claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx --env KNOWMIND_API_URL=https://knowmind.de -- npx -y knowmind mcp
104
- ```
105
-
106
- **Claude Desktop / Cursor / Windsurf / Cline / Continue / Goose / Zed** (`claude_desktop_config.json`, `~/.cursor/mcp.json`, …)
28
+ **Cursor** (`~/.cursor/mcp.json`) — also works for Claude Desktop, Windsurf, Cline, Continue, Goose, and Zed with their respective config files:
107
29
  ```json
108
30
  {
109
31
  "mcpServers": {
110
32
  "knowmind": {
111
33
  "command": "npx",
112
34
  "args": ["-y", "knowmind", "mcp"],
113
- "env": { "KNOWMIND_TOKEN": "kmt_xxx", "KNOWMIND_API_URL": "https://knowmind.de" }
35
+ "env": { "KNOWMIND_TOKEN": "kmt_xxx" }
114
36
  }
115
37
  }
116
38
  }
117
39
  ```
118
- > Windows-Hinweis: falls `npx` nicht direkt startet, `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
119
40
 
120
- **VS Code / GitHub Copilot** (`.vscode/mcp.json` — Top-Level `servers` + `inputs`)
121
- ```json
122
- {
123
- "inputs": [{ "id": "knowmind_token", "type": "promptString", "description": "Knowmind API token", "password": true }],
124
- "servers": {
125
- "knowmind": {
126
- "command": "npx",
127
- "args": ["-y", "knowmind", "mcp"],
128
- "env": { "KNOWMIND_TOKEN": "${input:knowmind_token}", "KNOWMIND_API_URL": "https://knowmind.de" }
129
- }
130
- }
131
- }
132
- ```
41
+ **Any other MCP client**: knowmind is a standard MCP server over stdio (`npx -y knowmind mcp`). On Windows, if `npx` does not start directly, use `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
133
42
 
134
- **Codex CLI** (`~/.codex/config.toml`)
135
- ```toml
136
- [mcp_servers.knowmind]
137
- command = "npx"
138
- args = ["-y", "knowmind", "mcp"]
139
- env = { KNOWMIND_TOKEN = "kmt_xxx", KNOWMIND_API_URL = "https://knowmind.de" }
140
- ```
43
+ `npx -y knowmind install <ide>` writes this configuration for you (e.g. `claude`, `cursor`, `vscode`), and `npx -y knowmind init` sets up automatic memory hygiene — recall before each task, store after each meaningful change — for clients with a hook or rule mechanism (Claude Code, Cursor).
141
44
 
142
- **Gemini CLI** (`~/.gemini/settings.json`) — gleiche `mcpServers`-Struktur wie Claude Desktop.
45
+ ## How knowmind stores facts
143
46
 
144
- **Remote (ohne lokale Installation)** — für Clients mit HTTP-MCP-Support direkt der gehostete Endpoint:
145
- ```json
146
- { "type": "http", "url": "https://knowmind.de/api/mcp/v1", "headers": { "Authorization": "Bearer kmt_xxx" } }
147
- ```
47
+ - **Bitemporal history.** Every fact carries two time axes: when it was true and when it was recorded. Corrections never overwrite the original; the old statement stays queryable with the date it stopped being valid, so you can reconstruct what the system knew on any given day.
48
+ - **Provenance and confidence per fact.** New facts require a confidence level and keep a link to their source. Older facts without a confidence level are marked as such.
49
+ - **Typed knowledge graph.** Entities and relations use a restricted set of edge types; catch-all relations are rejected at write time.
50
+ - **Operated in the EU, isolated per tenant.** The service runs on Hetzner in Nuremberg, Germany, with tenant isolation, a public data processing agreement, and a subprocessor list at [knowmind.de/legal/avv](https://knowmind.de/legal/avv). Access logs are hash-chained and externally timestamped (RFC 3161).
51
+
52
+ knowmind is a hosted service; there is no self-hosted community edition. If you need self-hosting, one of the projects below will serve you better. knowmind is built for the people and teams that need an operated memory service with an audit trail in the EU.
53
+
54
+ ## Pricing
148
55
 
149
- Token kann statt per `env` auch lokal via `knowmind login --token kmt_xxx` (→ `~/.knowmind/config.json`) hinterlegt werden.
150
-
151
- ## Tools (im MCP-Modus)
152
-
153
- Der MCP-Modus ist seit 0.1.18 ein reiner Proxy auf die Plattform: Tool-Namen,
154
- Schemas und Safety-Annotations kommen direkt vom Server und sind damit immer
155
- identisch mit dem Remote-Connector (`https://knowmind.de/api/mcp/v1`).
156
-
157
- - `knowmind_recall` — Hybride Suche im Wissensspeicher des Mandanten
158
- - `knowmind_recall_at_time` — Recall mit Zeitfilter (bi-temporal)
159
- - `knowmind_store_memory` — Neue Erinnerung anlegen (Titel + Inhalt)
160
- - `knowmind_upload_document` — Längeren Text als Dokument ingestieren (Upsert-per-Titel: gleicher Titel ersetzt die alte Version)
161
- - `knowmind_update_fact` — Fakt bi-temporal aktualisieren (Historie bleibt)
162
- - `knowmind_link` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
163
- - `knowmind_unlink` — Beziehung wieder entfernen (samt Inverse)
164
- - `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
165
- - `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
166
- - `knowmind_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
167
- - `knowmind_health` — Verfügbarkeits-Status der Plattform
168
-
169
- Inverse-Beziehungen (z. B. `IS_EMPLOYEE_OF` zu `HAS_EMPLOYEE`) werden
170
- serverseitig automatisch mit angelegt. Hinweis: `knowmind upload` als
171
- CLI-Befehl läuft über die REST-Schnittstelle (`/api/documents`), nicht über MCP.
172
-
173
- ## Daten in Deutschland
174
-
175
- knowmind wird in Deutschland betrieben: Ihre Inhalte (Memories, Account- und Metadaten) werden
176
- ausschließlich auf Servern in Deutschland (Hetzner-Rechenzentrum) gespeichert und verlassen Deutschland nicht.
177
- Auftragsverarbeitung (AVV) nach Art. 28 DSGVO verfügbar: https://knowmind.de/legal/avv
178
-
179
- **Hinweis (Bring-your-own-Key):** Wenn Sie eigene Schlüssel externer KI-Anbieter hinterlegen, werden Ihre
180
- Anfragen direkt an den von Ihnen gewählten Anbieter übermittelt. Sitzt dieser außerhalb der EU, kann dabei
181
- ein Drittlandtransfer stattfinden, für den Sie als Verantwortlicher zuständig sind.
182
-
183
- ## Haftung & Nutzung (Disclaimer)
184
-
185
- - **Software:** Dieses Paket steht unter der **Apache-Lizenz 2.0** und wird „AS IS" ohne jegliche
186
- Gewährleistung bereitgestellt; die Haftung ist im Rahmen der Lizenz (Abschnitte 7 und 8)
187
- ausgeschlossen bzw. beschränkt. Siehe `LICENSE`.
188
- - **Eigenes Konto, eigener Token:** knowmind bündelt keine Zugangsdaten. Sie nutzen Ihren eigenen
189
- knowmind.de-Account und API-Token. Anlegen: https://knowmind.de/dashboard/api-tokens
190
- - **Eigene Kosten/Verbrauch:** Jede Nutzung (API-Anfragen, Token-/Kontingentverbrauch, ggf.
191
- modellbezogene Kosten) erfolgt über Ihren eigenen Account und auf Ihre Verantwortung. Verbrauch
192
- und Kosten sind im knowmind.de-Dashboard transparent einsehbar.
193
- - **Service-Bedingungen:** Für die Nutzung der gehosteten Plattform gelten die AGB und die
194
- Datenschutzerklärung von knowmind.de:
195
- [AGB](https://knowmind.de/legal/agb) · [Datenschutz](https://knowmind.de/legal/datenschutz) ·
196
- [AVV](https://knowmind.de/legal/avv) · [Impressum](https://knowmind.de/legal/impressum)
197
- - **Kein Einsatz in sicherheitskritischen Bereichen:** knowmind ist ein Gedächtnis-/Recall-Dienst und
198
- **nicht** für den Betrieb von selbstfahrenden Fahrzeugen, kritischer Infrastruktur, medizinischen oder
199
- lebenserhaltenden Systemen oder sonstigen Anwendungen bestimmt, bei denen ein Fehler oder Ausfall zu Tod,
200
- Personen-, Umwelt- oder schweren Sachschäden führen kann. Ein Einsatz in solchen Umgebungen erfolgt auf
201
- alleiniges Risiko des Nutzers.
202
-
203
- Anbieter: Schübeler Consulting — Johann Jörgen Schübeler. Kontakt: info@schuebeler-consulting.de
56
+ | Tier | Price | For whom |
57
+ |---|---|---|
58
+ | Free | €0 | individuals and evaluation |
59
+ | Pro | €15/month or €150/year | individual professionals |
60
+ | Team | €99/month | teams with shared memory |
61
+ | Business | €349/month | larger teams |
62
+ | Enterprise | from €1,000/month | organizations with on-premise requirements |
63
+
64
+ The free tier includes 2,500 memories, 1 user, and a 30-day access log.
65
+
66
+ How that compares (vendor pricing pages, checked 2026-09-05):
67
+
68
+ | Product | Free tier | First paid tier | Self-hosting |
69
+ |---|---|---|---|
70
+ | knowmind | 2,500 memories | €15/month | no (Enterprise on-premise option) |
71
+ | Mem0 | 10,000 entries, 1,000 retrievals/month | $19/month | yes (Apache-2.0) |
72
+ | Zep | 10,000 credits/month | $125/month | Graphiti open source; Zep as BYOC |
73
+ | cognee | 1M tokens, 1 workspace | $2.50 per 1M tokens | yes |
74
+ | Letta | limited agents, own keys | $20/month | yes (per vendor) |
75
+ | Supermemory | ~$5 usage included | $19/month | from Scale tier |
76
+
77
+ Details and current prices: [knowmind.de/pricing](https://knowmind.de/pricing).
78
+
79
+ ## Commands
80
+
81
+ ```
82
+ npx -y knowmind search "Where does the staging deploy run?"
83
+ npx -y knowmind upload notes.md --title "Meeting notes 2026-05-12"
84
+ npx -y knowmind stats
85
+ npx -y knowmind health
86
+ npx -y knowmind status --line # one-line status for your AI tool's statusline
87
+ ```
88
+
89
+ ## Available Tools
90
+
91
+ Thirteen tools over MCP. Every one works against your own workspace; the server
92
+ never sees another tenant's data.
93
+
94
+ ### Reading
95
+
96
+ **`knowmind_recall`** — Search your memory and get the passages that answer a
97
+ question, ranked. Combines keyword search, vector similarity and the knowledge
98
+ graph, then reranks with a cross-encoder.
99
+ `query` (string, required) · `k` (integer, default 5, max 20) · `hops` (integer,
100
+ default 2 — how far to follow graph edges from a hit)
101
+ *Usage:* your AI tool asks "Which database does the billing service use?" before
102
+ answering, instead of guessing.
103
+ *Errors:* returns an empty result set when nothing matches — never an invented
104
+ answer.
105
+
106
+ **`knowmind_recall_at_time`** — The same search, but as your memory stood on a
107
+ given date. Facts superseded after that date are excluded; facts that were valid
108
+ then are returned even if they are no longer true.
109
+ `query` (string, required) · `as_of` (ISO date or timestamp, required in
110
+ practice) · `k` (integer, default 5)
111
+ *Usage:* "What was our pricing in March?" — answers from the state of that day,
112
+ not today's.
113
+ *Difference from `knowmind_recall`:* use `recall` for what is true now, and
114
+ `recall_at_time` for what was true then. Asking `recall` about the past returns
115
+ today's facts.
116
+
117
+ **`knowmind_list_recent`** — The most recently added entries, newest first.
118
+ `k` (integer, default 10)
119
+ *Usage:* a quick look at what landed in memory during this session.
120
+
121
+ **`knowmind_list_relations`** — All typed edges attached to one entry, in both
122
+ directions.
123
+ `memory_id` (string, required)
124
+ *Usage:* "What does this contract connect to?" before changing or superseding it.
125
+ *Errors:* unknown id returns an error, not an empty list.
126
+
127
+ **`knowmind_schema`** — The entity classes and relation types this workspace
128
+ accepts. No parameters.
129
+ *Usage:* call it before `knowmind_entity` or `knowmind_link` to use a type the
130
+ server will accept, rather than inventing one.
131
+
132
+ **`knowmind_stats`** — Size of the corpus: documents, chunks, entities, edges.
133
+ No parameters.
134
+
135
+ **`knowmind_health`** — Whether the service and its stores are reachable. No
136
+ parameters.
137
+ *Usage:* a status line, or a check before a long ingest.
138
+
139
+ ### Writing
140
+
141
+ **`knowmind_store_memory`** — Store a short fact, decision or note. Stays as one
142
+ unit; it is not split.
143
+ `content` (string, required) · `title` (string) · `memory_type` (string, e.g.
144
+ `semantic`, `episodic`) · `tags` (array of strings) · `source` (string) ·
145
+ `domain` (string) · `relations` (array — edges to create along with the entry)
146
+ *Usage:* "We decided to keep the monolith until Q3" after a meeting.
147
+ *Errors:* rejected with 422 when the text contains what looks like a password or
148
+ an access key. Store a pointer instead, not the secret.
149
+
150
+ **`knowmind_upload_document`** — Store a longer text as a document. It is split
151
+ into passages, embedded, and becomes searchable through `knowmind_recall`.
152
+ `content` (string, required) · `title` (string) · `source` (string) ·
153
+ `relations` (array)
154
+ *Usage:* meeting minutes, a specification, a handbook chapter.
155
+ *Difference from `knowmind_store_memory`:* one sentence you want back verbatim is
156
+ a memory; a page you want searched is a document. A long text stored as a memory
157
+ is retrieved as one block, which crowds out other results.
158
+
159
+ **`knowmind_update_fact`** — Supersede a fact that has changed. The old version
160
+ keeps its validity window and stays auditable; nothing is deleted.
161
+ `target_id` (string, required) · `new_title` (string, required) · `new_content`
162
+ (string, required) · `update_reason` (string)
163
+ *Usage:* a price, a deadline or a responsibility changed. Never overwrite —
164
+ supersede, so "what did we believe in July" stays answerable.
165
+ *Errors:* unknown `target_id` is rejected.
166
+
167
+ **`knowmind_entity`** — Create or update a typed entity (a person, a company, a
168
+ product) with aliases.
169
+ `name` (string, required) · `entity_class` (string, required — see
170
+ `knowmind_schema`) · `description` (string) · `aliases` (array of strings)
171
+ *Usage:* give "ACME Ltd." its aliases so a question about "ACME" finds it.
172
+ *Errors:* a class outside the schema is rejected.
173
+
174
+ **`knowmind_link`** — Create a typed edge between two entries, with a confidence
175
+ value.
176
+ `from_id` (string, required) · `to_id` (string, required) · `rel_type` (string,
177
+ required — see `knowmind_schema`) · `confidence` (number 0–1)
178
+ *Usage:* connect a contract to the client it belongs to. The inverse edge is
179
+ created for you.
180
+
181
+ **`knowmind_unlink`** — Remove a typed edge.
182
+ `from_id`, `to_id`, `rel_type` (all required)
183
+ *Usage:* an edge created in error. The entries themselves stay.
184
+
185
+ ### On deleting
186
+
187
+ There is no delete tool, and that is deliberate. Facts are superseded
188
+ (`knowmind_update_fact`), edges are removed (`knowmind_unlink`), and the history
189
+ stays auditable. Deleting an entire workspace including its data is a
190
+ self-service action in the web interface at
191
+ [knowmind.de](https://knowmind.de) — it is not something an agent should be able
192
+ to do by calling a tool.
193
+
194
+ ### Discovery
195
+
196
+ `GET https://knowmind.de/api/mcp/v1` returns name, version, protocol version and
197
+ the full tool list with input schemas — without a token. Directory crawlers and
198
+ inspectors can read the complete surface anonymously; only `tools/call` requires
199
+ a key.
200
+
201
+ ## Links
202
+
203
+ [Documentation](https://knowmind.de/docs) · [Pricing](https://knowmind.de/pricing) · [Data processing agreement](https://knowmind.de/legal/avv) · [Privacy](https://knowmind.de/legal/datenschutz)
204
+
205
+ ---
206
+
207
+ Die deutsche Fassung steht in [README.de.md](README.de.md).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "knowmind",
3
- "version": "0.3.4",
3
+ "version": "0.3.6",
4
4
  "mcpName": "io.github.Schubeler-Consulting/knowmind",
5
5
  "description": "Knowmind — das Agentengehirn aus Deutschland: CLI + MCP-Server (Langzeitgedächtnis & Wissensgraph für Ihre KI, Server in Deutschland).",
6
6
  "type": "module",
@@ -31,10 +31,12 @@
31
31
  "!src/*.test.js",
32
32
  "README.md",
33
33
  "CHANGELOG.md",
34
- "LICENSE"
34
+ "LICENSE",
35
+ "scripts"
35
36
  ],
36
37
  "scripts": {
37
- "test": "node --test src/*.test.js"
38
+ "test": "node --test src/*.test.js",
39
+ "tools:abgleich": "node scripts/tools-abgleich.mjs"
38
40
  },
39
41
  "dependencies": {
40
42
  "@huggingface/transformers": "^3.5.0"