Web

Usando OpenCode en tu navegador.

OpenCode puede ejecutarse como una aplicación web en tu navegador, proporcionando la misma potente experiencia de codificación con IA sin necesidad de una terminal.

Primeros Pasos

Inicia la interfaz web ejecutando:

opencode web

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

⚠️

Si OPENCODE_SERVER_PASSWORD no está configurado, el servidor no estará protegido. Esto está bien para uso local, pero debe configurarse para acceso en red.

Para la mejor experiencia, ejecuta opencode web desde WSL en lugar de PowerShell. Esto asegura el acceso correcto al sistema de archivos y la integración con la terminal.

Configuración

Puedes configurar el servidor web usando flags de línea de comandos o en tu archivo de configuración.

Puerto

Por defecto, OpenCode elige un puerto disponible. Puedes especificar un puerto:

opencode web --port 4096

Nombre de Host

Por defecto, el servidor se vincula a 127.0.0.1 (solo localhost). Para hacer OpenCode accesible en tu red:

opencode web --hostname 0.0.0.0

Al usar 0.0.0.0, OpenCode mostrará tanto direcciones locales como de red:

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

Descubrimiento mDNS

Habilita mDNS para hacer tu servidor descubrible en la red local:

opencode web --mdns

Esto configura automáticamente el nombre de host a 0.0.0.0 y anuncia el servidor como opencode.local.

Puedes personalizar el nombre de dominio mDNS para ejecutar múltiples instancias en la misma red:

opencode web --mdns --mdns-domain myproject.local

CORS

Para permitir dominios adicionales para CORS (útil para frontends personalizados):

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

Autenticación

Para proteger el acceso, establece una contraseña usando la variable de entorno OPENCODE_SERVER_PASSWORD:

OPENCODE_SERVER_PASSWORD=secret opencode web

El nombre de usuario por defecto es opencode, pero puede cambiarse con OPENCODE_SERVER_USERNAME.

Usando la Interfaz Web

Una vez iniciada, la interfaz web proporciona acceso a tus sesiones de OpenCode.

Sesiones

Ve y gestiona tus sesiones desde la página principal. Puedes ver sesiones activas e iniciar nuevas.

Estado del Servidor

Haz clic en "See Servers" para ver los servidores conectados y su estado.

Adjuntar una Terminal

Puedes adjuntar una terminal TUI a un servidor web en ejecución:

# Iniciar el servidor web
opencode web --port 4096
 
# En otra terminal, adjuntar el TUI
opencode attach http://localhost:4096

Esto te permite usar tanto la interfaz web como la terminal simultáneamente, compartiendo las mismas sesiones y estado.

Archivo de Configuración

También puedes configurar los ajustes del servidor en tu archivo de configuración opencode.json:

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

Los flags de línea de comandos tienen prioridad sobre la configuración del archivo.

CLI IDE