Saltearse al contenido
OpenCode
app.header.homeapp.header.docs

TUI

Usando la interfaz de usuario del terminal OpenCode.

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.

Ventana de terminal
opencode

O puede iniciarlo para un directorio de trabajo específico.

Ventana de terminal
opencode /path/to/project

Una vez que esté en TUI, puede indicarlo con un mensaje.

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.

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.

!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:

/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.

Aquí están todos los comandos de barra diagonal disponibles:

conectar

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

/connect

compacto

Compacta la sesión actual. Alias: /summarize

/compact

Combinación de teclas: ctrl+x c

detalles

Alternar detalles de ejecución de la herramienta.

/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

Combinación de teclas: ctrl+x e

salida

Salga de OpenCode. Alias: /quit, /q

/exit

Combinación de teclas: ctrl+x q

exportar

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.

/export

Combinación de teclas: ctrl+x x

ayuda

Muestra el cuadro de diálogo de ayuda.

/help

Combinación de teclas: ctrl+x h

inicio

Cree o actualice el archivo AGENTS.md. Más información.

/init

Combinación de teclas: ctrl+x i

modelos

Listar modelos disponibles.

/models

Combinación de teclas: ctrl+x m

nuevo

Iniciar una nueva sesión. Alias: /clear

/new

Combinación de teclas: ctrl+x n

rehacer

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

Internamente, esto utiliza Git para gestionar los cambios de archivos. Entonces tu proyecto necesita ser un repositorio Git.

/redo

Combinación de teclas: ctrl+x r

sesiones

Enumere y cambie entre sesiones. Alias: /resume, /continue

/sessions

Combinación de teclas: ctrl+x l

compartir

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

/share

Combinación de teclas: ctrl+x s

temas

Listar temas disponibles.

/theme

Combinación de teclas: ctrl+x t

pensamiento

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.

/thinking

deshacer

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.

Internamente, esto utiliza Git para gestionar los cambios de archivos. Entonces tu proyecto necesita ser un repositorio Git.

/undo

Combinación de teclas: ctrl+x u

dejar de compartir

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

/unshare

Configuración del editor

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

Ventana de terminal
# 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.

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

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 su archivo de configuración OpenCode.

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

Opciones

  • scroll_acceleration: 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: 1). El valor predeterminado es 3. Nota: Esto se ignora si scroll_acceleration.enabled está configurado en true.

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