126 lines
4.4 KiB
Markdown
126 lines
4.4 KiB
Markdown
# ai-memory auf AZ-LT-NIX anbinden
|
|
|
|
Schritt-für-Schritt-Anleitung, um die Arbeits-Workstation an den zentralen
|
|
ai-memory-Server (`https://memory.m3ta.dev`, läuft auf m3-hermes) anzubinden.
|
|
Alles auf AZ-LT-NIX landet im Workspace `az`.
|
|
|
|
Voraussetzungen, die bereits erledigt sind:
|
|
|
|
- Server, Traefik-Route und der Nutzer `sascha` existieren.
|
|
- Der `aim_`-Key mit Label `az-lt-nix` ist ausgestellt und liegt verschlüsselt
|
|
(für den Host-Key von AZ-LT-NIX und den Benutzer-Key `sascha.koenig`) im
|
|
Patch unten.
|
|
- m3ta-home `master` enthält das Modul `coding.aiMemory` (ab Commit `9633512`).
|
|
|
|
## 1. Patch auf AZ-LT-NIX holen
|
|
|
|
Der Patch liegt auf m3-kratos unter
|
|
`/home/m3tam3re/p/AZ/0001-feat-AZ-LT-NIX-enable-ai-memory-client.patch`.
|
|
Er enthält die vier Änderungen (`secrets.nix`, `hosts/AZ-LT-NIX/secrets.nix`,
|
|
`hosts/common/users/sascha.koenig.nix`, `secrets/ai-memory-token.age`) und
|
|
wurde mit `--binary` erzeugt, damit die `.age`-Datei byteidentisch ankommt.
|
|
|
|
```bash
|
|
# auf AZ-LT-NIX, in einem leeren Verzeichnis oder dem Repo-Ordner
|
|
scp m3-kratos:/home/m3tam3re/p/AZ/0001-feat-AZ-LT-NIX-enable-ai-memory-client.patch .
|
|
```
|
|
|
|
## 2. Patch anwenden
|
|
|
|
```bash
|
|
cd ~/p/NIX/AZ-NIX-CLIENTS # oder wo das Repo liegt
|
|
git checkout master && git pull --ff-only
|
|
git am ../0001-feat-AZ-LT-NIX-enable-ai-memory-client.patch
|
|
```
|
|
|
|
Erwartet: ein neuer Commit `feat(AZ-LT-NIX): enable ai-memory client`.
|
|
|
|
Gegencheck, dass das Secret für diesen Host lesbar ist:
|
|
|
|
```bash
|
|
age -d -i ~/.ssh/sascha.koenig secrets/ai-memory-token.age | cut -c1-4
|
|
```
|
|
|
|
Erwartet: `aim_`.
|
|
|
|
## 3. m3ta-home auf den aktuellen Stand ziehen
|
|
|
|
```bash
|
|
nix flake update m3ta-home
|
|
git add flake.lock
|
|
git commit -m "chore: bump m3ta-home (ai-memory client)"
|
|
```
|
|
|
|
Der Lock muss mindestens auf m3ta-home `9633512` zeigen. Wenn der Pull über
|
|
SSH nach `code.m3ta.dev` scheitert, den Flake-Input vorübergehend auf
|
|
`git+https://code.m3ta.dev/m3tam3re/m3ta-home` stellen.
|
|
|
|
## 4. Bauen und switchen
|
|
|
|
```bash
|
|
nix build .#nixosConfigurations.AZ-LT-NIX.config.system.build.toplevel
|
|
sudo nixos-rebuild switch --flake .#AZ-LT-NIX
|
|
```
|
|
|
|
In der Activation-Ausgabe darf **keine** Zeile
|
|
`ai-memory: token file /run/agenix/ai-memory-token missing, skipping`
|
|
stehen. Steht sie da, hat agenix das Secret nicht entschlüsselt (Host-Key
|
|
prüfen: `ssh-keyscan -t ed25519 localhost` gegen `secrets.nix`).
|
|
|
|
## 5. Prüfen
|
|
|
|
```bash
|
|
# Token und Client-Config
|
|
ls -la /run/agenix/ai-memory-token ~/.local/share/ai-memory/auth-token
|
|
cat ~/.local/share/ai-memory/config.toml # server_url + bearer_token_file
|
|
cat ~/.ai-memory.toml # workspace = "az"
|
|
|
|
# Claude Code: Hooks zeigen auf den Server, MCP ist die stdio-Bridge
|
|
grep -c 'memory.m3ta.dev' ~/.claude/settings.json # > 0
|
|
claude mcp get ai-memory # Status: Connected, Type: stdio
|
|
|
|
# OpenCode: Plugin und MCP-Eintrag
|
|
grep -o 'const SERVER = "[^"]*"' ~/.config/opencode/plugins/ai-memory-opencode2.ts
|
|
grep -A4 '"ai-memory"' ~/.config/opencode/opencode.json
|
|
```
|
|
|
|
Dann eine kurze Claude-Code-Session und eine OpenCode-Session in einem
|
|
Arbeits-Repo starten und wieder beenden. Danach von kratos aus:
|
|
|
|
```bash
|
|
ai-memory list-projects
|
|
```
|
|
|
|
Erwartet: das Repo erscheint im Workspace `az`.
|
|
|
|
## 6. Pushen
|
|
|
|
```bash
|
|
git push origin master
|
|
```
|
|
|
|
## Was das Modul auf dem Host macht
|
|
|
|
- Nix schreibt `~/.local/share/ai-memory/config.toml` (Server-URL,
|
|
`bearer_token_file = /run/agenix/ai-memory-token`), den MCP-Eintrag in
|
|
`opencode.json` und den Marker `~/.ai-memory.toml` mit `workspace = "az"`
|
|
plus den Capture-Ausschlüssen.
|
|
- Die Activation verlinkt `~/.local/share/ai-memory/auth-token` auf das
|
|
Secret (Hooks und OpenCode-Plugin lesen diesen Pfad), ruft
|
|
`ai-memory install-hooks` für Claude Code und OpenCode2 auf, registriert
|
|
für Claude Code die session-aware stdio-Bridge und installiert die Skills
|
|
nach `~/.agents/skills`.
|
|
- Der Token steht in keiner generierten Datei. Die MCP-Bridge liest ihn aus
|
|
der Client-Config, Hooks und Plugin über den `auth-token`-Symlink.
|
|
|
|
## Bekannte Grenzen
|
|
|
|
- `ai-memory doctor`, `recent` und `search` im Terminal brauchen den
|
|
Root-Bearer und antworten mit dem Host-Key `403`. Agents über MCP sind
|
|
nicht betroffen.
|
|
- Ist der Server nicht erreichbar, puffern die Hooks lokal in
|
|
`~/.local/share/ai-memory/hook-spool` und liefern nach.
|
|
- Key rotieren: auf m3-hermes `ai-memory api-key rotate` für Label
|
|
`az-lt-nix`, neuen Wert mit `age -r <AZ-LT-NIX> -r <sascha.koenig>` in
|
|
`secrets/ai-memory-token.age` schreiben, switchen.
|