Atajos de teclado
Todos los atajos de teclado de la TUI de Theus, agrupados por el contexto en el que están activos, más cómo personalizarlos en ~/.theus/keybindings.json.
Cómo funcionan los atajos
Theus resuelve los atajos por contexto: la misma tecla puede significar cosas distintas según qué tenga el foco (el prompt del chat, un popup de autocompletado, un diálogo de confirmación, y así). Los atajos por defecto vienen con Theus y se cargan primero; tus sobrescrituras personales de ~/.theus/keybindings.json se aplican encima (gana la última).
Notación de modificadores: ctrl, alt, shift, meta y cmd. Un atajo escrito con espacios, como ctrl+x ctrl+e, es un acorde: pulsa los pasos en secuencia. Algunos atajos (cmd+…, ctrl+shift+-) solo llegan a la app en terminales que hablan el protocolo de teclado de kitty; donde es posible se ofrecen alternativas portables.
Global
Activos en toda la app.
| Tecla | Acción |
|---|
ctrl+c | Interrumpir (doble pulsación para salir) |
ctrl+d | Salir |
ctrl+l | Redibujar la pantalla |
ctrl+t | Alternar la lista de tareas |
ctrl+o | Alternar la vista de transcripción |
ctrl+shift+o | Alternar la vista previa del compañero |
ctrl+r | Buscar en el historial de comandos |
Chat (entrada del prompt)
Activos mientras redactas un mensaje.
| Tecla | Acción |
|---|
enter | Enviar el mensaje |
escape | Cancelar / detener el turno actual |
shift+tab | Cambiar de modo (en Windows sin modo VT: meta+m) |
meta+p | Abrir el selector de modelo |
meta+o | Alternar el modo rápido |
meta+t | Alternar el razonamiento (thinking) |
up / down | Entrada anterior / siguiente del historial |
ctrl+_ o ctrl+shift+- | Deshacer la edición |
ctrl+g o ctrl+x ctrl+e | Abrir el editor externo |
ctrl+s | Guardar el borrador actual |
ctrl+v | Pegar una imagen (Windows: alt+v) |
ctrl+x ctrl+k | Detener los agentes en ejecución |
El contexto Chat deja libres las teclas de edición estilo readline (ctrl+a, ctrl+e, ctrl+f, y demás) para mover el cursor; por eso las acciones extra usan el prefijo de acorde ctrl+x.
Popup de autocompletado
| Tecla | Acción |
|---|
tab | Aceptar la sugerencia |
escape | Descartar |
up / down | Sugerencia anterior / siguiente |
Listas y selección
El contexto Select gobierna menús como /model, /resume y las peticiones de permiso.
| Tecla | Acción |
|---|
up / k / ctrl+p | Subir |
down / j / ctrl+n | Bajar |
enter | Aceptar la selección |
escape | Cancelar |
Diálogos de confirmación
| Tecla | Acción |
|---|
y / enter | Confirmar |
n / escape | Rechazar |
up / down | Navegar las opciones de la lista |
tab | Siguiente campo |
space | Alternar la opción |
shift+tab | Cambiar de modo (diálogos de permisos y equipos) |
ctrl+e | Alternar la explicación del permiso |
ctrl+d | Alternar la información de depuración del permiso |
Panel de ajustes / configuración
| Tecla | Acción |
|---|
up / k / ctrl+p | Subir |
down / j / ctrl+n | Bajar |
space | Alternar / activar el ajuste seleccionado |
enter | Guardar y cerrar |
escape | Descartar |
/ | Entrar en modo búsqueda |
r | Reintentar la carga de los datos de consumo (solo ante error) |
Vista de transcripción
| Tecla | Acción |
|---|
ctrl+e | Alternar mostrar todo |
escape / q / ctrl+c | Salir |
Búsqueda en el historial
| Tecla | Acción |
|---|
ctrl+r | Siguiente coincidencia |
enter | Ejecutar la entrada seleccionada |
escape / tab | Aceptar |
ctrl+c | Cancelar |
Desplazamiento y copia
| Tecla | Acción |
|---|
pageup / pagedown | Desplazar una página |
ctrl+home / ctrl+end | Saltar al inicio / al final |
ctrl+shift+c | Copiar la selección |
cmd+c | Copiar la selección (solo terminales con protocolo kitty) |
Pestañas y pie de estado
| Tecla | Acción |
|---|
tab / right | Pestaña siguiente |
shift+tab / left | Pestaña anterior |
up / ctrl+p | Subir el indicador del pie |
down / ctrl+n | Bajar el indicador del pie |
enter | Abrir el elemento del pie seleccionado |
escape | Limpiar la selección del pie |
Otros diálogos
| Contexto | Tecla | Acción |
|---|
| Tarea | ctrl+b | Enviar al segundo plano una tarea en primer plano (en tmux, pulsa dos veces) |
| Selector de tema | ctrl+t | Alternar el resaltado de sintaxis |
| Adjuntos | left / right | Adjunto anterior / siguiente |
| Adjuntos | backspace / delete | Quitar el adjunto |
| Diálogo de diff | up / down | Archivo anterior / siguiente |
| Diálogo de diff | left / right | Fuente anterior / siguiente |
| Diálogo de diff | enter | Ver detalles |
| Diálogo de plugins | space | Alternar el plugin |
| Diálogo de plugins | i | Instalar el plugin |
| Rebobinar / selector de mensaje | up / down / j / k | Navegar los mensajes |
| Rebobinar / selector de mensaje | enter | Seleccionar el mensaje |
Atajos reservados
Algunas teclas no se pueden reasignar porque Theus las maneja directamente o el terminal / sistema operativo las intercepta.
| Tecla | Motivo |
|---|
ctrl+c | Interrumpir / salir — fijo en código, usa temporización de doble pulsación |
ctrl+d | Salir — fijo en código |
ctrl+m | Idéntico a enter en los terminales (ambos envían retorno de carro) |
ctrl+z | Suspensión de proceso en Unix (SIGTSTP) |
ctrl+\ | Señal de salida del terminal (SIGQUIT) |
En macOS, el sistema también intercepta cmd+c, cmd+v, cmd+x, cmd+q, cmd+w, cmd+tab y cmd+space, así que asignar a esas combinaciones no es recomendable.
Personalizar tus atajos
Ejecuta el comando de barra para abrir (o crear) tu archivo personal de atajos:
/keybindings
Esto escribe una plantilla completamente documentada en ~/.theus/keybindings.json con todos los atajos por defecto, lista para editar. El archivo tiene un arreglo bindings de bloques de contexto:
{
"$schema": "https://www.schemastore.org/theus-code-keybindings.json",
"bindings": [
{
"context": "Chat",
"bindings": {
"ctrl+g": "chat:externalEditor"
}
}
]
}
Asigna una acción a null para desvincular una tecla. Tus sobrescrituras se fusionan sobre los valores por defecto, así que solo necesitas listar las teclas que quieras cambiar. El archivo se vigila y se recarga automáticamente mientras Theus está en ejecución.
Si tu keybindings.json está mal formado (por ejemplo, le falta el arreglo bindings), Theus vuelve a los valores por defecto y reporta el error de análisis en vez de arrancar sin atajos.