Sugerencias de comandos e IA

Sugerencias en línea

Mientras escribes un comando en cualquier panel de terminal (local, SSH, Telnet, Mosh o serie), PlexusTerm dibuja en gris, tras el cursor, el resto de un comando que ejecutaste antes. Las sugerencias salen de tu propio historial de comandos, así que funcionan sin ninguna IA configurada: primero los comandos del mismo host y luego los de todos los hosts, los más recientes y más usados primero.

• Flecha derecha o End, con el cursor al final de la línea, acepta la sugerencia completa; Ctrl+Flecha derecha acepta su siguiente palabra. El texto aceptado se envía como si se hubiera escrito, así que la multiejecución y la grabación de macros también lo ven.
• Cualquier otra tecla llega a la shell como siempre: Tab sigue siendo el completado propio de la shell.
• Las sugerencias se pausan hasta el siguiente Enter cuando PlexusTerm ya no puede estar seguro de lo que contiene la línea: tras Flecha arriba/abajo (historial de la shell), Ctrl+R, el completado con Tab, la flecha izquierda u otras teclas de cursor, los atajos con Alt o un pegado de varias líneas. También se ocultan en los programas a pantalla completa (vim, less, top), en las peticiones de contraseña y de frase de contraseña, mientras el panel está desplazado hacia atrás o no tiene el foco, y cuando la shell dibuja algo tras el cursor (un prompt a la derecha u otro plugin de autosugerencias).

Cada comando enviado con Enter se registra en este equipo en history.json, en el directorio de configuración de la app (solo tú puedes leerlo), por host (user@host:port para SSH y Mosh, telnet:host:port, serial:device, local), sin duplicados y con un límite de 2000 comandos por host y 200 hosts. Nunca se registran: las líneas que empiezan con un espacio, nada de lo escrito en una petición de contraseña, frase de contraseña, PIN o código de un solo uso (reconocidas en los diez idiomas de la interfaz y en ruso, tal como las muestran sudo, ssh, PAM, cryptsetup y gpg), nada de lo escrito en un programa a pantalla completa, ni los comandos que llegan a un panel solo mediante la multiejecución.

La sección IA de los Ajustes contiene:

