Todo es un archivo

funcional

Las conexiones, el historial, los fragmentos, las tarjetas y las reglas viven como archivos de texto plano que puedes inspeccionar, conservar y guardar como copia de seguridad.

Conexiones, historial de consultas, fragmentos, tarjetas de entidades, atajos de teclado y reglas se guardan todos como archivos simples en disco. No hay una base de datos de aplicación opaca de la que escapar más adelante: hazles copia de seguridad, compara sus diferencias o mantenlos en Git si eso encaja con tu flujo de trabajo.

Dónde están

Todo se encuentra en una SQLLY carpeta bajo las ubicaciones normales de configuración y datos de tu plataforma:

PlataformaCarpeta
macOS~/Library/Application Support/SQLLY/
Windows%APPDATA%\SQLLY\ y %LOCALAPPDATA%\SQLLY\
Linux~/.config/SQLLY/ y ~/.local/share/SQLLY/

Algunos de los archivos que encontrarás ahí:

  • connections.json - tus conexiones y los clientes, proyectos y entornos a los que pertenecen, con sus colores y su política de seguridad. Nunca contraseñas (ver abajo).
  • keybindings.json - tu mapa de teclas, editable a mano.
  • intellisense-rules.jsonc - reglas de autocompletado, con comentarios permitidos porque un archivo de reglas que no puedes anotar es un archivo de reglas que no vas a mantener.
  • entra-accounts.json, query-ai-summary.json, cli-agent.json - ajustes por función, un archivo por función, de modo que restablecer sea borrar un archivo y no una cirugía.
  • Carpetas para el historial de consultas, las conversaciones con IA, las propuestas de MCP y su auditoría, y los archivos temporales de volcado de resultados.
Los secretos son la excepción, a propósito. Las contraseñas y los tokens van al llavero del sistema operativo (Keychain de macOS, Windows Credential Manager, Secret Service de Linux), y el JSON almacena solo una referencia a ellos. Eso es lo que hace que sea seguro copiar, comparar o confirmar tu archivo de conexión: las credenciales no están en él.

Archivos de configuración versionados

connections.json, tenant-scoping.json, y todos los demás archivos de ajustes registran la versión de configuración con la que se guardaron. Cuando SQLly se inicia y encuentra un archivo guardado por una versión anterior, lo actualiza una vez y lo guarda con la versión actual. En esta versión, la actualización borra los ajustes de alcance por inquilino guardados por versiones anteriores (ver Ámbito de inquilinos). No tienes que hacer nada.

Por qué esta forma

  • Puedes irte. Tu configuración se puede leer sin SQLly, y es portable con cp.
  • Puedes revisar. Un cambio en una conexión o un mapa de teclas aparece como un diff que puedes leer, que es el único tipo de cambio de configuración que sobrevive en un equipo.
  • Puedes arreglarlo. Cuando algo está mal, es un archivo que puedes abrir, no una base de datos que necesita un ticket de soporte.
  • La sincronización no es nuestro problema. Porque son solo archivos, sirve cualquier herramienta que sincronice archivos, y nosotros no tenemos que estar en medio.