Saltearse al contenido
OpenCode
HomeDocs

TUI

Uso de la interfaz de usuario de terminal OpenCode.

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

Al ejecutar OpenCode se inicia la TUI para el directorio actual.

Ventana de terminal
opencode

O puede iniciarla para un directorio de trabajo especifico.

Ventana de terminal
opencode /path/to/project

Una vez que este en la TUI, puede enviarle un mensaje.

Give me a quick summary of the codebase.

Referencias de archivos

Puede referenciar archivos en sus mensajes usando @. Esto realiza una busqueda difusa de archivos en el directorio de trabajo actual.

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

El contenido del archivo se agrega automaticamente a la conversacion.

Comandos de Bash

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

!ls -la

La salida del comando se agrega a la conversacion como resultado de una herramienta.

Comandos

Al usar la TUI de OpenCode, puede escribir / seguido de un nombre de comando para ejecutar rapidamente acciones. Por ejemplo:

/help

La mayoria de los comandos tambien tienen un atajo de teclado usando ctrl+x como tecla lider, donde ctrl+x es la tecla lider predeterminada. Mas informacion.

Aquí estan todos los comandos de barra disponibles:

connect

Agregar un proveedor a OpenCode. Le permite seleccionar entre los proveedores disponibles y agregar sus claves API.

/connect

compact

Compactar la sesion actual. Alias: /summarize

/compact

Atajo: ctrl+x c

details

Alternar detalles de ejecucion de herramientas.

/details

Atajo: ctrl+x d

editor

Abrir editor externo para redactar mensajes. Usa el editor configurado en su variable de entorno EDITOR. Mas informacion.

/editor

Atajo: ctrl+x e

exit

Salir de OpenCode. Alias: /quit, /q

/exit

Atajo: ctrl+x q

export

Exportar la conversacion actual a Markdown y abrirla en su editor predeterminado. Usa el editor configurado en su variable de entorno EDITOR. Mas informacion.

/export

Atajo: ctrl+x x

help

Mostrar el dialogo de ayuda.

/help

Atajo: ctrl+x h

init

Crear o actualizar el archivo AGENTS.md. Mas informacion.

/init

Atajo: ctrl+x i

models

Listar modelos disponibles.

/models

Atajo: ctrl+x m

new

Iniciar una nueva sesion. Alias: /clear

/new

Atajo: ctrl+x n

redo

Rehacer un mensaje previamente deshecho. Solo disponible despues de usar /undo.

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

/redo

Atajo: ctrl+x r

sessions

Listar y cambiar entre sesiones. Alias: /resume, /continue

/sessions

Atajo: ctrl+x l

share

Compartir la sesion actual. Mas informacion.

/share

Atajo: ctrl+x s

themes

Listar temas disponibles.

/theme

Atajo: ctrl+x t

undo

Deshacer el ultimo mensaje en la conversacion. Elimina el mensaje de usuario mas reciente, todas las respuestas posteriores y cualquier cambio de archivos.

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

/undo

Atajo: ctrl+x u

unshare

Dejar de compartir la sesion actual. Mas informacion.

/unshare

Configuracion del editor

Tanto los comandos /editor como /export usan el editor especificado en su variable de entorno EDITOR.

Ventana de terminal
# Ejemplo para nano o vim
export EDITOR=nano
export EDITOR=vim


# Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# incluir --wait
export EDITOR="code --wait"

Para hacerlo permanente, agreguelo a su perfil de shell; ~/.bashrc, ~/.zshrc, etc.

Las opciones de editor populares 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

Algunos editores necesitan argumentos de linea de comandos para ejecutarse en modo bloqueo. El indicador --wait hace que el proceso del editor se bloquee hasta que se cierre.

Configurar

Puede personalizar el comportamiento de la TUI a traves de su archivo de configuracion de OpenCode.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

Opciones

  • scroll_acceleration - Activar la aceleracion de desplazamiento estilo macOS para un desplazamiento suave y natural. Cuando esta activada, la velocidad de desplazamiento aumenta con los gestos rapidos de desplazamiento y se mantiene precisa para movimientos mas lentos. Esta configuracion tiene prioridad sobre scroll_speed y lo anula cuando esta activada.
  • scroll_speed - Controla que tan rapido se desplaza la TUI al usar comandos de desplazamiento (minimo: 1). Por defecto es 1 en Unix y 3 en Windows. Nota: Esto se ignora si scroll_acceleration.enabled esta establecido en true.

Personalizacion

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

Visualizacion de nombre de usuario

Alterne si su nombre de usuario aparece en los mensajes de chat. Acceda a traves de:

  • Paleta de comandos: Busque “username” o “hide username”
  • La configuracion se guarda automaticamente y se recordara entre sesiones de TUI