• Sugerencias en línea (activado por defecto): las sugerencias en gris descritas arriba.
• Historial de comandos (activado por defecto): registra los comandos y sugiere a partir de ellos. Borrar historial vacía history.json al instante.
• Sugerencias de IA (desactivado por defecto): cuando el historial no tiene nada para la línea escrita, pregunta al proveedor de IA (consulta Sugerencias de IA).
• Proveedor: Anthropic, Gemini, OpenAI, Compatible con OpenAI u OpenCode Go; URL base para un endpoint compatible con OpenAI (por ejemplo, http://localhost:11434/v1 para Ollama).
• Modelo (Anthropic: claude-opus-5-5, Gemini: gemini-3.5-flash-lite, OpenAI y compatibles: escribe tu modelo; OpenCode Go: elige uno de la lista, consulta OpenCode Go). Cambiar el proveedor mientras el modelo sigue siendo el de un proveedor por defecto lo cambia al modelo por defecto del nuevo proveedor.
• Clave de API: se guarda en el llavero del sistema, una por proveedor. El campo solo muestra si hay una clave guardada; Guardar clave y Quitar clave se aplican al instante.
• Comandos del historial enviados como contexto (0-20, por defecto 5).
• Atajo del asistente (por defecto Ctrl+Shift+Space): haz clic en el campo y pulsa la nueva combinación; Escape conserva la actual. Necesita Ctrl, Alt o Meta, y se rechazan las combinaciones que PlexusTerm ya usa.

Sugerencias de IA

Con Sugerencias de IA activado, cuando el historial no tiene ninguna sugerencia para la línea escrita, PlexusTerm espera a una breve pausa al escribir (unos 400 ms; volver a escribir la cancela) y pregunta al proveedor de IA cómo sigue el comando. La respuesta se dibuja en gris como una sugerencia del historial y se acepta con las mismas teclas.

• Se envía: la línea escrita, el sistema operativo, la carpeta actual (solo cuando la shell la indica mediante OSC 7) y los últimos comandos del historial del host (Comandos del historial enviados como contexto; 0 no envía ninguno, y tampoco se envía ninguno mientras Historial de comandos está desactivado).
• Nunca se envía: la salida del terminal, nada de lo escrito en una petición de contraseña o frase de contraseña, nada de lo escrito en un programa a pantalla completa.
• Cada panel envía como máximo una petición a la vez y como máximo una por segundo; solo espera la línea más reciente, las anteriores se descartan.
• Los fallos nunca interrumpen la escritura: el panel muestra una pequeña indicación gris en su esquina inferior derecha, como IA: sin clave de API, IA: clave rechazada, IA: límite de peticiones o IA: no disponible (pasa el puntero por encima para ver el mensaje del proveedor). Desaparece con la siguiente respuesta.

Proveedores y claves de API

Las claves de API se guardan solo en el llavero del sistema (una por proveedor), nunca en settings.json; los Ajustes solo muestran si hay una clave guardada. Las peticiones van desde el backend de PlexusTerm directamente al proveedor por HTTPS (o a la URL base que indiques), identificadas como PlexusTerm/<version>. Las redirecciones no se siguen, así que una clave nunca se reenvía a otro host; una redirección aparece como un error que te pide revisar la URL base.

OpenCode Go

Elige OpenCode Go como proveedor y guarda tu clave de API de OpenCode; no hace falta nada más.

• Modelo se convierte en una lista de los modelos de OpenCode Go con sus nombres. PlexusTerm la lee de la lista pública de OpenCode (https://opencode.ai/inference/go/v1/models) y averigua qué API usa cada modelo a partir de models.dev. La lista se conserva 24 horas en opencode-go-models.json, en el directorio de configuración de la app; Actualizar modelos la vuelve a descargar.
• Funcionan los modelos servidos con las API de chat completions, Anthropic messages u OpenAI responses. Los modelos de la API de Google se muestran como aún no compatible y no se pueden elegir.
• Si no se puede acceder a models.dev, todos los modelos se tratan como chat completions y una nota lo indica; si no se puede descargar nada, se muestra la lista guardada anteriormente, o puedes escribir un id de modelo.
• Cada petición lleva un ID de sesión (x-opencode-session), como pide OpenCode: uno por panel de terminal para las sugerencias en línea y uno por panel de chat de IA.
• OpenCode Go está pensado para agentes de programación y supervisa el tráfico; las sugerencias de IA en línea envían muchas peticiones cortas. Los Ajustes muestran esta nota cuando se selecciona OpenCode Go.

Chat de IA

El chat de IA responde a cualquier pregunta o petición con palabras sencillas (explicaciones, pasos, qué significa un error, ayuda general, cualquier tema), en el idioma en el que escribes, y ofrece un comando para su terminal solo cuando encaja uno. Pulsa Ctrl+Shift+Space (se puede cambiar en Ajustes → IA → Atajo del asistente; la tecla nunca llega a la shell) o haz clic en la X de PlexusTerm a la izquierda de la barra de herramientas: el terminal con el foco se divide y el chat se abre en un panel debajo, vinculado a ese terminal. La X gira una vez cada vez que el chat se abre o toma el foco (no cuando el sistema pide movimiento reducido).

• Cada terminal tiene como máximo un chat: pulsar el atajo en un terminal que ya tiene uno mueve el foco a él; pulsarlo en un chat vuelve a su terminal. Hacer clic en la X mientras hay un chat abierto (él o su terminal tiene el foco) cierra ese chat, con el mismo giro de la X.
• El chat cuenta como uno de los 4 paneles de la pestaña. Cuando la pestaña está llena, un aviso lo indica y no se abre ningún chat; cierra antes un panel.
• Escribe tu pregunta y pulsa Enter o Enviar (Shift+Enter empieza una línea nueva). La conversación se desplaza encima del campo de entrada. Detener cancela la respuesta que se está esperando y devuelve la pregunta al campo de entrada. Un error se muestra bajo la pregunta a la que corresponde.
• Las preguntas de seguimiento envían como contexto las preguntas y respuestas anteriores del mismo chat: como máximo las últimas 10, y como máximo 16.000 caracteres en total (primero se dejan fuera las más antiguas). Cada chat es una conversación (un ID de sesión para OpenCode).
• La respuesta se muestra como texto plano: se conservan los saltos de línea y el código entre vallas ``` se muestra en bloques monoespaciados; nada de ella se trata nunca como HTML ni se ejecuta. Se eliminan los caracteres de control y los caracteres de formato invisibles (se mantienen los saltos de línea y las tabulaciones), y una respuesta de más de 8000 caracteres se acorta y termina con "… (answer shortened)".
• Cuando un único comando de shell hace lo que pediste, se muestra debajo de la respuesta con Copiar, Insertar y Ejecutar; si no, no hay cuadro de comando. Insertar escribe el comando en el terminal del chat sin Enter y mueve el foco allí, así que no se ejecuta nada hasta que pulsas Enter tú mismo. Ejecutar borra lo que estuviera a medio escribir en ese terminal, escribe el comando y pulsa Enter; se niega (y lo indica) mientras el terminal está en una petición de contraseña o en un programa a pantalla completa como vim. Copiar lo pone en el portapapeles. No se ejecuta nada salvo que hagas clic en Ejecutar o pulses Enter. Un comando insertado se registra en el historial de comandos cuando lo envías con Enter, como uno que hayas escrito. Los comandos siempre llegan en una sola línea, sin caracteres de control ni caracteres de formato invisibles (como espacios de ancho cero o marcas de cambio a derecha a izquierda); un comando de más de 2000 caracteres se deja fuera y solo se muestra la respuesta.
• Cuando hay texto seleccionado en el terminal al abrir el chat, se adjunta a tu primera pregunta y se muestra encima del campo de entrada antes de enviarla; se envían como máximo 2000 caracteres. Haz clic en su × para dejarlo fuera. Con texto o archivos adjuntos, Enviar funciona con el campo vacío: la pregunta enviada es "Explica esto." (en el idioma de la interfaz).
• Los archivos soltados en el chat se adjuntan a la siguiente pregunta: consulta Soltar archivos en el chat de IA.
• Además de tu pregunta, el chat envía el sistema operativo, la carpeta actual del terminal (cuando se conoce) y los comandos recientes del host con las mismas reglas que las sugerencias de IA; nunca la salida del terminal.
• La cabecera del chat muestra el proveedor y el modelo; haz clic en ella para elegir otro modelo de una lista desplazable. La lista contiene los modelos de todos los proveedores con una clave de API guardada (y del servidor compatible con OpenAI cuando su URL base está definida; en opencode.ai, solo cuando ese proveedor tiene su propia clave, ya que OpenCode solo responde con una), cada uno con el nombre de su proveedor, y se puede filtrar escribiendo. Elegir uno lo convierte en el proveedor y el modelo de IA, como en Ajustes → IA, para todos los chats y para las sugerencias de IA. Un proveedor cuya lista no se puede leer muestra el motivo, y los demás se siguen listando.
• Cuando no hay ninguna clave guardada para el proveedor, el chat lo indica y Abrir los ajustes de IA abre los Ajustes en la sección IA, donde se guarda la clave.
• Conversaciones con la IA (el botón del reloj en la cabecera del chat) lista las conversaciones, de la más reciente a la más antigua, con su primera pregunta y su fecha; la actual aparece resaltada. Haz clic en una para continuarla en este chat (vuelven sus preguntas, respuestas y su sesión de IA), o en su papelera para eliminarla. Con Ajustes → IA → Guardar las conversaciones con la IA al cerrar PlexusTerm (activado por defecto) se guardan en este equipo en ai-chats.json, en el directorio de configuración de la app (solo tu usuario puede leerlo; como máximo 100, las más antiguas se eliminan primero) y se vuelven a listar tras reiniciar. Si se desactiva, no se lee ni se escribe nada y la lista solo contiene las conversaciones de esta ejecución. Una pregunta que aún espera su respuesta nunca se guarda, y de los archivos adjuntos solo se conservan sus rutas.
• El chat se cierra con la × a la derecha de su cabecera, o con Ctrl+Shift+W mientras tiene el foco. Cerrar el chat conserva su conversación: al volver a abrirlo para el mismo terminal se muestran las preguntas y respuestas anteriores y continúa la misma conversación. Nueva conversación (el botón del bocadillo junto a la ×) empieza de cero. Una conversación permanece en Conversaciones con la IA cuando se cierra su terminal o se sale de PlexusTerm, salvo que se haya desactivado guardarlas. Cerrar su terminal (o la salida de la shell) también cierra el chat.
• El chat nunca forma parte de la multiejecución, las macros nunca se reproducen en él ni graban desde él, lo que escribes en él no se registra en el historial de comandos y, mientras tiene el foco, el navegador SFTP sigue siguiendo a su terminal.