// architektur // timeline
navigieren
// codex — homelab project

Ein KI-Assistent
lernt sein Zuhause
kennen.

Wie ein Homelab zum externen Gedächtnis wurde —
und eine KI aufhörte, jeden Tag neu anzufangen.

// 01 — das problem

Jedes Gespräch
beginnt bei null.

Kein Gedächtnis an gestern. Kein Wissen darüber, welche Geräte im Netzwerk laufen, welche IP der Shelly im Wohnzimmer hat, oder wie der Proxmox-Host heißt.


Wer ein Homelab betreibt, erklärt dieselben Dinge immer wieder — und hofft, dass Claude die richtigen Schlüsse zieht.


Das muss nicht so sein.

// 02 — die idee

Ein Gedächtnis,
das bleibt.

Was wäre, wenn Claude das Homelab kennen würde?


Nicht durch Crawling — sondern dadurch, dass Wissen, das einmal erklärt wurde, dauerhaft gespeichert bleibt. Strukturiert. Versioniert. Abrufbar.

konzept # Rolf erklärt einmal:
"IP 192.168.10.106
ist der Shelly im
Wohnzimmer"

# Claude speichert → Codex
hostname: shelly-wohnzimmer
ip: 192.168.10.106
room: EG

# Nächste Session: bekannt.
// 03 — der erste server

Claude bekommt
Augen.

Ein MCP-Server auf einem LXC-Container verwandelt die Datenbank in echte Werkzeuge. Claude kann nicht mehr nur antworten — er kann handeln.

🔍
Geräte nachschlagen
SQLite DB mit allen bekannten Hosts, IPs, Rollen
📡
Status abfragen
Online/Offline, Port-Checks, LXC-Ressourcen
Direkt handeln
Shellys schalten, Container starten, DNS setzen
🔒
Permissions
read_only & confirm-Flags pro Gerät
// 04 — connectoren

Die Brücke zwischen
Claude und dem Homelab.

MCP-Connectoren sind standardisierte Schnittstellen — Claude stellt eine Anfrage, der Connector führt sie aus. Kein Copy-Paste, kein manuelles Zwischenschalten.


Jeder Connector erschließt eine neue Domäne. Zusammen ergeben sie ein System, in dem Claude handelt, prüft, schreibt, startet, dokumentiert.

Codex
Gedächtnis des Homelabs
Home Assistant
Nervensystem der Hausautomation
Forgejo
Versionssystem für Code & Wissen
Proxmox
Schaltzentrale für VMs & Container
// 05 — wachstum

Tool für Tool.

Ein System entsteht nicht auf einmal — es wächst mit den Aufgaben. Jedes neue Bedürfnis brachte ein neues Werkzeug.


Nicht alles funktionierte sofort. Jeder Fehler wurde zum Lernmoment, jede Korrektur direkt ins Repo committed.


Das System dokumentiert sich selbst.

Shellys schalten — direkter Zugriff auf Smart-Home
Home Assistant — Entitäten lesen, Services starten
Technitium — DNS-Einträge, DHCP-Reservierungen
Proxmox — Container starten, klonen, skalieren
FritzBox — Netzwerk-Übersicht, WAN-Status
Graylog — Logs durchsuchen, Inputs verwalten
// 06 — die entscheidende erkenntnis

Claude schreibt
sich selbst.

Irgendwann kippte etwas.


Claude hörte auf, nur ein Werkzeug zu benutzen — und begann, selbst Werkzeuge zu schreiben. Helper-Scripts für die VPS, Automatisierungen für den Mailserver.


Neue Fähigkeiten erkennen, implementieren, ins Repo pushen — und beim nächsten Gespräch sofort nutzen.

auto-deploy # Claude erkennt Bedarf
# → schreibt Helper
helpers/vps/docker_ps.py
helpers/fritzbox/status.py

# → committed ins Repo
git commit -m "feat: helper"
git push origin main

# → deployed & live
bash update.sh
# ✓ Service restarted
// 07 — ordnung

Ein System, das sich
selbst erklärt.

Mit wachsender Komplexität kam Struktur. Der monolithische Server wurde modularisiert. Und dann entstand etwas Besonderes:

📖
SKILL.md
Claude lädt beim Start jeder Homelab-Aufgabe seine eigene Anleitung aus dem Repo
🪩
Module
tools.md · workflows.md · secrets.md · eigenheiten.md
🔄
Self-Update
Neues Tool → Skill wird aktualisiert → nächste Session weiß es

Kein Upload. Kein manuelles Einstellen. Das System beschreibt sich selbst, versioniert wie jede andere Software.

// 08 — diese präsentation

Deployed von dem
System, über das
sie erzählt.

Diese Präsentation ist kein Sonderfall — sie ist ein Beweis.


Claude hat die Geschichte geschrieben, die Website gebaut und sie auf die VPS deployed — über denselben SSH-Zugang und dieselben Docker-Workflows, die im Projekt entwickelt wurden.


Das Homelab präsentiert sich selbst.

MD geschrieben — Story aus Gesprächshistorie destilliert
VPS erkundet — Traefik-Setup verstanden via ssh_exec
HTML gebaut — Präsentation aus Markdown generiert
Docker Compose — Stack nach bestehendem Muster erstellt
Deployed & live — HTTPS via Traefik + Let's Encrypt
// 09 — vision

Ein Assistent,
der mitdenkt.

Was heute funktioniert, ist erst der Anfang. Die Richtung ist klar.

Monitoring
Anomalien in Logs erkennen, bevor sie zu Problemen werden
Proaktiv
Ressourcen beobachten, Empfehlungen geben, warnen
Lernend
Neue Geräte aufnehmen, sobald sie auftauchen
Vertrauenswürdig
Fragt, bevor es etwas Irreversibles tut
Selbsterweiternd
Neue Fähigkeiten erkennen und selbst implementieren
Partner
Kennt das Homelab so gut wie sein Betreiber
// fin
Begonnen hat es mit einer Frage über Syslog.
Entstanden ist ein Homelab, das spricht.
codex-homelab/codex · git.datenco.de