Web

Matrix kann als Webanwendung in Ihrem Browser ausgeführt werden und bietet das gleiche leistungsstarke KI-Codierungserlebnis, ohne dass ein Terminal erforderlich ist.

Erste Schritte

Starten Sie die Weboberfläche, indem Sie Folgendes ausführen:

matrix web

Dadurch wird ein lokaler Server auf 127.0.0.1 mit einem zufällig verfügbaren Port gestartet und Matrix automatisch in Ihrem Standardbrowser geöffnet.

Achtung

Wenn MATRIX_SERVER_PASSWORD nicht gesetzt ist, ist der Server ungesichert. Dies ist für den lokalen Gebrauch in Ordnung, sollte aber für den Netzwerkzugriff eingestellt werden.

Windows-Nutzer

Um die beste Erfahrung zu erzielen, führen Sie matrix web über WSL und nicht über PowerShell aus. Dies gewährleistet den ordnungsgemäßen Zugriff auf das Dateisystem und die Terminalintegration.

---

Konfiguration

Sie können den Webserver mithilfe von Befehlszeilen-Flags oder in Ihrer Konfigurationsdatei konfigurieren.

Port

Standardmäßig wählt Matrix einen verfügbaren Port aus. Sie können einen Port angeben:

matrix web --port 4096

Hostname

Standardmäßig bindet der Server an 127.0.0.1 (nur localhost). So machen Sie Matrix in Ihrem Netzwerk zugänglich:

matrix web --hostname 0.0.0.0

Bei Verwendung von 0.0.0.0 zeigt Matrix sowohl lokale als auch Netzwerkadressen an:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

mDNS-Erkennung

Aktivieren Sie mDNS, um Ihren Server im lokalen Netzwerk erkennbar zu machen:

matrix web --mdns

Dadurch wird der Hostname automatisch auf 0.0.0.0 gesetzt und der Server als matrix.local angekündigt.

Sie können den mDNS-Domänennamen anpassen, um mehrere Instanzen im selben Netzwerk auszuführen:

matrix web --mdns --mdns-domain myproject.local

CORS

So erlauben Sie zusätzliche Domänen für CORS (nützlich für benutzerdefinierte Frontends):

matrix web --cors https://example.com

Authentifizierung

Um den Zugriff zu schützen, legen Sie mithilfe der Umgebungsvariablen MATRIX_SERVER_PASSWORD ein Passwort fest:

MATRIX_SERVER_PASSWORD=secret matrix web

Der Benutzername ist standardmäßig matrix, kann aber mit MATRIX_SERVER_USERNAME geändert werden.

---

Verwenden der Weboberfläche

Nach dem Start bietet die Weboberfläche Zugriff auf Ihre Matrix-Sitzungen.

Sitzungen

Zeigen Sie Ihre Sitzungen auf der Startseite an und verwalten Sie sie. Sie können aktive Sitzungen sehen und neue starten.

Serverstatus

Klicken Sie auf „Server anzeigen“, um verbundene Server und deren Status anzuzeigen.

---

Anschließen eines Terminals

Sie können eine Terminal-TUI an einen laufenden Webserver anschließen:

# Start the web server
matrix web --port 4096

# In another terminal, attach the TUI
matrix attach http://localhost:4096

Dadurch können Sie sowohl die Weboberfläche als auch das Terminal gleichzeitig verwenden und dieselben Sitzungen und denselben Status teilen.

---

Konfigurationsdatei

Sie können Servereinstellungen auch in Ihrer matrix.json-Konfigurationsdatei konfigurieren:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Befehlszeilenflags haben Vorrang vor Konfigurationsdateieinstellungen.