Configuración del terminal

Configura el terminal para disfrutar de la mejor experiencia con la CLI de Cursor. Esta guía explica los atajos de teclado para la entrada multilínea, el modo Vim y la sincronización de temas.

Inicio rápido

Si Shift+Enter no funciona para insertar saltos de línea en la terminal, ejecuta /setup-terminal para obtener ayuda para configurar alternativas:

/setup-terminal

Este comando detecta tu terminal y te indica cómo configurar Option+EnterAlt+Enter como alternativa para insertar saltos de línea.

Opciones universales

Estos métodos funcionan en todas las terminales, incluidas las sesiones de tmux, screen y SSH:

Compatibilidad con Terminal

Compatibilidad nativa con Shift+Enter

Estos terminales admiten Shift+Enter para insertar saltos de línea de forma predeterminada:

• iTerm2 (macOS)
• Ghostty
• Kitty
• Warp
• Zed (terminal integrado)

Requiere /setup-terminal

En estos terminales, debes ejecutar /setup-terminal para configurar Option+EnterAlt+Enter para insertar saltos de línea:

• Apple Terminal (macOS)
• Alacritty
• VS Code (terminal integrado)

Multiplexores de terminal

tmux y screen interceptan Shift+Enter antes de que llegue a las aplicaciones. Usa en su lugar las opciones universales:

• Ctrl+J — Funciona de forma fiable en todas las sesiones del multiplexor
• \+Enter — También funciona en todos los casos

Modo Vim

Activa los atajos de teclado de Vim para navegar y editar en el área de entrada de la CLI.

Alternar mediante un comando con barra

/vim

Activa o desactiva el modo Vim para la sesión actual y guarda la preferencia.

Configurar en los ajustes

Añade lo siguiente a ~/.cursor/cli-config.json:

{  "version": 1,  "editor": { "vimMode": true },  "permissions": { "allow": [], "deny": [] }}

Modos

El modo Vim utiliza edición modal:

• Modo normal — Permite navegar y ejecutar comandos (modo predeterminado cuando Vim está activado)
• Modo de inserción — Permite escribir texto normalmente

Pulsa Esc para volver al modo normal desde el modo de inserción.

Navegación

Edición

Entrar en el modo de inserción

Repeticiones

Antepon un número a los comandos para repetirlos. Por ejemplo, 3w avanza 3 palabras y 2dd elimina 2 líneas.

Tema del terminal

La CLI de Cursor detecta automáticamente el esquema de colores de tu terminal y adapta su apariencia.

Detección automática

La CLI consulta el color de fondo de tu terminal mediante secuencias de escape estándar. La mayoría de los terminales modernos lo admiten:

• Terminales oscuros → la CLI usa el tema oscuro
• Terminales claros → la CLI usa el tema claro

Terminales con detección automática

Estos terminales informan correctamente de su esquema de colores:

• iTerm2
• Ghostty
• Kitty
• Alacritty
• Apple Terminal
• Windows Terminal
• Terminal integrado de VS Code

Forzar un tema

Si la detección automática no funciona, puedes anularla con una variable de entorno:

# Forzar el tema oscuroexport COLORFGBG="15;0"# Forzar el tema claroexport COLORFGBG="0;15"

Añade esto a tu perfil de shell (.bashrc, .zshrc, etc.) para aplicarlo de forma permanente.

Solución de problemas con el tema

Los colores no se ven bien:

• Asegúrate de que tu terminal sea compatible con 256 colores o color verdadero
• Comprueba que TERM esté configurado correctamente (p. ej., xterm-256color)
• Intenta establecer COLORFGBG explícitamente

Usuarios de tmux:

• Añade lo siguiente a tu .tmux.conf para conservar la detección de colores:

  set -g default-terminal "tmux-256color"
  set -ag terminal-overrides ",xterm-256color:RGB"
  

• Reinicia tmux después de realizar cambios

Configuración manual

Si /setup-terminal no funciona en tu terminal, puedes configurar los atajos de teclado manualmente.

Option+Enter para saltos de línea

Option+EnterAlt+Enter envía una secuencia de escape especial que la CLI de Cursor reconoce como un salto de línea. Configura tu terminal para que envíe \x1b\r (Escape seguido de retorno de carro) al pulsar Option+EnterAlt+Enter.

iTerm2:

1. Abre Preferences → Profiles → Keys → Key Mappings
2. Haz clic en + para añadir un nuevo mapeo
3. Establece Option+EnterAlt+Enter como Keyboard Shortcut
4. Establece "Send Escape Sequence" como Action
5. Introduce \r como secuencia de escape

Alacritty:

Añade lo siguiente a tu alacritty.toml:

[keyboard]bindings = [  { key = "Return", mods = "Alt", chars = "\u001b\r" }]

Kitty:

Añade lo siguiente a tu kitty.conf:

map alt+enter send_text all \x1b\r

Shift+Enter

La compatibilidad con Shift+Enter depende de que tu terminal detecte correctamente la tecla modificadora. La mayoría de los terminales modernos lo gestionan automáticamente, pero algunos pueden requerir configuración.

Terminal de VS Code:

Es posible que el terminal integrado de VS Code no transmita correctamente Shift+Enter. Añade lo siguiente a keybindings.json:

{  "key": "shift+enter",  "command": "workbench.action.terminal.sendSequence",  "args": { "text": "\u001b[13;2u" },  "when": "terminalFocus"}

Solución de problemas

Los atajos de teclado no funcionan:

• Verifica que tu terminal detecte correctamente las teclas con cat o showkey
• Comprueba si un multiplexor de terminal (tmux/screen) está interceptando las teclas
• Usa Ctrl+J como alternativa fiable

Usuarios de tmux:

• Shift+Enter y Option+EnterAlt+Enter no funcionarán en tmux
• Usa Ctrl+J o \+Enter
• Estas opciones universales funcionan en cualquier lugar, incluidas las sesiones de tmux anidadas

Sesiones SSH:

• Las capacidades del terminal remoto dependen de tu emulador de terminal local
• Ctrl+J funciona de forma fiable mediante SSH
• \+Enter es otra opción fiable

Resumen