TUI

Usando la interfaz de usuario de terminal de OpenCode.

OpenCode proporciona una interfaz de terminal interactiva o TUI para trabajar en tus proyectos con un LLM.

Ejecutar OpenCode inicia la TUI para el directorio actual.

opencode

O puedes iniciarla para un directorio de trabajo específico.

opencode /path/to/project

Una vez que estés en la TUI, puedes enviar un mensaje.

Give me a quick summary of the codebase.

Referencias de archivos

Puedes referenciar archivos en tus mensajes usando @. Esto realiza una búsqueda difusa de archivos en el directorio de trabajo actual.

Consejo: También puedes usar @ para referenciar archivos en tus mensajes.

How is auth handled in @packages/functions/src/api/index.ts?

El contenido del archivo se agrega automáticamente a la conversación.

Comandos Bash

Comienza un mensaje con ! para ejecutar un comando de shell.

!ls -la

La salida del comando se agrega a la conversación como resultado de herramienta.

Comandos

Al usar la TUI de OpenCode, puedes escribir / seguido de un nombre de comando para ejecutar acciones rápidamente. Por ejemplo:

/help

La mayoría de los comandos también tienen atajos de teclado usando ctrl+x como tecla líder, donde ctrl+x es la tecla líder predeterminada. Más información.

Aquí están todos los comandos slash disponibles:

connect

Agrega un proveedor a OpenCode. Te permite seleccionar de los proveedores disponibles y agregar sus claves API.

/connect

compact

Compacta la sesión actual. Alias: /summarize

/compact

Atajo: ctrl+x c

details

Alterna los detalles de ejecución de herramientas.

/details

Atajo: ctrl+x d

editor

Abre un editor externo para componer mensajes. Usa el editor configurado en tu variable de entorno EDITOR. Más información.

/editor

Atajo: ctrl+x e

exit

Sale de OpenCode. Aliases: /quit, /q

/exit

Atajo: ctrl+x q

export

Exporta la conversación actual a Markdown y la abre en tu editor predeterminado. Usa el editor configurado en tu variable de entorno EDITOR. Más información.

/export

Atajo: ctrl+x x

help

Muestra el diálogo de ayuda.

/help

Atajo: ctrl+x h

init

Crea o actualiza el archivo AGENTS.md. Más información.

/init

Atajo: ctrl+x i

models

Lista los modelos disponibles.

/models

Atajo: ctrl+x m

new

Inicia una nueva sesión. Alias: /clear

/new

Atajo: ctrl+x n

redo

Rehace un mensaje previamente deshecho. Solo disponible después de usar /undo.

Consejo: Los cambios de archivos también se restaurarán.

Internamente, esto usa Git para gestionar los cambios de archivos. Por lo tanto, tu proyecto necesita ser un repositorio Git.

/redo

Atajo: ctrl+x r

sessions

Lista y cambia entre sesiones. Aliases: /resume, /continue

/sessions

Atajo: ctrl+x l

Comparte la sesión actual. Más información.

/share

Atajo: ctrl+x s

themes

Lista los temas disponibles.

/themes

Atajo: ctrl+x t

thinking

Alterna la visibilidad de los bloques de pensamiento/razonamiento en la conversación. Cuando está habilitado, puedes ver el proceso de razonamiento del modelo para modelos que soportan pensamiento extendido.

Nota: Este comando solo controla si los bloques de pensamiento se muestran - no habilita ni deshabilita las capacidades de razonamiento del modelo. Para alternar las capacidades de razonamiento reales, usa ctrl+t para ciclar entre variantes del modelo.

/thinking

undo

Deshace el último mensaje en la conversación. Elimina el mensaje de usuario más reciente, todas las respuestas subsiguientes y cualquier cambio de archivo.

Consejo: Cualquier cambio de archivo realizado también se revertirá.

Internamente, esto usa Git para gestionar los cambios de archivos. Por lo tanto, tu proyecto necesita ser un repositorio Git.

/undo

Atajo: ctrl+x u

unshare

Deja de compartir la sesión actual. Más información.

/unshare

Configuración del editor

Tanto el comando /editor como /export usan el editor especificado en tu variable de entorno EDITOR.

Linux/macOS

# 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égalo a tu perfil de shell; ~/.bashrc, ~/.zshrc, etc.

Windows (CMD)

set EDITOR=notepad
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --wait

Para hacerlo permanente, usa Propiedades del Sistema > Variables de Entorno.

Windows (PowerShell)

$env:EDITOR = "notepad"
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"

Para hacerlo permanente, agrégalo a tu perfil de PowerShell.

Opciones populares de editor

Las opciones populares de editor incluyen:

code - Visual Studio Code
cursor - Cursor
windsurf - Windsurf
nvim - Editor Neovim
vim - Editor Vim
nano - Editor Nano
notepad - Bloc de notas de Windows
subl - Sublime Text

Nota: Algunos editores como VS Code necesitan iniciarse con la bandera --wait.

Algunos editores necesitan argumentos de línea de comandos para ejecutarse en modo bloqueante. La bandera --wait hace que el proceso del editor se bloquee hasta que se cierre.

Configuración

Puedes personalizar el comportamiento de la TUI a través de tu archivo de configuración de OpenCode.

opencode.json

Opciones

scroll_acceleration - Habilita 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 precedencia sobre scroll_speed y la anula cuando está habilitada.
scroll_speed - Controla qué tan rápido se desplaza la TUI cuando se usan comandos de desplazamiento (mínimo: 1). Por defecto es 3. Nota: Esto se ignora si scroll_acceleration.enabled está configurado como true.

Personalización

Puedes personalizar varios aspectos de la vista de la TUI usando la paleta de comandos (ctrl+x h o /help). Estas configuraciones persisten entre reinicios.

Visualización del nombre de usuario

Alterna si tu nombre de usuario aparece en los mensajes del chat. Accede a través de:

Paleta de comandos: Busca "username" o "hide username"
La configuración persiste automáticamente y se recordará entre sesiones de TUI

Migración a 1.0 CLI