@neurocode-ai/web 1.18.8

package/src/content/docs/es/tui.mdx

@@ -0,0 +1,429 @@
+---
+title: TUI
+description: Usando la interfaz de usuario del terminal OpenCode.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+OpenCode proporciona una interfaz de terminal interactiva o TUI para trabajar en sus proyectos con un LLM.
+
+Al ejecutar OpenCode se inicia TUI para el directorio actual.
+
+```bash
+opencode
+```
+
+O puede iniciarlo para un directorio de trabajo específico.
+
+```bash
+opencode /path/to/project
+```
+
+Una vez que esté en TUI, puede indicarlo con un mensaje.
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## Referencias de archivos
+
+Puede hacer referencia a archivos en sus mensajes usando `@`. Esto realiza una búsqueda difusa de archivos en el directorio de trabajo actual.
+
+:::tip
+También puede utilizar `@` para hacer referencia a archivos en sus mensajes.
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+El contenido del archivo se agrega a la conversación automáticamente.
+
+---
+
+## Comandos bash
+
+Inicie un mensaje con `!` para ejecutar un comando de shell.
+
+```bash frame="none"
+!ls -la
+```
+
+El resultado del comando se agrega a la conversación como resultado de la herramienta.
+
+---
+
+## Comandos
+
+Cuando utilice OpenCode TUI, puede escribir `/` seguido de un nombre de comando para ejecutar acciones rápidamente. Por ejemplo:
+
+```bash frame="none"
+/help
+```
+
+La mayoría de los comandos también tienen una combinación de teclas que utiliza `ctrl+x` como tecla principal, donde `ctrl+x` es la tecla principal predeterminada. [Más información](/docs/keybinds).
+
+Aquí están todos los comandos de barra diagonal disponibles:
+
+---
+
+### connect
+
+Agregue un proveedor a OpenCode. Le permite seleccionar entre proveedores disponibles y agregar sus claves API.
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### compact
+
+Compacta la sesión actual. _Alias_: `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**Combinación de teclas:** `ctrl+x c`
+
+---
+
+### details
+
+Alternar detalles de ejecución de la herramienta.
+
+```bash frame="none"
+/details
+```
+
+**Combinación de teclas:** `ctrl+x d`
+
+---
+
+### editor
+
+Abra un editor externo para redactar mensajes. Utiliza el editor configurado en su variable de entorno `EDITOR`. [Más información](#editor-setup).
+
+```bash frame="none"
+/editor
+```
+
+**Combinación de teclas:** `ctrl+x e`
+
+---
+
+### exit
+
+Salga de OpenCode. _Alias_: `/quit`, `/q`
+
+```bash frame="none"
+/exit
+```
+
+**Combinación de teclas:** `ctrl+x q`
+
+---
+
+### export
+
+Exporte la conversación actual a Markdown y ábrala en su editor predeterminado. Utiliza el editor configurado en su variable de entorno `EDITOR`. [Más información](#editor-setup).
+
+```bash frame="none"
+/export
+```
+
+**Combinación de teclas:** `ctrl+x x`
+
+---
+
+### help
+
+Muestra el cuadro de diálogo de ayuda.
+
+```bash frame="none"
+/help
+```
+
+**Combinación de teclas:** `ctrl+x h`
+
+---
+
+### init
+
+Cree o actualice el archivo `AGENTS.md`. [Más información](/docs/rules).
+
+```bash frame="none"
+/init
+```
+
+**Combinación de teclas:** `ctrl+x i`
+
+---
+
+### models
+
+Listar modelos disponibles.
+
+```bash frame="none"
+/models
+```
+
+**Combinación de teclas:** `ctrl+x m`
+
+---
+
+### new
+
+Iniciar una nueva sesión. _Alias_: `/clear`
+
+```bash frame="none"
+/new
+```
+
+**Combinación de teclas:** `ctrl+x n`
+
+---
+
+### redo
+
+Rehacer un mensaje previamente deshecho. Solo disponible después de usar `/undo`.
+
+:::tip
+También se restaurarán todos los cambios en el archivo.
+:::
+
+Internamente, esto utiliza Git para gestionar los cambios de archivos. Entonces tu proyecto **necesita
+ser un repositorio Git**.
+
+```bash frame="none"
+/redo
+```
+
+**Combinación de teclas:** `ctrl+x r`
+
+---
+
+### sessions
+
+Enumere y cambie entre sesiones. _Alias_: `/resume`, `/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**Combinación de teclas:** `ctrl+x l`
+
+---
+
+### share
+
+Compartir la sesión actual. [Más información](/docs/share).
+
+```bash frame="none"
+/share
+```
+
+**Combinación de teclas:** `ctrl+x s`
+
+---
+
+### theme
+
+Listar temas disponibles.
+
+```bash frame="none"
+/theme
+```
+
+**Combinación de teclas:** `ctrl+x t`
+
+---
+
+### thinking
+
+Alterna la visibilidad de los bloques de pensamiento/razonamiento en la conversación. Cuando está habilitado, puede ver el proceso de razonamiento del modelo para los modelos que admiten el pensamiento extendido.
+
+:::note
+Este comando solo controla si se **muestran** los bloques de pensamiento; no habilita ni deshabilita las capacidades de razonamiento del modelo. Para alternar las capacidades de razonamiento reales, use `ctrl+t` para recorrer las variantes del modelo.
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### undo
+
+Deshacer el último mensaje de la conversación. Elimina el mensaje de usuario más reciente, todas las respuestas posteriores y cualquier cambio de archivo.
+
+:::tip
+Cualquier cambio de archivo realizado también se revertirá.
+:::
+
+Internamente, esto utiliza Git para gestionar los cambios de archivos. Entonces tu proyecto **necesita
+ser un repositorio Git**.
+
+```bash frame="none"
+/undo
+```
+
+**Combinación de teclas:** `ctrl+x u`
+
+---
+
+### unshare
+
+Dejar de compartir la sesión actual. [Más información](/docs/share#un-sharing).
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## Configuración del editor
+
+Tanto el comando `/editor` como el `/export` usan el editor especificado en su variable de entorno `EDITOR`.
+
+<Tabs>
+  <TabItem label="Linux/macOS">
+    ```bash
+    # Example for nano or vim
+    export EDITOR=nano
+    export EDITOR=vim
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    export EDITOR="code --wait"
+    ```
+
+    Para hacerlo permanente, agréguelo a su perfil de shell;
+    `~/.bashrc`, `~/.zshrc`, etc.
+
+  </TabItem>
+
+  <TabItem label="Windows (CMD)">
+    ```bash
+    set EDITOR=notepad
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    set EDITOR=code --wait
+    ```
+
+    Para hacerlo permanente, use **Propiedades del sistema** > **Entorno
+    Variables**.
+
+  </TabItem>
+
+  <TabItem label="Windows (PowerShell)">
+    ```powershell
+    $env:EDITOR = "notepad"
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    $env:EDITOR = "code --wait"
+    ```
+
+    Para hacerlo permanente, agréguelo a su perfil de PowerShell.
+
+  </TabItem>
+</Tabs>
+
+Las opciones de editor populares incluyen:
+
+- `code` - Código de Visual Studio
+- `cursor` - Cursor
+- `windsurf` - Windsurf
+- `nvim` - Editor Neovim
+- `vim` - Editor Vim
+- `nano` - Nanoeditor
+- `notepad` - Windows Bloc de notas
+- `subl` - Texto sublime
+
+:::note
+Algunos editores como VS Code deben iniciarse con el indicador `--wait`.
+:::
+
+Algunos editores necesitan argumentos de línea de comandos para ejecutarse en modo de bloqueo. El indicador `--wait` hace que el proceso del editor se bloquee hasta que se cierre.
+
+---
+
+## Configurar
+
+Puede personalizar el comportamiento de TUI a través de `tui.json` (o `tui.jsonc`).
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "opencode",
+  "leader_timeout": 2000,
+  "keybinds": {
+    "leader": "ctrl+x",
+    "command_list": "ctrl+p"
+  },
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": false
+  },
+  "diff_style": "auto",
+  "mouse": true,
+  "attention": {
+    "enabled": true,
+    "notifications": true,
+    "sound": true,
+    "volume": 0.4,
+    "sound_pack": "opencode.default",
+    "sounds": {
+      "error": "./sounds/error.mp3"
+    }
+  }
+}
+```
+
+Esto es independiente de `opencode.json`, que configura el comportamiento del servidor/tiempo de ejecución.
+
+`keybinds` se combina con los valores predeterminados integrados, así que solo necesitas configurar los atajos que quieras cambiar.
+
+### Opciones
+
+- `theme`: establece su tema de interfaz de usuario. [Más información](/docs/themes).
+- `keybinds`: personaliza los atajos de teclado. [Más información](/docs/keybinds).
+- `leader_timeout`: controla cuánto tiempo espera OpenCode después de la leader key. El valor predeterminado es `2000`.
+- `scroll_acceleration.enabled`: habilite la aceleración de desplazamiento estilo macOS para un desplazamiento suave y natural. Cuando está habilitado, la velocidad de desplazamiento aumenta con gestos de desplazamiento rápido y se mantiene precisa para movimientos más lentos. **Esta configuración tiene prioridad sobre `scroll_speed` y la anula cuando está habilitada.**
+- `scroll_speed`: controla la rapidez con la que se desplaza el TUI cuando se utilizan comandos de desplazamiento (mínimo: `0.001`, admite valores decimales). El valor predeterminado es `3`. **Nota: Esto se ignora si `scroll_acceleration.enabled` está configurado en `true`.**
+- `diff_style`: controla la representación de diferencias. `"auto"` se adapta al ancho del terminal, `"stacked"` siempre muestra un diseño de una sola columna.
+- `mouse`: habilita o deshabilita la captura del mouse en el TUI (predeterminado: `true`). Cuando está deshabilitada, se conserva el comportamiento nativo del terminal para seleccionar y desplazarse con el mouse.
+- `attention`: configura las notificaciones de escritorio y los sonidos del TUI. Deshabilitado de forma predeterminada.
+
+Utilice `OPENCODE_TUI_CONFIG` para cargar una ruta de configuración de TUI personalizada.
+
+### Attention
+
+Attention permite que el TUI te avise cuando OpenCode necesita que respondas una pregunta, apruebes un permiso, revises un error de sesión o sepas que una sesión terminó. Actívalo con `attention.enabled`; los eventos integrados reproducen sonidos al ocurrir. Las notificaciones de escritorio solo se envían cuando la ventana del terminal no está enfocada y no se usan para eventos de subagent.
+
+- `enabled`: activa todas las notificaciones y sonidos de Attention. El valor predeterminado es `false`.
+- `notifications`: cuando Attention está activo, permite que el TUI envíe notificaciones de escritorio a través del terminal. El valor predeterminado es `true`.
+- `sound`: cuando Attention está activo, permite reproducir sonidos de aviso. El valor predeterminado es `true`.
+- `volume`: volumen predeterminado de los sonidos, de `0` a `1`. El valor predeterminado es `0.4`.
+- `sound_pack`: ID del sound pack que se usará. El valor predeterminado es `opencode.default`.
+- `sounds`: define archivos de sonido personalizados para `default`, `question`, `permission`, `error`, `done` o `subagent_done`. Las rutas pueden ser absolutas, URL `file://` o relativas a `tui.json`.
+
+---
+
+## Personalización
+
+Puede personalizar varios aspectos de la vista TUI usando la paleta de comandos (`ctrl+x h` o `/help`). Estas configuraciones persisten después de los reinicios.
+
+---
+
+#### Visualización del nombre de usuario
+
+Alterna si tu nombre de usuario aparece en los mensajes de chat. Accede a este a través de:
+
+- Paleta de comandos: busque "nombre de usuario" u "ocultar nombre de usuario"
+- La configuración persiste automáticamente y se recordará en TUI sesiones

