Saltar al contenido principal

​
Introducción a Linkly AI CLI

Linkly AI CLI es una herramienta de línea de comandos que, conectándose al servicio MCP de Linkly AI Desktop, le permite buscar, explorar y leer documentos locales desde la terminal. También funciona como puente entre AI Agent (como Claude Desktop, Cursor) y Linkly AI.

Búsqueda en terminal

Busque sus documentos directamente desde la línea de comandos, ideal para desarrolladores y usuarios avanzados

Puente MCP

Se ejecuta en modo MCP stdio, permitiendo que herramientas de IA como Claude Desktop y Cursor invoquen Linkly AI

​
Instalación

Ejecute en la terminal:
curl -sSL https://updater.linkly.ai/cli/install.sh | sh
O instale mediante Homebrew:
brew tap LinklyAI/tap
brew install linkly
Después de la instalación, verifique: 
linkly --version
Antes de ejecutar CLI, debe iniciar la aplicación Linkly AI Desktop. CLI descubrirá y se conectará automáticamente al servicio MCP de la aplicación de escritorio a través del archivo ~/.linkly/port.

​
Métodos de uso

CLI sigue el flujo de trabajo progresivo search → outline → read: primero buscar para encontrar el documento objetivo, luego ver el esquema para entender la estructura, y finalmente leer el contenido específico.

​
Verificar el estado de conexión

linkly status
Devuelve el estado de ejecución de Linkly AI Desktop, la versión, el número de documentos indexados y el estado de la indexación.

​
Buscar documentos

linkly search "palabras clave o frase"
Busca en sus documentos locales y devuelve la lista de resultados más relevantes, incluyendo título, ruta, relevancia y resumen del contenido. Parámetros frecuentes: 
# Limitar el número de resultados (predeterminado 20, máximo 50)
linkly search "diseño de API" --limit 5

# Filtrar por tipo de documento
linkly search "acta de reunión" --type pdf,docx

# Salida en formato JSON (adecuado para procesamiento por scripts)
linkly search "informe de presupuesto" --json

​
Ver el esquema del documento

linkly outline <DOC_ID>
Obtiene el esquema estructurado y los metadatos del documento. DOC_ID se obtiene de los resultados de búsqueda. Permite ver múltiples documentos a la vez: 
linkly outline id1 id2 id3
La función de esquema funciona mejor con documentos Markdown y DOCX, cuyos títulos pueden ser analizados estructuralmente. Para texto plano o PDF sin marcadores, se recomienda usar directamente el comando read.

​
Leer el contenido del documento

linkly read <DOC_ID>
Lee el contenido completo del documento con números de línea. Para documentos extensos, puede leer por páginas: 
# Comenzar desde la línea 50, leer 100 líneas
linkly read <DOC_ID> --offset 50 --limit 100
Estrategia de paginación: Por defecto se leen 200 líneas por vez (máximo 500). Para documentos extensos, lea progresivamente ajustando --offset: 
linkly read <DOC_ID> --offset 1 --limit 200    # Líneas 1-200
linkly read <DOC_ID> --offset 201 --limit 200  # Líneas 201-400
linkly read <DOC_ID> --offset 401 --limit 200  # Líneas 401-600

​
Modo MCP

linkly mcp
Se ejecuta en modo servidor MCP stdio, exponiendo las herramientas de Linkly AI a clientes de IA compatibles con MCP. Configurar aplicaciones de IA locales como Claude Desktop: Agregue el siguiente contenido al archivo de configuración de Claude Desktop u otras aplicaciones:
Edite ~/.config/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "linkly-ai": {
      "command": "linkly",
      "args": ["mcp"]
    }
  }
}
Configurar Cursor: En Cursor, abra Settings → MCP Servers → Add Server y agregue:
  • Name: linkly-ai
  • Command: linkly mcp

​
Actualizar CLI

linkly self-update
Verifica y actualiza automáticamente a la última versión. CLI también comprueba actualizaciones en segundo plano con cada inicio y le notificará si hay una nueva versión disponible.

​
Descripción de parámetros

​
Opciones globales

OpciónDescripción
--endpoint <URL>Especificar endpoint MCP (por defecto, se descubre automáticamente desde ~/.linkly/port)
--jsonSalida en formato JSON (adecuado para scripts y automatización)
-V, --versionMostrar la versión de CLI
-h, --helpMostrar información de ayuda
ParámetroDescripciónPredeterminado
<QUERY>Palabras clave o frase (obligatorio)—
--limit <N>Número máximo de resultados20
--type <TYPES>Filtrar por tipo de documento (separado por comas)Todos

​
Parámetros de outline

ParámetroDescripciónPredeterminado
<ID...>ID del documento (obligatorio, admite múltiples)—

​
Parámetros de read

ParámetroDescripciónPredeterminado
<ID>ID del documento (obligatorio)—
--offset <N>Línea de inicio (desde 1)1
--limit <N>Número de líneas a leer (máximo 500)200