4.4 KiB
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
saschaexistieren. - Der
aim_-Key mit Labelaz-lt-nixist ausgestellt und liegt verschlüsselt (für den Host-Key von AZ-LT-NIX und den Benutzer-Keysascha.koenig) im Patch unten. - m3ta-home
masterenthält das Modulcoding.aiMemory(ab Commit9633512).
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.
# 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
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:
age -d -i ~/.ssh/sascha.koenig secrets/ai-memory-token.age | cut -c1-4
Erwartet: aim_.
3. m3ta-home auf den aktuellen Stand ziehen
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
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
# 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:
ai-memory list-projects
Erwartet: das Repo erscheint im Workspace az.
6. Pushen
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 inopencode.jsonund den Marker~/.ai-memory.tomlmitworkspace = "az"plus den Capture-Ausschlüssen. - Die Activation verlinkt
~/.local/share/ai-memory/auth-tokenauf das Secret (Hooks und OpenCode-Plugin lesen diesen Pfad), ruftai-memory install-hooksfü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,recentundsearchim Terminal brauchen den Root-Bearer und antworten mit dem Host-Key403. Agents über MCP sind nicht betroffen.- Ist der Server nicht erreichbar, puffern die Hooks lokal in
~/.local/share/ai-memory/hook-spoolund liefern nach. - Key rotieren: auf m3-hermes
ai-memory api-key rotatefür Labelaz-lt-nix, neuen Wert mitage -r <AZ-LT-NIX> -r <sascha.koenig>insecrets/ai-memory-token.ageschreiben, switchen.