Die KynxGate Dokumentation

KynxGate ist eine private Control-Plane für eigene Software: Sie nimmt Git-Repositories, baut und startet sie in isolierten Containern, hängt Domains mit SSL an und hält Logs, Workspaces und Live-Previews an einem Ort. Dazu kommen zwei Bausteine, die KynxGate besonders machen:

• LiveDocker — schnelle Projektarbeit: Code, Preview, Terminal, Datenbank und der KynxGate-Agent in einer Ansicht. Ideal zum Prototypen und Iterieren.
• Der KynxGate-Agent — ein KI-Agent, der direkt im Projekt arbeitet: Dateien lesen/schreiben, Befehle ausführen, die echte Preview prüfen (inkl. Screenshot- und Vision-Analyse) und sauber zusammenfassen, was er getan hat.

Für Spiele gibt es einen eigenen Godot-Flow: aus einer Idee entsteht ein Plan, Assets werden generiert, und der Agent baut das Spiel inklusive automatischer Playtests.

KynxGate hat keinen öffentlichen Signup. Der Zugang läuft über Einladung bzw. bestehende Konten:

Abmelden, Kontoeinstellungen und Geräte-Verwaltung findest du im Kopfbereich unter deinem Profilmenü („Einstellungen").

Die Oberfläche gibt es auf Deutsch, Englisch, Französisch und Español — umschaltbar über das Sprachmenü im Kopfbereich. Die Wahl wird pro Gerät gespeichert (Cookie + lokaler Speicher). Agenten-Antworten richten sich nach der Sprache deines Auftrags bzw. der Oberflächensprache.

Hell- und Dunkel-Theme lassen sich im Kopfbereich umschalten. Die Weboberfläche ist responsiv — auf dem Telefon klappen Chat und Preview in Tabs auseinander.

Ein Workspace ist ein Behälter für Projekte — vergleichbar mit einer Organisation. Über das Workspace-Menü im Kopfbereich wechselst du zwischen ihnen:

• Eigene Workspaces — du bist Owner und kannst frei Projekte anlegen.
• Geteilte Workspaces — du wurdest als Mitglied hinzugefügt und siehst die gemeinsamen Projekte.

Workspaces lassen sich favorisieren und individuell sortieren(Ziehen mit der Maus). Die Sortierung ist pro Nutzer persönlich und ändert nichts für andere. Neue Workspaces legst du im Dashboard an.

Wer gerade im Projekt ist, siehst du an den Live-Avataren im Kopfbereich der Projektansicht (siehe Live-Presence).

Deploy-Projekte werden aus einem Git-Repository gebaut: KynxGate klont, baut, startet im Container und hängt eine Domain an. Jedes Deployment durchläuft einen Build mit Health-Check — erst wenn die App antwortet, wird sie live geschaltet (Zero-Downtime: der alte Container läuft weiter, bis der neue bereit ist).

In der Deploy-Ansicht siehst du den aktuellen Status, Build- und Laufzeit-Logs in Echtzeit, die verbundene Domain und den letzten Commit. Aktionen:

• Redeploy — denselben Stand neu bauen und starten.
• Stop / Start — Container anhalten bzw. wieder anfahren.
• Neue Deployments — ein Push auf den Branch oder ein manuelles Redeploy startet einen frischen Build.

LiveDocker ist die schnelle Werkbank: Ein Projekt besteht aus der Live-Preview, dem Agent-Chat, dem Workspace (Dateien, Konsole, Logs, Env, DB, Keys) und — bei Godot-Projekten — dem Spiel-Flow. Alles in einer Ansicht, live.

Oben siehst du die Live-Avatare aller anwesenden Nutzer, die Tab-Leiste (Preview/Terminal/Dateien) und links den Agent-Chat mit den Modi Agent, Plan und Auto.

Die Preview zeigt deine App live unter ihrer projekt.up.kynxgate.de-Adresse. Du navigierst in der Preview wie in einem normalen Browser — inklusive Unterseiten und Login-Zuständen der App.

• Gerätemodi (oben rechts: PC / Tablet / Phone) — die Preview wird in die passende Bildschirmbreite gerahmt, perfekt für responsive Checks.
• Live / Calm — „Live" aktualisiert die Preview sofort bei jeder Dateiänderung; „Calm" bündelt Aktualisierungen ruhiger.
• Extern öffnen — der Pfeil-Button öffnet die App in einem echten Browser-Tab.

Der Workspace-Bereich des Projekts bündelt alles Technische:

• Dateien — Projektbaum mit Editor und Diff-Ansicht; Änderungen speicherst du direkt hier.
• Konsole/Terminal — echte Shell im Projekt.
• Logs — Live-Logs des laufenden Dev-Servers.
• Env — Umgebungsvariablen und Secrets des Projekts.
• DB — Datenbank-Anbindung des Projekts.
• Keys — projektspezifische API-Keys (z. B. für Modelle), die nur hier gelten.

Wenn aus dem Prototyp ein echtes Projekt werden soll, übernimmt Publish den Stand in ein Git-Repository: Commits mit aussagekräftiger Message, danach klassisches Deploy. So verlierst du nie Arbeit — und kannst im Repo weitermachen.

Bilder sagen dem Agenten mehr als lange Texte — KynxGate bietet drei Wege:

Der Chat-Eingabe hat drei Modi, links unten umschaltbar:

• Agent — der Allrounder: versteht die Aufgabe, arbeitet direkt Dateien ab, prüft die Preview und fasst am Ende zusammen. Für die meisten Aufträge richtig.
• Plan — erst denken, dann tun: Der Agent erstellt einen strukturierten Plan (Ziele, Schritte, Akzeptanzkriterien), den du prüfen, anpassen oder „Nochmal schärfen" lassen kannst. Danach per Klick in den Build übergehen.
• Build — setzt einen vorhandenen Plan Punkt für Punkt um, mit Aufgabenliste, die live abgehakt wird. Abschlüsse werden verweigert, solange Aufgaben offen oder die Preview fehlerhaft sind.

Über das Modell-Menü („Auto" oder Modellname) wählst du, mit welchem Modell der Agent arbeitet. Auto ist die empfohlene Voreinstellung: Die Plattform wählt automatisch ein geeignetes Modell (mit Thinking-/Worker-Aufteilung) und weicht bei Überlastung auf Ersatzmodelle aus. Eigene API-Keys kannst du in den Einstellungen hinterlegen (BYOK) — projektspezifische Keys im Workspace-Tab Keys.

Zusätzlich gibt es Denkmodi (Reasoning): mehr Nachdenken für knifflige Aufgaben, schneller Modus für Kleinkram.

Ein guter Auftrag nennt Ziel, Ort und Akzeptanz: „In der Seitenleiste fehlt der Track-Medium-Hinweis (Screenshot) — behebe das in der Studio-Seite, akzeptiert ist, wenn der Upload dort erscheint."

• Während des Laufs siehst du jeden Schritt live: Nachdenken, Datei-Änderungen, Befehle, Preview-Reloads.
• Stop bricht sauber ab; „Fortsetzen" nimmt den Lauf exakt dort wieder auf.
• Nachträge einfach als neue Nachricht schreiben — auch während der Agent läuft (landet in der Warteschlange).
• Zusammenfassung — am Ende bekommst du eine strukturierte Zusammenfassung (Markdown mit Abschnitten, Listen, Code) und kannst akzeptieren, zurücksetzen (Undo) oder weiterreden.

Jeder Lauf kann eine Aufgabenliste führen (Todo-Liste im Chat). Bei Plan-/Build-Läufen entsteht ein echter Plan mit Abschnitten, Mermaid-Diagrammen und Akzeptanzkriterien — als eigener Plan-Tab im Projekt. Die Aufgaben dort werden live abgehakt; die Plattform hakt nichts ab, was nicht belegt ist.

Läuft der Agent gerade, landet dein nächster Prompt in der Warteschlange (unten im Chat sichtbar, Position ablesbar, Einträge verschiebbar/editierbar). Zwei Schalter steuern die Automatik:

• Auto-Send — startet den nächsten Warteschlangen-Eintrag automatisch, sobald der Agent frei ist.
• Auto-Accept — nimmt Fertig-Zusammenfassungen automatisch ab (inkl. Git-Commit), statt auf deinen Klick zu warten.

„Sofort senden" auf einem Warteschlangeneintrag bricht den laufenden Agent kontrolliert ab und startet den Eintrag sofort.

Über Cron Jobs im Chat-Header legst du zeitgesteuerte Agent-Aufträge an: als Intervall (z. B. alle 30 Min), täglich, wöchentlich (Wochentage wählbar) oder einmalig. Zeiten gelten für Berlin. Pro Projekt sind bis zu 30 Jobs möglich; deaktivierte Jobs bleiben gespeichert.

Pro Job wählst du Modus (Agent/Plan/Build) und was bei Fälligkeit passiert: Starten (startet den Prompt sofort, auch wenn gerade niemand den Chat offen hat) oder Einreihen (wartet in der Queue auf Auto-Send).

Der Agent kann projektwichtiges Wissen dauerhaft behalten: Entscheidungen, Konventionen, Stoßzeiten, Domain-Wissen. Das Memory wächst automatisch aus abgeschlossenen Läufen (ein Kurator fasst zusammen, aktualisiert und entfernt Veraltetes) und ist im Memory-Modal einsehbar und editierbar. Neu gestartete Läufe berücksichtigen es — der Agent „vergisst" dein Projekt also nicht.

Godot-Projekte haben einen geführten Flow: Idee eingeben → der Agent stellt dir ein kurzes Interview (Kamera-Perspektive, Stil, Aufwand) → Plan-Theater: der Spielplan entsteht sichtbar (Kernschleife, Verdrahtung, Asset-Liste) → bestätigen.

Der Asset-Plan generiert selbstständig alle geplanten Medien: Bilder (Splash, Menü, Texturen, Icons), Sounds (Musik, Effekte, Voice-Over) und 3D-Modelle inklusive Kollision. Die Galerie zeigt den Fortschritt pro Asset; fertige Stücke landen direkt im Projekt. Die Figurenwahl zeigt Varianten zur Auswahl — bestätigte Figuren bekommen Modell, Steuerung und Animationen.

In Godot-Projekten hat der Agent Werkzeuge, die du auch selbst im Terminal nutzen kannst (bash .Kynx/bin/kg-game …):

• check — Projektdurchsicht auf typische Fehler (Sekunden, immer der erste Griff).
• export — Web-Export bauen und Fehler melden.
• playtest — Spiel im Browser starten, Tasten drücken, prüfen ob es läuft. Ein Abschluss gilt nur mit bestandenem Playtest.
• character / prop / sound / image / video — spielbereite Figuren, Kulissen mit Kollision, Klänge und Medien ins Projekt holen.

Oben in der Projekt-Kopfzeile siehst du die Avatare aller, die das Projekt gerade offen haben — inklusive dir selbst, mit grünem Live-Punkt. Ein Hover zeigt Name und Hinweis; ein Klick öffnet das Profil:

• Projekte auf KynxGate — wie viele LiveDocker-Projekte, Godot-Games und Deploys die Person hat.
• Token-Verbrauch — letzte Woche und gesamt, inklusive Anzahl Agent-Läufe.
• Top-Modelle — die meistgenutzten Modelle als Verhältnisbalken.

Stats sind innerhalb der privaten Plattform für angemeldete Nutzer einsehbar — bewusst, als Transparenz und Motivation.

Mehrere Personen können gleichzeitig im selben Projekt arbeiten: Chat-Nachrichten, Läufe, Preview- und Datei-Änderungen sowie Pläne werden in Echtzeit zwischen allen offenen Ansichten synchronisiert. Läuft jemandes Agent, siehst du dessen Schritte live (mit Namen gekennzeichnet); Bestätigungskarten (Accept/Undo/Fortsetzen) erscheinen bei allen Beteiligten und können von jedem Berechtigten bedient werden — einmal bedient, ist sie für alle entschieden.

Geplante Erweiterungen vor dem Release: öffentliche Registrierung, rechtliche Seiten (Impressum/Datenschutz), erweiterte Rollen-Verwaltung und weitere Automatisierungs-Features.

Projekt-Aufbau-Doku (/doku) — für technischere Fragen: Repository-Struktur, Port/Host-Regeln, Health-Checks, Dockerfiles, Vite/Static-SPAs, Datenbanken & Volumes, Zero-Downtime und die API Control (Status, Logs, Redeploy) samt Browser-Test-API für autonome Agenten.

Fragen, Fehler oder Wünsche? Direkt im Agent-Chat melden — oder dem Team schreiben. Diese Dokumentation wächst mit der Plattform mit.