Web

Matrix puede ejecutarse como una aplicación web en su navegador, brindando la misma poderosa experiencia de codificación de IA sin necesidad de una terminal.

Empezar

Inicie la interfaz web ejecutando:

matrix web

Esto inicia un servidor local en 127.0.0.1 con un puerto disponible aleatorio y abre automáticamente Matrix en su navegador predeterminado.

Precaución

Si no se establece MATRIX_SERVER_PASSWORD, el servidor no será seguro. Esto está bien para uso local, pero debe configurarse para acceso a la red.

Windows Usuarios

Para obtener la mejor experiencia, ejecute matrix web desde WSL en lugar de PowerShell. Esto garantiza el acceso adecuado al sistema de archivos y la integración del terminal.

---

Configuración

Puede configurar el servidor web usando indicadores de línea de comando o en su archivo de configuración.

Puerto

De forma predeterminada, Matrix elige un puerto disponible. Puede especificar un puerto:

matrix web --port 4096

Nombre de host

De forma predeterminada, el servidor se vincula a 127.0.0.1 (solo localhost). Para hacer que Matrix sea accesible en su red:

matrix web --hostname 0.0.0.0

Al usar 0.0.0.0, Matrix mostrará direcciones locales y de red:

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

Descubrimiento de mDNS

Habilite mDNS para que su servidor sea reconocible en la red local:

matrix web --mdns

Esto establece automáticamente el nombre de host en 0.0.0.0 y anuncia el servidor como matrix.local.

Puede personalizar el nombre de dominio mDNS para ejecutar varias instancias en la misma red:

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

CORS

Para permitir dominios adicionales para CORS (útil para interfaces personalizadas):

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

Autenticación

Para proteger el acceso, establezca una contraseña utilizando la variable de entorno MATRIX_SERVER_PASSWORD:

MATRIX_SERVER_PASSWORD=secret matrix web

El nombre de usuario predeterminado es matrix pero se puede cambiar con MATRIX_SERVER_USERNAME.

---

Usar la interfaz web

Una vez iniciada, la interfaz web proporciona acceso a sus sesiones Matrix.

Sesiones

Vea y administre sus sesiones desde la página de inicio. Puedes ver sesiones activas e iniciar otras nuevas.

Estado del servidor

Haga clic en “Ver servidores” para ver los servidores conectados y su estado.

---

Adjuntar una terminal

Puede conectar un terminal TUI a un servidor web en ejecución:

# Start the web server
matrix web --port 4096

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

Esto le permite utilizar la interfaz web y el terminal simultáneamente, compartiendo las mismas sesiones y estados.

---

Archivo de configuración

También puede configurar los ajustes del servidor en su archivo de configuración matrix.json:

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

Los indicadores de la línea de comando tienen prioridad sobre la configuración del archivo de configuración.