Skip to main content
Esta página reúne las preguntas más comunes de los usuarios de Linkly AI.

​
¿Cómo protege Linkly AI la privacidad de los datos?

Linkly AI utiliza una arquitectura local-first. Los documentos originales, el índice de texto completo, el índice vectorial y la inferencia del modelo de embeddings se ejecutan en tu dispositivo y, por defecto, no se suben a ningún servidor.

​
Qué datos se quedan en local

  • Documentos originales: permanecen en sus carpetas originales. Linkly AI solo los lee — no los copia ni los mueve.
  • Índice de texto completo (BM25): construido localmente con Tantivy.
  • Índice vectorial: los embeddings se guardan en una base de datos local.
  • Modelo de embeddings: un modelo de embeddings local se ejecuta completamente en tu dispositivo; en Apple Silicon se activa automáticamente la aceleración GPU Metal, y en Windows / Linux se usa la GPU cuando hay una gráfica dedicada.
  • Registros de la aplicación: solo se escriben en archivos locales y nunca se suben automáticamente.

​
A dónde van los datos del chat con IA

Cuando el chatbot llama a un modelo de lenguaje grande, el flujo de datos depende del provider que hayas elegido:

Modelo local

Ollama, LM Studio u otro servicio local compatible con OpenAI. Los datos se quedan totalmente en tu máquina.

Linkly oficial

Se reenvía a un proveedor de modelos de terceros vía api.linkly.ai. Las solicitudes pasan por los servidores de Linkly.

Tercero directo

Conexión directa a OpenAI, Anthropic, etc. Las solicitudes no pasan por los servidores de Linkly.
Puedes añadir, cambiar o desactivar cada provider en Ajustes → Modelos de IA.

​
Programa de mejora de la experiencia (telemetría)

Para entender qué funciones se usan y en qué entornos se ejecuta la app, Linkly AI envía por defecto un informe de uso anónimo: Puedes desactivarlo en cualquier momento desde Ajustes → Privacidad → Programa de mejora de la experiencia. Al desactivarlo, los eventos pendientes en memoria también se descartan.
El panel «Privacidad de los datos» de los ajustes muestra con tres tarjetas el flujo de datos de cada función (Local / Nube oficial / Terceros), para que veas de un vistazo qué datos salen de tu dispositivo.

​
Compromiso de privacidad

  • No incluimos SDKs de analítica de terceros (Google Analytics, etc.).
  • No leemos tu historial de navegación ni el portapapeles.
  • No exigimos cuenta — las funciones principales funcionan offline.
  • Los registros de la aplicación se quedan en tu máquina y solo se nos envían si los compartes explícitamente.

​
¿Cuánto tarda en completarse la indexación de Linkly AI?

El tiempo de indexación depende del número de archivos, sus tipos, el rendimiento de la máquina y el modo de rendimiento. Linkly AI indexa en tres fases:
1

Indexación rápida de nombres (segundos)

En cuanto se detectan archivos, se escriben sus rutas y nombres en el índice de texto completo, para que puedas buscar por nombre incluso mientras se indexa el contenido.
2

Extracción y BM25 (minutos a horas)

El contenido de los documentos (txt, md, html, docx, doc, pptx, xlsx, csv, epub, rtf, pdf, imágenes y, si has activado la transcripción, también audio y vídeo) se analiza; los esquemas y metadatos se escriben en Tantivy. Pueden ejecutarse varios workers en paralelo.
3

Embeddings vectoriales (minutos a horas)

El modelo de embeddings local genera un vector por cada fragmento del documento y lo escribe en el índice vectorial.

​
Factores que afectan a la velocidad

  • Número de archivos: aproximadamente lineal con el tiempo total.
  • Formato de archivo: el texto plano es lo más rápido; los PDF requieren analizar páginas.
  • Rendimiento de la máquina: en Apple Silicon (serie M) la aceleración GPU Metal acelera mucho los embeddings frente a la inferencia en CPU; en Windows / Linux los embeddings usan la GPU cuando hay una gráfica dedicada y, si no la hay, la CPU.
  • Modo de rendimiento: en el bloque «Política» de la página Gestión del índice puedes elegir Rendimiento / Equilibrado / Automático. Rendimiento usa más concurrencia y más CPU; Automático cambia a Rendimiento cuando el equipo está inactivo.

​
Estimaciones aproximadas

Son solo órdenes de magnitud — el tiempo real varía mucho según el hardware y la mezcla de archivos:
En la página Gestión del índice de la ventana principal puedes ver el progreso en tiempo real (Procesado / Pendiente / No extraíble). Mientras se indexa, el pie del lanzador muestra un icono girando; al pulsarlo también se abre esa página. La indexación corre en segundo plano y no bloquea la búsqueda — en cuanto termine la indexación de nombres, ya puedes buscar.
Si solo estás probando Linkly AI, empieza con una base de conocimiento pequeña (cientos a miles de archivos) y añade directorios más grandes cuando te sientas cómodo.