package/src/content/docs/es/web.mdx

@@ -0,0 +1,142 @@
+---
+title: Web
+description: Usando OpenCode en su navegador.
+---
+
+OpenCode 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.
+
+![OpenCode Web - Nueva sesión](../../../assets/web/web-homepage-new-session.png)
+
+## Empezar
+
+Inicie la interfaz web ejecutando:
+
+```bash
+opencode web
+```
+
+Esto inicia un servidor local en `127.0.0.1` con un puerto disponible aleatorio y abre automáticamente OpenCode en su navegador predeterminado.
+
+:::caution
+Si no se establece `OPENCODE_SERVER_PASSWORD`, el servidor no será seguro. Esto está bien para uso local, pero debe configurarse para acceso a la red.
+:::
+
+:::tip[Windows Usuarios]
+Para obtener la mejor experiencia, ejecute `opencode web` desde [WSL](/docs/windows-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](/docs/config).
+
+### Puerto
+
+De forma predeterminada, OpenCode elige un puerto disponible. Puede especificar un puerto:
+
+```bash
+opencode web --port 4096
+```
+
+### Nombre de host
+
+De forma predeterminada, el servidor se vincula a `127.0.0.1` (solo localhost). Para hacer que OpenCode sea accesible en su red:
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+Al usar `0.0.0.0`, OpenCode 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:
+
+```bash
+opencode web --mdns
+```
+
+Esto establece automáticamente el nombre de host en `0.0.0.0` y anuncia el servidor como `opencode.local`.
+
+Puede personalizar el nombre de dominio mDNS para ejecutar varias instancias en la misma red:
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+### CORS
+
+Para permitir dominios adicionales para CORS (útil para interfaces personalizadas):
+
+```bash
+opencode web --cors https://example.com
+```
+
+### Autenticación
+
+Para proteger el acceso, establezca una contraseña utilizando la variable de entorno `OPENCODE_SERVER_PASSWORD`:
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+El nombre de usuario predeterminado es `opencode` pero se puede cambiar con `OPENCODE_SERVER_USERNAME`.
+
+---
+
+## Usar la interfaz web
+
+Una vez iniciada, la interfaz web proporciona acceso a sus sesiones OpenCode.
+
+### Sesiones
+
+Vea y administre sus sesiones desde la página de inicio. Puedes ver sesiones activas e iniciar otras nuevas.
+
+![OpenCode Web - Sesión activa](../../../assets/web/web-homepage-active-session.png)
+
+### Estado del servidor
+
+Haga clic en "Ver servidores" para ver los servidores conectados y su estado.
+
+![OpenCode Web - Ver Servidores](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## Adjuntar una terminal
+
+Puede conectar un terminal TUI a un servidor web en ejecución:
+
+```bash
+# Start the web server
+opencode web --port 4096
+
+# In another terminal, attach the TUI
+opencode 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 `opencode.json`:
+
+```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.

package/src/content/docs/es/windows-wsl.mdx

@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Ejecuta OpenCode en Windows con WSL para una mejor experiencia.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+Aunque OpenCode puede ejecutarse directamente en Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para obtener la mejor experiencia. WSL ofrece un entorno Linux que funciona perfectamente con las funciones de OpenCode.
+
+:::tip[¿Por qué WSL?]
+WSL ofrece mejor rendimiento del sistema de archivos, soporte completo de terminal y compatibilidad con las herramientas de desarrollo de las que depende OpenCode.
+:::
+
+---
+
+## Configuración
+
+<Steps>
+
+1. **Instala WSL**
+
+   Si aún no lo hiciste, [instala WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando la guía oficial de Microsoft.
+
+2. **Instala OpenCode en WSL**
+
+   Cuando WSL esté listo, abre tu terminal de WSL e instala OpenCode con uno de los [métodos de instalación](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **Usa OpenCode desde WSL**
+
+   Ve al directorio de tu proyecto (accede a los archivos de Windows desde `/mnt/c/`, `/mnt/d/`, etc.) y ejecuta OpenCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## Aplicación de escritorio + servidor WSL
+
+Si prefieres usar la app de escritorio de OpenCode pero quieres ejecutar el servidor en WSL:
+
+1. **Inicia el servidor en WSL** con `--hostname 0.0.0.0` para permitir conexiones externas:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Conecta la app de escritorio** a `http://localhost:4096`
+
+:::note
+Si `localhost` no funciona en tu configuración, conéctate usando la dirección IP de WSL (desde WSL: `hostname -I`) y usa `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+Cuando uses `--hostname 0.0.0.0`, define `OPENCODE_SERVER_PASSWORD` para proteger el servidor.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Cliente web + WSL
+
+Para obtener la mejor experiencia web en Windows:
+
+1. **Ejecuta `opencode web` en la terminal de WSL** en lugar de PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Accede desde tu navegador de Windows** en `http://localhost:<port>` (OpenCode muestra la URL)
+
+Ejecutar `opencode web` desde WSL garantiza acceso correcto al sistema de archivos e integración con la terminal, manteniéndolo accesible desde tu navegador de Windows.
+
+---
+
+## Acceso a archivos de Windows
+
+WSL puede acceder a todos tus archivos de Windows mediante el directorio `/mnt/`:
+
+- Unidad `C:` → `/mnt/c/`
+- Unidad `D:` → `/mnt/d/`
+- Y así sucesivamente...
+
+Ejemplo:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Para una experiencia más fluida, considera clonar o copiar tu repo al sistema de archivos de WSL (por ejemplo en `~/code/`) y ejecutar OpenCode ahí.
+:::
+
+---
+
+## Consejos
+
+- Ejecuta OpenCode en WSL para proyectos guardados en unidades de Windows: el acceso a archivos es transparente
+- Usa la [extensión WSL de VS Code](https://code.visualstudio.com/docs/remote/wsl) junto con OpenCode para un flujo de desarrollo integrado
+- Tu configuración y tus sesiones de OpenCode se guardan dentro del entorno WSL en `~/.local/share/opencode/`