knowmind 0.3.5 → 0.3.7

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/CHANGELOG.md CHANGED
@@ -1,5 +1,23 @@
1
1
  # Knowmind CLI — Änderungen
2
2
 
3
+ ## 0.3.7 (2026-09-07)
4
+
5
+ - Veröffentlichung über GitHub Actions: Das Paket wird ohne dauerhaften Token
6
+ ausgeliefert, und jede Veröffentlichung trägt einen Herkunftsnachweis.
7
+
8
+ ## 0.3.6 (2026-09-07)
9
+
10
+ **Die Werkzeugliste steht auch ohne Netz zur Verfügung**
11
+ - `tools/list` beantwortete der Server bisher ausschließlich über die
12
+ öffentliche Discovery auf knowmind.de. War der Weg dorthin versperrt — eine
13
+ Sandbox ohne Netz, ein Verzeichnis-Crawler hinter einer Firewall —, bekam der
14
+ Aufrufer einen Fehler und sah kein einziges Werkzeug. Das Paket bringt die
15
+ Liste jetzt mit und nutzt sie, wenn die Discovery nicht antwortet; ein
16
+ Hinweis auf der Fehlerausgabe nennt den Stand.
17
+ - `npm run tools:abgleich` vergleicht die mitgelieferte Liste mit der
18
+ Discovery und schlägt an, sobald beide auseinanderlaufen.
19
+ - Verbesserungen der Stabilität.
20
+
3
21
  ## 0.3.2 (2026-08-04)
4
22
 
5
23
  **`knowmind install`: zwei neue Ziele, ein Befehl richtet alles ein**
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).