​
¿Los modelos de embedding y de OCR usan la gráfica integrada o la dedicada?

En Windows y Linux solo se usa la gráfica dedicada; la integrada no participa. En las pruebas, la gráfica integrada ejecutaba estos modelos más despacio incluso que la CPU del mismo equipo, así que, si no hay gráfica dedicada, se usa directamente la CPU. Los Mac con chip de Apple usan la GPU integrada en el chip. Cada tarea la usa de forma distinta: Algunos detalles más:
  • El análisis de diseño del OCR solo usa la GPU con PDF de 4 páginas o más. Las imágenes sueltas y los PDF con pocas páginas usan la CPU.
  • Si hay varias gráficas dedicadas, el índice semántico solo usa la primera de la lista del sistema, sin elegir por memoria de vídeo. El análisis de diseño del OCR usa la gráfica que tengas asignada a Linkly AI en la configuración de gráficos de Windows.
  • Si falta memoria de vídeo, el controlador no es compatible o la GPU falla repetidamente, se pasa automáticamente a la CPU y la indexación no se interrumpe.
  • Cuando el índice semántico usa el modelo en la nube, la GPU local no participa. Los dispositivos Windows y Linux con arquitectura ARM usan por ahora solo la CPU.
Si no quieres usar la GPU en absoluto: haz clic en el icono de estado del índice en la parte inferior de la barra lateral izquierda de la ventana principal para abrir la página «Gestión del índice» y, en la sección «Hardware» de la pestaña «Avanzado», desactiva «Aceleración por hardware».
  • Windows y Linux: al desactivarla todo usa la CPU, más lento pero más estable.
  • Mac: este interruptor solo controla si el análisis de diseño del OCR usa la GPU; el índice semántico y la transcripción no se ven afectados.
Si vuelves a activarlo, se intentará usar la GPU de nuevo.

​
¿Por qué no encuentro un archivo?

Empieza por un triaje: búscalo por su nombre de archivo. Los tres desenlaces posibles corresponden a tres problemas completamente distintos: Este paso es clave: los tres casos se tratan de forma muy distinta, y saltárselo lleva a perder mucho rato buscando en la dirección equivocada.
Todos los archivos cuyo texto no ha llegado al índice se pueden consultar, agrupados por motivo, en la pestaña «No extraíble» de la página Gestión del índice; en la mayoría de las categorías se puede pulsar «Reintentar todo» o reintentar archivo por archivo.
Los archivos y carpetas excluidos por una regla de exclusión no aparecen en la lista de archivos de la biblioteca. La carpeta que los contiene muestra un icono de embudo junto a su nombre: al pasar el ratón por encima ves qué se ha excluido, y al hacer clic se abre la regla correspondiente.

​
Qué significa cada insignia

Al pasar el ratón por encima de la insignia se da esa misma explicación. Estos archivos siguen apareciendo en los resultados, solo que sin contenido que buscar. Los archivos con extracción fallida se reintentan solos cuando cambia su contenido, y también se pueden reintentar a mano en la pestaña «No extraíble».

​
Qué son los marcadores de la nube

iCloud Drive, OneDrive, Dropbox o Synology Drive tienen todos una función de descarga bajo demanda (también llamada «solo en línea» o «sincronización inteligente»): el archivo se ve en el Finder o el Explorador, pero su contenido sigue estando en la nube y solo se descarga de verdad cuando lo abres. Linkly AI evita a propósito abrir esos archivos: abrirlos dispararía la descarga, y eso significaría que una sola indexación podría traerse a local cientos de GB de tu nube, llenando el disco y saturando el ancho de banda. Por eso se limita a mirar los atributos y, en cuanto reconoce un marcador, omite el contenido y conserva la indexación del nombre.
Qué hacer: en el cliente de tu servicio en la nube, marca las carpetas que de verdad necesitas buscar como «mantener siempre en este dispositivo» (cada uno lo llama de una forma: OneDrive dice «Conservar siempre en este dispositivo», Dropbox «Hacer local» y en iCloud es «Descargar ahora» con el botón derecho). Una vez que los archivos estén en local, Linkly AI verá en el siguiente escaneo que ya están disponibles y completará solo la indexación del contenido: no hay que reconstruir el índice ni volver a añadir la carpeta.
Los escaneos se disparan solos al arrancar la aplicación, al cambiar la configuración (por ejemplo al añadir o quitar carpetas) y al detectar muchos cambios de archivos. Si quieres provocar uno ya mismo, lo más cómodo es reiniciar la aplicación.

​
Qué hacer si la firma del archivo no coincide

Significa que los bytes característicos de la cabecera del archivo no cuadran con su extensión. Es habitual en archivos alias o stub de ciertas herramientas de sincronización, en descargas interrumpidas a medias, o en archivos a los que alguien cambió la extensión a mano. Ábrelo con el programa correspondiente para comprobarlo: si tampoco se abre ahí, Linkly AI hizo bien en omitirlo; y si lo que pasa es que la extensión está mal escrita, basta con corregirla.
El criterio de Linkly AI aquí es antes dejar pasar que descartar por error: si al leer la cabecera se topa con un error de E/S puntual o un vaivén de permisos, lo trata siempre como «contenido disponible» y nunca marca un archivo real como señuelo por un fallo momentáneo.

