Esta página describe Calíope 1.5, la versión que estamos construyendo ahora mismo. La 1.4 está terminada y en revisión de App Store, y la tienda sirve hoy la 1.3 en el Mac y la 1.2 en iPad. El changelog dice en qué versión llegó cada función.
Añade un botón «Abrir en Calíope» a cada tema. Sólo funciona con la app instalada.
Calíope habla el idioma que le pongas en los ajustes del sistema.
Dónde está: Calíope › Preferencias › General
Calíope está traducida a cinco idiomas: español, inglés, francés, alemán e italiano. Con el sistema en cualquier otro, se ve en inglés.
El idioma lo eliges en los ajustes del sistema, no dentro de la app, y se elige por aplicación: puedes tener el aparato en un idioma y Calíope en otro.
- En el iPad y en el iPhone: Ajustes › Calíope › Idioma preferido.
- En el Mac: Ajustes del Sistema › General › Idioma y región › Aplicaciones.
En Preferencias › General verás en qué idioma está y un botón que te lleva ahí.
El cambio alcanza también al widget y a los atajos de Siri, que antes se quedaban en el idioma del aparato.
Hasta la versión anterior había un selector dentro de la app. Se retiró: duplicaba un ajuste que el sistema ya tiene, y lo que se elegía dentro no lo respetaban ni las frases de Siri ni los permisos que pide el sistema, así que la app podía acabar hablando en dos idiomas a la vez.
Palabras clave: idioma, language, español, english, inglés, francés, alemán, italiano, traducción, localización, cambiar idioma, interfaz, ajustes del sistema
Idioma, log de consultas, log de errores, biometría y consejos de uso.
Dónde está: Calíope › Preferencias › General
La pestaña General contiene las siguientes secciones:
Idioma: dice en qué idioma está Calíope y lleva al ajuste del sistema donde se cambia. No hay selector dentro de la app: el idioma se elige por aplicación en Ajustes del Sistema › General › Idioma y región › Aplicaciones, y en el iPad y el iPhone en Ajustes › Calíope › Idioma preferido. Consulta el tema Idioma de la interfaz para más detalles.
Registro: activa o desactiva el log de consultas exitosas y el log de errores de consulta. El log se almacena en UserDefaults y se puede consultar desde la pestaña Log de consultas del espacio de trabajo.
Consejos de uso: el interruptor Mostrar consejos de uso al iniciar controla si TipKit muestra globos de ayuda contextual la primera vez que usas cada función de la aplicación. Desactívalo si prefieres una interfaz sin tutoriales emergentes.
Biometría: el interruptor Requerir Face ID o Requerir Touch ID pide autenticación biométrica antes de conectar a cualquier servidor. Está en esta misma pestaña, en macOS y en iPad, y sólo aparece si el aparato tiene biometría disponible.
Palabras clave: general, preferencias, log, registro, idioma, language, biometría, face id, touch id
Permite que respaldos programados y monitoreo sigan activos al cerrar la ventana, solo en macOS.
Dónde está: Calíope › Preferencias › General
Por defecto Calíope termina por completo al cerrar la última ventana. Si tienes respaldos programados o el monitoreo de servidores habilitado, esa terminación interrumpe esas tareas en segundo plano.
Abre Preferencias › General › Comportamiento al cerrar la ventana y activa Mantener Calíope ejecutándose en segundo plano. Con la opción activada:
- El ícono del Dock desaparece cuando cierras la ventana — Calíope deja de ser una app "regular" y se vuelve accesoria.
- El ícono del menu bar (parte superior derecha de la pantalla) permanece visible y desde ahí puedes:
- Abrir ventana — reabre la interfaz en el proceso actual, conservando sesiones, conexiones y el scheduler.
- Nueva instancia — abre un proceso Calíope completamente independiente.
- Salir — termina la app de verdad.
- El scheduler de respaldos, el motor de monitoreo y el refresh del widget siguen ejecutándose.
Para volver al comportamiento por defecto desactiva el interruptor: al desactivarlo con la ventana ya oculta, Calíope vuelve inmediatamente al modo regular y reaparece en el Dock.
Esta preferencia solo aplica a macOS. En iPad el sistema operativo gestiona el ciclo de vida por sí mismo.
Palabras clave: fondo, background, menu bar, barra de menú, dock, respaldo automático, backup, scheduler, monitoreo, ejecutar siempre, segundo plano, ocultar ventana
Lanza Calíope automáticamente al entrar a tu cuenta, ideal para respaldos programados.
Dónde está: Calíope › Preferencias › General
Activa esta preferencia si quieres que Calíope se inicie automáticamente cada vez que entras a tu cuenta de macOS, sin tener que abrirla manualmente.
Cómo funciona. Calíope registra una entrada como Elemento de inicio de sesión del sistema. La primera vez que actives la opción macOS puede pedirte aprobación explícita: aparecerá un aviso o se abrirá Ajustes del Sistema › General › Elementos de inicio de sesión con Calíope listada. Confirma ahí y queda activado.
Cuándo es útil.
- Respaldos programados. Si dependes del scheduler de respaldos diarios o semanales, combinar esta opción con Mantener Calíope ejecutándose en segundo plano da el flujo completo: al iniciar sesión arranca Calíope; cuando cierras la ventana queda en menu bar; los respaldos disparan a su hora sin que tengas que abrir nada.
- Monitoreo de servidores. Si dejaste el monitoreo activo en pestañas de Dashboard, los snapshots siguen acumulándose desde el primer minuto de la sesión.
Cómo administrarlo desde el sistema. En cualquier momento puedes abrir Ajustes del Sistema › General › Elementos de inicio de sesión y desactivar Calíope desde ahí — el toggle de Preferencias refleja ese cambio la próxima vez que abras Preferencias.
Si la activación falla. Bajo el toggle aparecerá un mensaje en naranja con el motivo. La causa más común es que macOS tiene a Calíope bloqueada en Elementos de inicio de sesión (por una desactivación manual previa). Abre Ajustes del Sistema, permite Calíope y reintenta.
Esta preferencia solo aplica a macOS. En iPad no existe el concepto de Login Items.
Palabras clave: login, inicio de sesión, arranque, automático, startup, autostart, respaldo automático, scheduler, elementos de inicio, iniciar al encender
Fuente, tabulación, auto-completado y opciones del editor SQL.
Dónde está: Calíope › Preferencias › Editor de texto
Texto:
- Tamaño de fuente del editor (10–26 pt) — controla el tamaño del texto en el área de escritura del editor SQL.
- Tamaño de tabulación (2–30 espacios) — número de espacios que inserta la tecla Tab al indentar código SQL.
Características:
- Indentación automática — al presionar Enter en el editor, la nueva línea se indenta al mismo nivel que la anterior. Útil para escribir bloques BEGIN…END o subconsultas anidadas.
- Autocompletar palabras clave SQL — muestra sugerencias de palabras clave MySQL/MariaDB mientras escribís. Puede activarse/desactivarse sin reiniciar la app.
- Convertir keywords a mayúsculas al formatear SQL — al usar Beautify, SELECT, FROM, WHERE, etc. se escriben en mayúsculas.
- Mostrar números de línea — muestra el número de cada línea en el margen izquierdo del editor, útil para referenciar errores.
- Limpiar espacios al final de la línea — elimina automáticamente los espacios en blanco sobrantes al final de cada línea antes de ejecutar o guardar el contenido del editor.
Tamaño de letra de la tabla de resultados:
La barra de resultados del Editor SQL tiene su propio control de tamaño, junto a la palabra tabla: dos botones y el número entre ellos, de 11 a 26 puntos. Es independiente del tamaño del editor y también se puede cambiar pellizcando con dos dedos sobre la rejilla —trackpad en macOS, dos dedos en iPad—. El valor se guarda entre sesiones.
Palabras clave: editor, fuente, font size, tab size, auto complete, números de línea, indentación, resultados, zoom fuente, tamaño de fuente, trailing spaces, mayúsculas, keywords
Agrupa, ordena, mueve y elimina los perfiles de conexión guardados.
Dónde está: Calíope › Preferencias › Conexiones
La pestaña Conexiones está en macOS y en iPad, y es el inventario de todos los perfiles guardados.
Van agrupadas por su grupo, con el nombre del grupo y cuántas conexiones tiene dentro en cada cabecera; las que no pertenecen a ninguno caen en Sin grupo, al final. Dentro de cada grupo se ordenan alfabéticamente por nombre.
Cambiar el orden. En macOS, pulsando la cabecera de cualquier columna: nombre, tipo, usuario, servidor, puerto, base de datos o cotejamiento. En iPad, con el selector Ordenar por del pie, que ofrece nombre, servidor, usuario y tipo. Los grupos no cambian de sitio: el orden que eliges es el de dentro de cada uno.
Qué se puede hacer sobre una conexión. Clic derecho en macOS, mantener pulsado en iPad: probar la conexión, moverla a otro grupo —o sacarla de todos— y eliminarla. En iPad también se elimina deslizando la fila hacia la izquierda. Eliminar pregunta antes y nombra la conexión, porque se lleva con ella su contraseña guardada, su historial de consultas y el SQL que tuviera almacenado, y no hay deshacer.
Para editar los datos de un perfil —host, credenciales, SSL, túnel SSH— vuelve al Gestor de conexiones, que es la pantalla de inicio antes de conectar, y selecciónalo en la barra lateral. Esta pestaña no edita: gestiona.
Importar / Exportar perfiles: el pie incluye botones para exportar todos los perfiles a un archivo JSON y para importar desde uno exportado antes. Útil para migrar configuraciones entre equipos o para guardar una copia. La exportación no incluye contraseñas —viven en el Llavero— ni el contenido de certificados y claves, sólo sus rutas.
Configura el proveedor, las API keys y la longitud de respuesta globalmente.
Dónde está: Calíope › Preferencias › Asistente AI
Elige el proveedor y rellena lo que ese proveedor necesite: los de nube piden tu API key; Apple Intelligence no pide nada, porque el modelo corre en el aparato; Ollama pide la dirección donde escucha, y ninguna clave. Donde se elige modelo, el botón de recarga lista los que ese proveedor publica: en la nube, los de tu cuenta; en Ollama, los que hayas descargado.
La sección Generación contiene la casilla Mandar esquema al modelo y el selector Longitud máxima del SQL, que determina cuántos tokens puede generar el modelo en cada respuesta. Consulta el tema Longitud máxima del SQL generado para saber cuándo usar cada opción.
Si el proveedor pide clave y todavía no la tienes, el asistente funciona en modo demo con respuestas de ejemplo. Lo que se guarda aquí vale para el Asistente IA en todas las pestañas y en las tres plataformas (macOS, iPad e iPhone).
Palabras clave: IA, OpenAI, Gemini, Claude, Apple Intelligence, Ollama, API key, modelo, GPT, configurar asistente, tokens, longitud máxima, generación, sin clave, local
Cómo se reparten las burbujas de ayuda: una cada vez que entras a una herramienta, nunca dos a la vez.
Dónde está: Calíope › Preferencias › General
Calíope trae más de setenta consejos de uso: burbujas cortas ancladas al control del que hablan, para funciones que no se deducen mirando.
Se reparten de uno en uno
Cada herramienta tiene su propia lista ordenada. Al entrar verás como mucho un consejo, y en la visita siguiente te tocará el que sigue. El Editor SQL, por ejemplo, tiene veintitrés: los irás viendo a lo largo de veintitrés visitas, nunca todos de golpe.
Se ordenan por lo que más te ahorra
Van delante los que evitan un error —el desajuste entre buscar y reemplazar, el modo seguro— y detrás los de conveniencia. Si dejas de usar una herramienta pronto, habrás visto los que importaban.
Un consejo se gasta al mostrarse
Se marca como visto cuando aparece, no cuando lo cierras: si entras y sales enseguida, ese consejo ya no volverá. Es deliberado —se prefiere no repetirle nada a nadie— y para eso está el botón de volver a verlos.
Activar, desactivar y repetir
- Preferencias › General › Consejos gobierna los dos: el interruptor los apaga en el acto, y Volver a mostrar los consejos los repone desde el primero.
- El reinicio lo aplica la app al arrancar, así que hay que cerrarla y volver a abrirla. La pantalla lo avisa cuando queda pendiente.
En el iPhone van aparte
En el iPhone corre Calíope, así que sus consejos son los mismos y su interruptor es el mismo — uno por aparato, como toda preferencia de esta clase.
No bloquean nada
Se cierran con un toque o un clic fuera de la burbuja y no piden confirmación.
Palabras clave: consejos, burbujas, ayuda contextual, tooltip, onboarding, primera vez, tutorial, restablecer consejos, mostrar consejos, volver a mostrar, tipkit
Calíope puede avisarte de lo que pasa mientras estás mirando otra cosa. Todos los avisos son notificaciones locales: las produce la app en tu aparato y no pasan por ningún servidor.
De qué avisa
• Query larga completada: cuando una consulta pasa del umbral que fijes (por omisión, 5 s).
• Túnel SSH: cuando el túnel se cae, y cuando vuelve.
• Respaldo manual: al terminar y al fallar. Estos dos son los únicos que se callan si tienes Calíope delante.
• Sincronización de iCloud: cuando falla. Sólo aparece con iCloud activado.
• Volumen de filas: cuando un resultado pasa del número de filas que fijes.
El permiso se pide al encender un interruptor, no al arrancar la app: hasta que no dices que quieres un aviso, Calíope no le pregunta nada al sistema. Si los tienes denegados en los ajustes del sistema, esta sección te lo dice arriba y te lleva allí — con el permiso denegado no llega ninguno, aunque los interruptores estén encendidos.
Un aviso no se repite. Cada tipo tiene un enfriamiento de un minuto; el de iCloud, de quince. Un túnel que se cae y vuelve treinta veces en un minuto avisa una sola vez.
Lo que se avisa, se registra. Con los mensajes del sistema encendidos, cada aviso deja además un mensaje en el buzón que leen el iPhone y el reloj, detrás del mismo interruptor y con el mismo enfriamiento: sin eso, un aviso dejaría treinta filas en la muñeca. Los dos del respaldo manual son la excepción, porque su mensaje ya lo emite el historial de ejecuciones y aquí saldría duplicado.
El botón Probar manda una notificación de ejemplo, para ver cómo la enseña el sistema.
Palabras clave: notificaciones, avisos, alertas, permiso, enfriamiento, banner, probar, segundo plano
Cuando cierras Calíope, la app guarda un snapshot local con las pestañas abiertas por servidor (indexadas por perfil de conexión). En la próxima ejecución, al reconectarte manualmente a ese servidor, las pestañas vuelven contigo automáticamente.
Calíope nunca reabre conexiones al arrancar. El motivo es de seguridad y de UX:
- Reabrir sesiones autenticadas sin que ingreses la contraseña sería inseguro.
- Encadenar prompts de contraseña para varias sesiones al arrancar es molesto.
- Un servidor caído bloquearía el arranque de la app.
Por eso el flujo es explícito: al arrancar ves el Gestor de conexiones; cuando eliges un perfil y te conectas, si había pestañas guardadas para ese perfil aparecen en el workspace.
Preferencias › Restaurar pestañas te deja elegir:
- Reabrir mis pestañas anteriores (por defecto) — restaura las pestañas al reconectar al mismo servidor.
- Empezar limpio — descarta el snapshot y siempre arranca con una pestaña vacía.
Qué se restaura y qué no:
- ✅ Pestañas por perfil (SQL Editor, Dashboard, Catálogos, ER Diagram, Backup, etc.) con su título y payload inicial.
- ✅ El SQL escrito en cada editor ya se preserva por su cuenta en editor_state.json.
- ✅ Pestañas del editor sin conexión — sí se restauran de inmediato al arrancar (no requieren autenticación).
- ❌ Conexiones MySQL / túneles SSH — nunca se reabren automáticamente.
- ❌ Resultados de queries, progresos en curso de backup/migración/mantenimiento — son estados vivos, no se revivien.
Almacenamiento: el snapshot vive en ~/Library/Application Support/Caliope/session_restore.json. Es por dispositivo — no se sincroniza vía iCloud, porque el workflow ideal de macOS (multi-tab pesado) suele diferir del de iPad (una tarea a la vez).
Mantén conexiones, fragmentos, historial y preferencias sincronizados entre todos tus dispositivos Apple.
Dónde está: Calíope › Preferencias › General
Calíope puede sincronizar tus datos entre macOS, iPad e iPhone mediante iCloud, eliminando la necesidad de configurar manualmente cada dispositivo.
Qué se sincroniza:
- Perfiles de conexión (connections.json) — todos tus servidores guardados.
- Estado del editor (editor_state.json) — el último SQL que tenías abierto.
- Modo seguro (editor_safemode.json) — el estado del interruptor de modo seguro.
- Preferencias — tamaño de fuente, opciones del editor, configuración de IA.
- Fragmentos SQL — tu colección de fragmentos de código guardados.
- Historial de consultas — las últimas 100 entradas por servidor (por límite de iCloud KV Store).
- Layouts ER — las posiciones guardadas de los nodos en los diagramas ER.
- Contraseñas — las credenciales se migran automáticamente entre el Llavero local y el Llavero de iCloud.
Cómo activar la sincronización:
1. Asegúrate de que iCloud esté activo y que hayas iniciado sesión en tu ID de Apple en Preferencias del Sistema › ID de Apple.
2. Abre Preferencias › General › iCloud.
3. Activa el interruptor Sincronizar Calíope con iCloud.
4. Confirma en el diálogo pulsando Activar y migrar datos.
5. Los datos locales se copian a iCloud y la sincronización queda activa.
Cómo desactivar la sincronización:
1. Abre Preferencias › General › iCloud.
2. Desactiva el interruptor.
3. Confirma en el diálogo pulsando Desactivar.
4. Los datos se copian de vuelta al almacenamiento local. La copia en iCloud no se elimina.
Si iCloud no está disponible:
Cuando el dispositivo no tiene sesión de iCloud activa, el interruptor aparece deshabilitado con el mensaje \"iCloud no disponible. Inicia sesión en Preferencias del Sistema → ID de Apple.\"
Límites de sincronización:
iCloud KV Store tiene un límite de 1 MB. Calíope trunca el historial de consultas a las 100 más recientes por servidor antes de sincronizar para mantenerse dentro del límite. Si el uso supera el 80% del límite, se registra una advertencia en el diagnóstico local.
Privacidad y queries — aviso importante:
El historial de queries sincronizado puede contener información sensible: contraseñas embebidas en SQL, datos personales (nombres, correos, IDs), datos financieros u otra información confidencial. Antes de activar la sincronización con iCloud, revisa que tu historial no incluya este tipo de datos. Calíope te mostrará este aviso en el diálogo de activación y en la sección iCloud de Preferencias mientras la sync esté activa. Para borrar el historial, usa Preferencias › General › Eliminar mis datos.
Impide que el equipo entre en reposo por inactividad mientras tienes un trabajo largo en marcha.
Dónde está: Área de trabajo › Mantener activo
El botón de la taza en la barra de herramientas mantiene el Mac despierto. Sirve cuando un respaldo, una importación o una consulta larga necesitan terminar y tú vas a apartarte del teclado.
Es manual e indefinido: no expira por tiempo y no se enciende solo para ninguna tarea. Lo enciendes tú y sigue encendido hasta que lo apagues o cierres Calíope. Nunca se restaura en el siguiente lanzamiento, justamente para que nadie acabe la semana con un portátil que lleva días despierto.
Hay dos niveles. Por defecto el sistema se mantiene despierto pero la pantalla puede apagarse: eso gasta menos batería y genera menos calor. En Ajustes › General puedes mantener también la pantalla encendida, que solo hace falta si vas a seguir mirando la pantalla. Cambiar esa preferencia con el modo encendido surte efecto de inmediato.
Mientras está activo, la barra de estado del pie de la ventana muestra un indicador, así que nunca está encendido sin que puedas verlo. También puedes conmutarlo desde Ventana › Mantener activo, o con Control-Opción-C.
Para comprobarlo por ti mismo, ejecuta «pmset -g assertions» en Terminal: el assertion aparece con el nombre de Calíope.
En iPad el alcance es distinto: mantiene la pantalla encendida, y solo mientras Calíope está en primer plano. iPadOS no ofrece una forma de mantener el sistema despierto separada de la pantalla.
Cerrar la tapa es un reposo por hardware, y ninguna app puede evitarlo.
Dónde está: Área de trabajo › Mantener activo
«Mantener activo» bloquea el reposo por inactividad, que es el que ocurre cuando dejas de usar el equipo. Cerrar la tapa es otra cosa: es un reposo forzado por hardware, y ninguna aplicación puede evitarlo — ni Calíope, ni el comando «caffeinate» del Terminal.
La única forma de seguir trabajando con la tapa cerrada es el modo clamshell, que exige el Mac conectado a la corriente y a una pantalla externa, más un teclado o ratón externos. En esa configuración el Mac se mantiene despierto por sí solo y no necesitas «Mantener activo» para nada.
Otros dos límites que conviene conocer: un assertion no despierta una máquina que ya está dormida, solo evita que se duerma; y tampoco bloquea un reposo manual desde el menú Apple.
Un único sitio donde ver todo lo que Calíope tiene en marcha, aunque estés en otra pestaña, en otro servidor o en otra aplicación.
Dónde está: Área de trabajo › Actividad
El estado se muestra en tres lugares, cada uno para una pregunta distinta:
· Un punto junto al nombre de la pestaña cuando esa pestaña está trabajando, y junto al selector de servidor cuando el trabajo está en otra conexión. Es lo que resuelve el caso de lanzar una consulta y cambiarse de sitio.
· El pie de la barra lateral, donde ya estaban el uso de CPU y de memoria, abre el detalle completo: qué corre, en qué servidor, desde cuándo, con su progreso si se conoce, más los modos activos y las últimas operaciones terminadas.
· Un testigo en la barra de herramientas, junto al botón de «Mantener activo», con el número de operaciones en curso. Existe porque la barra lateral se puede ocultar. Abre el mismo panel.
La barra de estado inferior sigue contando lo de la pestaña que tienes delante; solo añade un aviso cuando hay trabajo fuera de la vista.
Cuando la app no está en primer plano, el aviso de que algo terminó llega por notificación del sistema. Eso se configura en Preferencias › Notificaciones.
Palabras clave: actividad, en curso, segundo plano, progreso, indicador, ocupado
Tareas y modos son cosas distintas, y las operaciones instantáneas no se anuncian.
Tareas empiezan y terminan: consultas y lotes de sentencias, respaldos manuales y programados, restauraciones, migraciones de datos, mantenimiento de tablas, importaciones, peticiones al asistente IA, sincronización con iCloud y el refresco del widget. Llevan tiempo transcurrido y, cuando se sabe, progreso.
Modos están encendidos hasta que alguien los apaga: «Mantener activo», la monitorización de servidores, tener respaldos programados y los túneles SSH abiertos. No terminan, así que no llevan barra ni cronómetro; van en su propia sección y no cuentan para el número del testigo.
Lo que no aparece: nada que dure menos de un segundo. Cargar el árbol de esquema, abrir un diagrama o listar columnas es instantáneo en el caso normal, y anunciarlo sería un parpadeo que acabaría enseñando a ignorar el indicador.
Si una operación no lleva progreso es porque el servidor no dice cuánto queda. En ese caso se muestra el tiempo transcurrido: una barra que avanza sola sería una invención.
Palabras clave: tareas, modos, umbral, progreso, ruido, qué aparece
Cada entrada del panel ofrece solo lo que de verdad puede hacer.
Ir a activa la sesión y la pestaña donde vive la tarea. Un respaldo programado no tiene pestaña —salta por su cuenta, sin que nadie lo abra—, así que en su lugar el panel dice que no hay destino en vez de dejar un botón que no lleva a ninguna parte.
Detener solo aparece cuando la operación se puede parar de verdad:
· Una consulta se corta con un KILL QUERY sobre su propia conexión, que no exige el privilegio PROCESS. Si ese aviso no llega a enviarse, se dice: la consulta puede seguir viva en el servidor.
· Los respaldos manuales, las restauraciones, las migraciones y el mantenimiento de tablas se detienen desde el propio panel o desde su herramienta.
· Los respaldos programados, la sincronización y el refresco del widget no se detienen a mitad: no llevan botón.
«Sin confirmar». Si una tarea lleva más de seis horas en la lista se marca así. No se retira sola, porque un REPAIR sobre una tabla grande puede tardar de verdad ese tiempo y hacerla desaparecer sería mentir; en su lugar aparece «Descartar» para quitarla a mano si sabes que ya no está.
Palabras clave: detener, cancelar, ir a, kill query, sin confirmar, descartar