​
Aparece por el nombre, sin insignia, pero no encuentro su contenido

Que no haya insignia significa que el archivo en sí está bien: lo que pasa es que el paso de extracción del contenido aún no se ha hecho, o no se puede hacer. De más a menos probable:
  1. El extractor correspondiente está apagado. Las imágenes y los PDF escaneados dependen del Reconocimiento de texto (OCR), y el audio y el vídeo de la Transcripción de audio y la Transcripción de vídeo — y estas dos últimas vienen desactivadas por defecto. Compruébalo en el bloque «Gestión» de la página Gestión del índice.
  2. Todavía no le ha tocado el turno. El OCR y la transcripción de audio y vídeo son las tareas más pesadas, así que es normal que la cola avance despacio. En el bloque «Gestión» de la página Gestión del índice se ve qué archivo están procesando en cada momento.
  3. Un .doc heredado exportado en macOS todavía no se puede analizar. Los archivos generados por textutil o por la exportación «Word 97» de Pages usan una disposición interna distinta a la de Microsoft Word, así que por ahora se omiten. Vuelva a guardarlos como .docx en Word, o conviértalos a otro formato admitido.

Ajustes de indexación

Para qué sirve cada interruptor, qué valor trae por defecto y qué significa cada estado: todo está en esta página.

​
Ni siquiera aparece por el nombre del archivo

Esto significa que el archivo no ha entrado en el índice en absoluto. Hay cinco causas habituales: Uno: esa carpeta no está vigilada. Ve a «Biblioteca», en la ventana principal, y comprueba que su carpeta superior está añadida. Si no lo está, pulsa «Añadir carpeta» en la columna izquierda de la biblioteca para añadirla. Dos: ese formato no está en la lista de admitidos. Linkly AI trabaja con una lista blanca: solo se recogen las extensiones de PDF, DOCX, DOC, PPTX, XLSX, CSV, EPUB, RTF, Markdown, TXT, HTML, imagen, audio y vídeo. Por ahora htm y avi no están entre ellas, y un archivo fuera de la lista blanca no llega ni a registrar su nombre. La lista completa está en la introducción a las herramientas. Tres: está dentro de una carpeta ignorada. Estas carpetas se omiten enteras, con todas sus subcarpetas:
  • Carpetas ocultas que empiezan por punto (.git, .cache, .dropbox.cache, etc.)
  • node_modules, __pycache__ y demás cachés de compilación o dependencias
  • Carpetas de metadatos de sincronización de NAS: #recycle, #SynoRecycle, @eaDir (Synology), @Recycle (QNAP)
  • Carpetas del sistema: $RECYCLE.BIN, System Volume Information
  • Los archivos de datos de Linkly AI: la carpeta de datos de la aplicación ai.linkly.desktop, esté donde esté
Dentro de un repositorio Git, los archivos excluidos por .gitignore tampoco se indexan. Si tus notas están justo en una carpeta ignorada de algún repositorio, sácalas de ahí o añade esa carpeta por separado con «Añadir carpeta» en la columna izquierda de «Biblioteca». La lista completa de reglas integradas está al final de la pestaña «Reglas» de la página Gestión del índice.
Cuatro: ese tipo de archivo está desactivado. Los tipos que desactives en Gestión del índice → Reglas → Tipos de archivo (por ejemplo, imágenes o vídeo) no se analizan, y los que ya estaban indexados se quitan del índice. Cinco: lo excluye una regla de exclusión. Ve a Gestión del índice → Reglas → Reglas de exclusión y revisa las reglas de «Todas las carpetas» y las de esa carpeta; al editarlas, debajo se listan los archivos que excluye cada regla. Las carpetas con un icono de embudo al final de la fila, en la columna izquierda de la biblioteca, son las que tienen reglas de exclusión. Un archivo .ignore en la carpeta también puede excluir archivos. Más detalles en Alcance del índice.

​
¿Puedo añadir archivos de un NAS?

Sí. Primero monta en el sistema la carpeta compartida del NAS y después añádela a la biblioteca como cualquier carpeta local:
  • Windows: en el Explorador de archivos, usa «Conectar a unidad de red» (por ejemplo, Z:\), o usa directamente una ruta de red como \\nombre-del-NAS\recurso-compartido
  • macOS: en el Finder, elige «Ir → Conectarse al servidor» e introduce smb://dirección-del-NAS/recurso-compartido; una vez montada, aparece en /Volumes
  • Linux: monta el recurso compartido SMB / NFS con la función de ubicaciones de red del sistema o con mount
Después, en «Biblioteca», en la ventana principal, pulsa «Añadir carpeta» en la columna izquierda y elige la carpeta montada. Estas carpetas llevan la marca «Externa». Al usar un NAS, ten en cuenta que:
  • Si el NAS se desconecta o no está montado, el contenido ya indexado no se pierde. En la biblioteca, esa carpeta aparece como «Sin conexión»; la aplicación lo comprueba cada 15 minutos y vuelve a escanear sola cuando se recupera la conexión.
  • Si otro ordenador modifica archivos del NAS, este equipo no siempre lo detecta de inmediato. El sistema no siempre avisa a tiempo de los cambios en recursos de red, sobre todo en macOS y Linux; los cambios que se pierdan se recuperan la próxima vez que se inicie Linkly AI.
  • La primera indexación es más lenta que en un disco local, y se nota más cuantos más archivos haya; depende de la velocidad de la red y de lectura del NAS.
  • Las carpetas de papelera y miniaturas de Synology y QNAP (#recycle, @eaDir, etc.) se omiten automáticamente y no se indexan.

​
No encuentro lo que se dice dentro de un audio o un vídeo

Porque la transcripción de audio y la de vídeo vienen desactivadas por defecto. Estando apagadas, los archivos multimedia entran igualmente en el índice (por eso se encuentran por su nombre), pero lo que se dice dentro no se transcribe. En el bloque «Gestión» de la página Gestión del índice, activa «Transcripción de audio» y «Transcripción de vídeo»: la aplicación descargará el modelo de reconocimiento de voz y después completará sola todos los archivos multimedia que ya tenías, sin necesidad de volver a escanear ni de reconstruir el índice.

Ajustes de indexación

Esta página explica para qué sirve cada interruptor de la página Gestión del índice, qué valor trae por defecto y cuál es la ruta completa de diagnóstico cuando la indexación da problemas.

​
¿Cómo hago que la conversación se centre en un solo documento?

Hay dos formas de indicar el documento:
  • Empezar desde el documento: en «Biblioteca», selecciona el archivo y pulsa «Chatear con este archivo» en la barra de herramientas que hay encima, o haz clic derecho sobre el archivo y elige esa opción. También está en el menú contextual de los resultados de «Buscar». Así se crea una conversación nueva con el archivo ya puesto en el cuadro de texto. Con carpetas y bibliotecas funciona igual («Chatear con esta carpeta», «Chatear con esta biblioteca»).
  • Usar @ en el cuadro de texto: en el cuadro de texto de «Preguntar», escribe @ seguido de una palabra del nombre del archivo y elígelo entre las sugerencias.
Ten en cuenta que la indicación solo vale para el mensaje actual. Al enviarlo, el cuadro de texto se vacía; si en la siguiente pregunta no vuelves a mencionar el archivo con @, la IA buscará en toda la biblioteca y puede citar otros documentos. Además, indicar un archivo es solo una sugerencia para la IA, no un límite estricto del alcance: la IA todavía puede buscar en otro material. Para que toda la conversación gire en torno a ese único documento:
  1. Vuelve a mencionar el archivo con @ en cada pregunta
  2. Escribe en la pregunta «responde solo a partir de este documento y, si no aparece en él, dilo»
El archivo mencionado con @ tiene que estar ya indexado. La conversación no admite adjuntos: los archivos de los que quieras hablar tienen que estar antes en la biblioteca.

​
¿Cuántos archivos caben en una biblioteca en la nube? ¿Se cuenta por tamaño?

Se cuenta por número de archivos, no por tamaño, y no hay límite de capacidad total: Lo que se envía a la nube no son los archivos originales, sino el texto que Linkly AI extrae de ellos (en el audio y el vídeo, la transcripción), junto con los esquemas y los datos de índice para la búsqueda. Por eso un PDF de cientos de MB y un archivo de texto de pocos KB cuentan igual: un archivo. Al llegar al límite:
  • Si un envío haría que la biblioteca superase el límite de archivos, ese envío no se ejecuta en absoluto y la aplicación avisa con «Límite de archivos de la biblioteca alcanzado»
  • Los envíos que solo modifican o eliminan archivos existentes no se ven afectados
  • Los archivos ya subidos se conservan y no se bloquean
Además, si el texto extraído de un documento supera los 10 MB, la nube no crea índice de búsqueda para él. La explicación completa de las cuotas está en Bibliotecas en la nube.

​
¿Puedo usar las funciones de IA en un equipo sin internet (sin conexión / intranet)?

Sí. El OCR, la transcripción de voz y la búsqueda semántica se ejecutan localmente (las funciones en la nube, como el chat de IA y la instalación de Skills, son la excepción); lo único es que los modelos que usan se descargan normalmente de internet:
  • Los modelos de búsqueda semántica y de OCR, unos 890 MB, se descargan en el primer arranque
  • El modelo de transcripción de voz, unos 161 MB, solo se descarga al activar la transcripción de audio y vídeo
En un equipo sin acceso a internet, descarga antes el instalador y el paquete oficial de modelos sin conexión en un equipo conectado, cópialos al otro e instala paso a paso.

Guía de instalación sin conexión

Qué descargar primero, qué archivos copiar y cómo instalar: el flujo completo en una página.

​
¿Qué hago si la AppImage de Linux no arranca?

Las distribuciones Linux varían mucho en sus bibliotecas básicas, componentes de escritorio y controladores. Una AppImage incluye la mayoría de las dependencias de la aplicación, pero no sustituye glibc, el runtime de C++, FUSE ni los controladores gráficos del sistema operativo, por lo que no puede garantizar que funcione directamente en todas las distribuciones Linux. Linkly AI ofrece AppImage para Linux x86_64 y arm64 (aarch64); ambas requieren glibc 2.35 o superior. Empieza ejecutando estos comandos desde el directorio que contiene la AppImage:
uname -m muestra x86_64 o aarch64; descarga la AppImage correspondiente. El último comando inicia la aplicación y guarda a la vez los errores de la terminal.
La AppImage no tiene permiso de ejecución. Ejecuta:
No inicies Linkly AI con sudo: podría crear archivos de configuración y datos a los que tu usuario normal no pueda acceder después.
Las AppImage normalmente se montan mediante FUSE. Instala la biblioteca de compatibilidad FUSE 2 únicamente desde el repositorio oficial de tu distribución:Si FUSE no está disponible en tu entorno, puedes extraer y ejecutar temporalmente la AppImage:
Este método es más lento y solo evita FUSE; no corrige incompatibilidades de GLIBC, arquitectura de CPU o controladores. Consulta la guía oficial de AppImage para problemas con FUSE.
El runtime básico del sistema operativo es demasiado antiguo y el fallo ocurre antes de que Linkly AI llegue a iniciarse:
  • GLIBC_x.y procede de glibc; el requisito mínimo actual es glibc 2.35.
  • GLIBCXX_x.y y CXXABI_x.y proceden del runtime de C++ del sistema, libstdc++.
Instala primero todas las actualizaciones oficiales que ofrezca tu distribución y reinicia. Si el error continúa, actualiza a una versión más reciente admitida oficialmente por esa distribución. Instalar FUSE o volver a descargar la AppImage no cambiará el resultado.
No sustituyas manualmente /lib/.../libc.so.6, no copies glibc o libstdc++ de otra distribución, no mezcles repositorios de distribuciones diferentes ni fuerces un runtime del sistema descargado mediante LD_LIBRARY_PATH. Estas soluciones pueden dañar el escritorio, el gestor de paquetes o todo el sistema operativo.
El paquete no coincide con la arquitectura de tu CPU. Las AppImage de Linux se publican para x86_64 (Linkly AI_<versión>_amd64.AppImage) y arm64 (Linkly AI_<versión>_aarch64.AppImage); descarga la que coincida con uname -m (x86_64 → amd64, aarch64 → aarch64). Cambiar permisos o instalar bibliotecas no corrige una incompatibilidad de arquitectura.
Suele deberse a la combinación de Wayland / X11, Mesa o controladores gráficos propietarios, portals del escritorio y WebKitGTK. Instala primero las actualizaciones oficiales del sistema y de los controladores gráficos que ofrezca tu distribución. Después, vuelve a iniciar desde una terminal y conserva la salida:
Evita copiar de internet variables desconocidas de WebKit, GTK o gráficos en la configuración permanente: un mismo ajuste puede comportarse de forma diferente según las versiones de WebKitGTK y los controladores. Si sigue sin arrancar, envíanos estos datos de diagnóstico junto con linkly-ai-linux-startup.log:
Actualizar una AppImage requiere sustituir el archivo AppImage actual. Guárdalo en un directorio donde tu usuario pueda escribir, como ~/Applications, y no en un volumen de solo lectura ni en un directorio del sistema propiedad de root:
La documentación puede resolver permisos de ejecución o la falta de FUSE, pero no puede cambiar la versión de GLIBC ni la arquitectura de CPU que exige el binario. Si la aplicación no llega a crear app.log, usa la salida de la terminal guardada en linkly-ai-linux-startup.log.

​
¿Hay una versión para servidores Linux o para Docker?

Todavía no, pero ya la estamos preparando. Si tienes ideas o necesidades al respecto, o quieres probarla antes que nadie, ponte en contacto con nosotros.

Contacto

Déjanos un mensaje en GitHub Issues o encuéntranos por cualquiera de los canales de la página de comunidad.
Mientras tanto, puedes instalar Linkly AI CLI en el servidor o en el contenedor y acceder por red local o en remoto a la aplicación de escritorio de Linkly AI de otro ordenador; cómo hacerlo se explica en la sección siguiente.

​
¿Cómo accedo con la CLI a Linkly AI en otro ordenador?

Por defecto, Linkly AI CLI solo se conecta al Linkly AI de este equipo. Para acceder a otro ordenador hay dos vías, por red local o en remoto, y las dos requieren CLI 1.0.0 o posterior (consulta la versión con linkly --version y actualiza con linkly self-update).
Para cuando los dos ordenadores están en la misma red.
1

Activa el acceso por LAN en el ordenador al que quieres acceder

Haz clic en el icono de agente en la parte inferior de la barra lateral izquierda de la ventana principal para abrir la página «Uso por agentes». En la sección «Gestión», activa «Permitir acceso por LAN»; «Permitir acceso local» también debe seguir activado. La primera vez se genera un token automáticamente.
2

Copia la dirección y el token

En la sección «Integración» de esa misma página, pulsa «Ver la configuración de conexión MCP» y copia del apartado «LAN» la dirección (del tipo http://192.168.1.10:60606/mcp) y el token.
3

Guarda la conexión en el ordenador donde está la CLI

Ejecútalo tú mismo, en tu propia terminal, sin encargárselo a un asistente de IA:
Basta con guardarla una vez: aunque cambies de terminal o de sesión de agente, no tendrás que volver a introducir el token.
4

Añade --lan al usarla

Usa linkly doctor --lan para comprobar que la conexión funciona.
Ten en cuenta que:
  • La CLI solo puede guardar una conexión de red local; volver a ejecutar set-key --lan sobrescribe la anterior. Para acceder puntualmente a otro ordenador, añade --endpoint <dirección> --token <token> al comando; de esta forma no se guarda nada.
  • Las conexiones guardadas están en ~/.linkly/credentials.json.
  • Conviene activar el acceso por LAN solo en redes de confianza, como la de casa o la de la oficina. No pegues el token en ninguna conversación con una IA: el contenido de las conversaciones se envía al proveedor del modelo y queda guardado en el historial. Si el token se filtra o aparece en una conversación, regenéralo en «Ver la configuración de conexión MCP» y el anterior dejará de valer al instante.
  • Los agentes que usan la CLI a través de Skills (como Claude Code) también aprovechan automáticamente la conexión guardada; requiere CLI 1.0.0 y Skills 0.9.0 o posteriores.

​
¿Dónde está cada ajuste?

Para abrir los ajustes: haz clic en el icono de cuenta de la esquina inferior izquierda de la ventana principal y elige «Ajustes» en el menú, o pulsa ⌘ + , (en Windows/Linux, Ctrl + ,). Los ajustes están divididos en páginas por función. Estas son las más usadas:
  • Idioma: el idioma de la interfaz
  • Iniciar al iniciar sesión: arranca Linkly AI al entrar en el sistema
  • Inicio silencioso: al arrancar con el sistema se queda solo en segundo plano, sin abrir la ventana principal; viene activado, de modo que la indexación y el servicio MCP funcionan sin molestarte
  • Espacio de Linkly AI: la carpeta que se indexa por defecto; se puede abrir o cambiar de sitio, ver Espacio de Linkly AI
  • Datos de la aplicación: donde viven el índice, los modelos locales, los ajustes y los registros; el botón Abrir lleva directamente ahí (de ahí se sacan los registros); también se puede mover a otro disco, y la aplicación se reiniciará y migrará los datos; ver ¿Cómo migro los datos de la aplicación a otro disco?
  • Tema: claro / oscuro / seguir al sistema
  • Tamaño del texto: pequeño / estándar / grande, aplicado a la vez a la interfaz y al chat
  • Mostrar icono en el Dock (macOS): al desactivarlo, la aplicación se queda solo en la bandeja de la barra de menús y no ocupa sitio en el Dock
  • Buscar actualizaciones: comprueba y descarga a mano la nueva versión; cuando termine, pulsa Reiniciar para actualizar
  • Unirse al programa beta: al activarlo recibirás las versiones de desarrollo (beta), con acceso anticipado a las novedades pero también a cambios que aún no están del todo probados
  • Desde aquí también se salta al registro de cambios, la política de privacidad, los términos del servicio y la documentación de la CLI y de Skills
  • Atajos globales: «Buscar» muestra u oculta el lanzador y «Ventana principal» abre la ventana principal. Basta pulsarlos para volver a grabarlos, y también se pueden Restablecer o Borrar. Si avisa de que la combinación ya está ocupada o reservada por el sistema, elige otra
  • Lista de atajos: todos los atajos de la aplicación. Desde el lanzador se abre directamente esta página pulsando ⌘ + / (en Windows/Linux, Ctrl + /)
Pausar indexación no está en los ajustes. Pulsa «Pausar» en la primera tarjeta del bloque «Estado» de la página Gestión del índice de la ventana principal, o haz clic derecho sobre el icono L de la bandeja y elige «Pausar indexación». Más detalles en Ajustes de indexación.

​
¿Se puede cambiar la ubicación del Espacio de Linkly AI?

Sí. El Espacio de Linkly AI es la carpeta predeterminada donde se guardan las notas, los recortes y demás material. Para cambiarla:
  1. Ve a Ajustes → General y busca la fila «Espacio de Linkly AI»
  2. Pulsa el botón de icono «Cambiar» de la derecha y, en el cuadro de confirmación, pulsa «Continuar»
  3. Elige una carpeta: Linkly AI creará dentro una carpeta LinklyAI como nuevo espacio. Si la carpeta elegida ya se llama LinklyAI, la usa tal cual
El cambio no mueve los archivos existentes: los de la ubicación anterior se quedan donde están y se siguen indexando; las notas y los recortes que crees a partir de ahora se guardan en la nueva ubicación. Si quieres llevar también los archivos antiguos, tendrás que moverlos tú. Para volver a la ubicación original, pulsa «Restaurar predeterminada», justo al lado.
Si al cambiarla aparece «La carpeta actual es una carpeta del sistema. Elige otra carpeta para la migración.», es que estás cambiando la fila de abajo, «Datos de la aplicación», y no el Espacio de Linkly AI. Los datos de la aplicación no se pueden poner en carpetas del sistema como Windows; elige una carpeta normal. Más detalles en la sección siguiente.

​
¿Cómo migro los datos de la aplicación a otro disco?

Los datos de la aplicación son la carpeta donde Linkly AI guarda la base de datos, el índice, los modelos locales, los ajustes y los registros; con mucho material pueden ocupar varios GB. Por defecto están en el disco del sistema y no tienen nada que ver con la carpeta de instalación del programa: aunque instalaras la aplicación en el disco D, los datos de la aplicación siguen en la ubicación predeterminada de abajo. Si te falta espacio en el disco del sistema, puedes migrar toda la carpeta de datos de la aplicación a otro disco desde los ajustes. El Espacio de Linkly AI es un ajuste aparte y no se migra junto con los datos de la aplicación.

​
Pasos de la migración

1

Abre el ajuste «Datos de la aplicación»

Ve a Ajustes → General y busca la fila «Datos de la aplicación».
2

Elige la nueva ubicación

Pulsa el botón «Cambiar» de la derecha (icono de carpeta con lápiz), pulsa «Cambiar y reiniciar» en el cuadro de confirmación y elige una carpeta. Linkly AI creará dentro LinklyAI\ai.linkly.desktop para guardar los datos. Por ejemplo, si eliges D:\Linkly AI Data, los datos quedarán en D:\Linkly AI Data\LinklyAI\ai.linkly.desktop.
3

Espera a que termine la migración

Tras reiniciarse, la aplicación muestra una ventana de progreso: copia los datos, verifica la copia y cambia a la nueva ubicación; al terminar se reinicia sola. Con mucho material puede tardar varios minutos; mientras tanto, mantén la ventana abierta y no apagues el equipo.
4

Comprueba el resultado

Vuelve a Ajustes → General → Datos de la aplicación: debe mostrar la nueva ruta, y el tamaño que aparece al lado es lo que ocupan realmente los datos.
La nueva ubicación tiene que cumplir estas condiciones; si no, se indica el motivo:
  • Tiene que ser una carpeta, no la raíz de una unidad (como D:\)
  • No puede ser una carpeta del sistema (como la carpeta Windows), ni una unidad de red o carpeta compartida; las carpetas dentro de Program Files sí se pueden elegir
  • No puede solaparse con el Espacio de Linkly AI ni con ninguna carpeta vigilada, ni estar dentro de la carpeta actual de datos de la aplicación
  • El espacio libre tiene que ser al menos 1,1 veces el tamaño actual de los datos de la aplicación
  • Dentro de esa carpeta no puede existir ya un LinklyAI\ai.linkly.desktop que no esté vacío
  • No se puede migrar mientras se descarga un modelo; espera a que termine y vuelve a intentarlo

​
Después de migrar, ¿por qué sigue habiendo una carpeta en la ubicación original?

Al terminar la migración, los datos de la ubicación original se eliminan y en su lugar queda un enlace con el mismo nombre que apunta a la nueva ubicación (en Windows es una unión de directorio; en macOS y Linux, un enlace simbólico). Linkly AI encuentra los datos de la nueva ubicación a través de ese enlace cada vez que arranca, así que hay que conservarlo.
  • El enlace no ocupa espacio. Si miras sus «Propiedades» en el Explorador de archivos, verás el mismo tamaño que en la nueva ubicación, porque el sistema también cuenta los datos a los que apunta el enlace. Para confirmar que se ha liberado espacio, mira el espacio libre del disco del sistema en «Este equipo»: tras la migración debería haber aumentado en lo que ocupaban los datos de la aplicación.
  • El enlace y la nueva ubicación parecen idénticos: el contenido, el tamaño y la fecha de modificación cambian a la vez. Es porque al abrir el enlace ves directamente los datos de la nueva ubicación; no son dos copias que se sincronizan.
  • En Windows, %LOCALAPPDATA%\ai.linkly.desktop contiene la caché de la interfaz de la aplicación; no entra en la migración y, si la borras, se vuelve a crear sola.
No borres el enlace de la ubicación original, ni lo abras para borrar archivos de dentro. Si borras archivos de dentro, estás borrando los datos reales de la nueva ubicación. Si borras el enlace en sí, Linkly AI tratará el siguiente arranque como una instalación nueva: volverá a descargar los modelos e indexará desde cero, y los datos de la nueva ubicación dejarán de usarse.
Si todavía no has vuelto a abrir Linkly AI desde que lo borraste, basta con recrear el enlace con el comando siguiente (sustituye la ruta por tu nueva ubicación):
  • Windows (Símbolo del sistema):
  • macOS (Terminal):
  • Linux (terminal):
Si ya lo has abierto después de borrarlo, en la ubicación original aparecerá una carpeta de datos nueva y vacía. Deja de usar la aplicación y contacta con nosotros para que te ayudemos a recuperarlo.
  • Volver a la ubicación predeterminada: en la fila «Datos de la aplicación», pulsa «Restaurar predeterminada» (icono de flecha circular). Linkly AI se reiniciará y copiará los datos de vuelta a la ubicación predeterminada, así que el disco del sistema necesita espacio libre suficiente; la ubicación personalizada solo se limpia cuando termina la copia.
  • Pasar a otro disco: vuelve a pulsar «Cambiar» y elige la nueva ubicación siguiendo los pasos de arriba.
No. Hasta que la copia de la nueva ubicación se verifica y la aplicación arranca bien desde ella, los datos originales se conservan intactos. Si la migración se interrumpe (por ejemplo, por un corte de luz o un cierre forzado), en el siguiente arranque aparece una ventana de recuperación donde puedes pulsar «Reintentar» para continuar o «Cancelar el cambio y conservar la ubicación anterior». Si te encuentras con algo que no puedes resolver, pulsa «Abrir registro» y envíanos el registro.
Sí, pero tendrás que conectar ese disco cada vez que vayas a usar Linkly AI. Si no está conectado, al arrancar aparecerá «No se puede acceder a la carpeta de datos de la aplicación»; conéctalo y pulsa «Reintentar». No es recomendable poner los datos de la aplicación en un disco extraíble que se conecta y desconecta a menudo.
En Windows, si al desinstalar marcas la opción de eliminar los datos de la aplicación, los datos migrados a la nueva ubicación también se eliminan. Si solo quieres desinstalar y volver a instalar conservando los datos, no la marques: tras reinstalar, Linkly AI encontrará los datos de siempre a través del enlace.

​
¿Cómo obtengo los registros de ejecución de Linkly AI?

Mientras se ejecuta, la app escribe automáticamente sus registros completos en un archivo local app.log (máx. 10 MB por archivo, con rotación). Adjuntar este archivo al reportar un problema acelera mucho el diagnóstico. Los datos sensibles ya están enmascarados. Hay dos formas de obtener el registro:

​
Opción 1: Abrir desde la aplicación (recomendado)

Es la forma más sencilla:
1

Abrir la página «General»

En Linkly AI, ve a Ajustes → General.
2

Abrir el directorio de datos de la aplicación

Localiza la fila «Datos de la aplicación» y haz clic en el botón «Abrir» de la derecha. El gestor de archivos se abrirá en la carpeta de datos de la aplicación.
3

Sacar app.log del subdirectorio logs

Entra en el subdirectorio logs/ y envíanos app.log.

​
Opción 2: Abrir manualmente el directorio de datos de la aplicación

Si la app ha fallado o no arranca, abre la carpeta directamente desde el disco:
  1. Abre Finder.
  2. En la barra de menús, elige Ir → Ir a la carpeta… (o pulsa ⌘ + ⇧ + G).
  3. Pega esta ruta y pulsa Intro:
  4. Encuentra app.log en la carpeta y envíanoslo.

​
¿Qué hacer si la app falla al iniciar?

Si la app se cierra de inmediato al iniciar, app.log puede no haber tenido tiempo de escribirse. En ese caso la información del fallo se guarda aparte, en un archivo startup-panic-<número>.json dentro de la carpeta de diagnóstico linkly-ai-diagnostics. La próxima vez que abras Linkly AI, aparecerá el aviso «Linkly AI no se cerró correctamente», y esa información del fallo se incluirá en el informe de diagnóstico. Escribe una frase sobre lo que estabas haciendo antes del fallo y pulsa «Enviar informe». Si la aplicación falla en cada arranque y no llegas a ver ese aviso, puedes buscar el archivo a mano en la ruta de abajo:
  1. Abre Finder.
  2. En el menú superior elige Ir → Ir a la carpeta… (o pulsa ⌘ + ⇧ + G).
  3. Pega la ruta de abajo y presiona Enter:
  4. Encuentra en la carpeta el archivo .json que empieza por startup-panic- y envíanoslo.
Este archivo solo se crea cuando ocurre un fallo durante el inicio, y se limpia solo en el siguiente arranque normal, una vez incluido en el informe de diagnóstico. Si este archivo tampoco existe, manda una captura de la ventana o diálogo del fallo junto con la versión de tu sistema.

Dónde enviarlo

Abre un issue en GitHub o contáctanos por cualquier canal de la página de comunidad.