Documentación · BoltLynx

Inicio rápido

Configura el equipo o entorno aislado en el que quieres que actúen los agentes. Un cliente local puede servir a varios agentes.

Instala el cliente local.
Inicia el cliente local y confirma la página de emparejamiento en el navegador.
Abre la aplicación web y crea o selecciona un agente.
Elige la carpeta del proyecto que el agente puede utilizar.

Cliente local para Windows

Descarga el iniciador de Windows:

Descargar el iniciador de Windows

Crea una carpeta permanente que vayas a conservar, por ejemplo C:\BoltLynx, y extrae allí todos los archivos del ZIP. Esta versión es portátil; no necesita instalador.

No ejecutes boltlynx-desktop.exe directamente desde la ventana del archivo ZIP. Windows podría iniciarlo desde una carpeta temporal, por lo que después sería difícil encontrar el iniciador y sus archivos locales.

Desde la carpeta extraída, haz doble clic en boltlynx-desktop.exe. El iniciador de Windows gestiona el cliente local; no es donde hablas con los agentes. Úsalo para iniciar o detener el cliente y para abrir o copiar la página de emparejamiento.

Windows puede mostrar un aviso de Microsoft Defender SmartScreen porque esta primera versión aún no está firmada. Si la descargaste desde el botón oficial, haz clic en More info y después en Run anyway.

Si el antivirus marca el iniciador de Windows

El cliente local puede realizar las acciones de sistema, comandos y archivos que autorices. Por ello, las versiones sin firmar pueden activar detecciones heurísticas del antivirus, como Trojan:Win32/Sprisky.U!cl. No permitas una detección automáticamente.

Primero confirma que el ZIP procede del botón de descarga oficial de arriba y que el archivo detectado es C:\BoltLynx\boltlynx-desktop.exe. Si el origen, el nombre o el archivo detectado no coinciden, elimínalo y descarga una copia nueva desde el botón oficial.
Si coinciden, abre Seguridad de Windows → Protección contra virus y amenazas → Historial de protección, abre la detección y elige Permitir en el dispositivo. Si el archivo fue puesto en cuarentena, elige Restaurar. Los nombres pueden variar ligeramente según la versión de Windows.
Si Defender vuelve a poner en cuarentena el archivo confirmado, abre Configuración de Protección contra virus y amenazas → Administrar la configuración → Exclusiones → Agregar o quitar exclusiones, elige Carpeta y agrega únicamente C:\BoltLynx.

No desactives la protección en tiempo real ni excluyas Descargas, toda tu carpeta de usuario o una unidad completa.

Instrucciones de Microsoft: Historial de protección y exclusiones de carpetas.

Tras el emparejamiento, deja el cliente local ejecutándose en segundo plano. Abre la aplicación web para hablar con los agentes y elegir la carpeta del proyecto que pueden utilizar.

Cuando haya una actualización, el iniciador de Windows podrá descargar el nuevo cliente local. Como es portátil, sus archivos locales permanecen en la carpeta desde la que ejecutas el programa.

Línea de comandos de Linux

Instala el cliente local:

curl -fsSL https://boltlynx.com/install.sh | bash

El instalador coloca el binario boltlynx en ~/.boltlynx/bin/ y lo añade a tu PATH. Reinicia el terminal y arranca el cliente local. En el primer inicio, el comando muestra un enlace a la página de emparejamiento; ábrelo en el navegador y confirma. Después, el cliente local sigue ejecutándose en segundo plano. No hace falta otro comando de emparejamiento.

boltlynx start

Consulta el estado del cliente en cualquier momento:

boltlynx status

Línea de comandos de macOS

Instala el cliente local:

curl -fsSL https://boltlynx.com/install.sh | bash

boltlynx start

Consulta el estado del cliente en cualquier momento:

boltlynx status

Cuando el cliente local esté en marcha y emparejado, abre la aplicación web, crea o selecciona un agente y elige la carpeta del proyecto que puede utilizar.

Abrir la aplicación web

Actualizar el cliente local

Después de una actualización:

Windows: actualiza el cliente local desde el iniciador y reinicia el núcleo del cliente.
Linux / macOS: reinicia el cliente local desde el terminal.

Reiniciar el cliente local

boltlynx restart

Conceptos básicos

Aplicación web

Habla con los agentes, crea y gestiona el trabajo y decide qué debe ocurrir después. La aplicación web funciona en el navegador.

Cliente local

El cliente se ejecuta en tu equipo. Da a los agentes aprobados acceso a archivos locales, comandos, análisis de datos, búsqueda de código y capacidades privadas.

Un cliente no es un único agente. Es un entorno de ejecución aislado: una máquina, un contenedor o un usuario distinto del sistema operativo. Instala el cliente una vez en ese entorno; puede alojar varios agentes.

Agente

Un agente combina una conversación y un entorno de trabajo. Tiene historial de conversación, directorio de trabajo, memoria, capacidades activadas e instrucciones propias.

Capacidades

Las capacidades dan capacidades de dominio a un agente. Esta guía cubre Code para desarrollo de software y Ops para operaciones y reglas de seguridad de bases de datos.

Agentes especializados

Un agente principal puede delegar trabajo en agentes especializados. Cada uno puede tener su propio modelo, directorio de trabajo, capacidades y función.

Configuración del agente

Cada agente puede configurarse para un proyecto o carga de trabajo específicos.

Nombre, descripción y directorio de trabajo	Identifica el agente y define la carpeta raíz en la que puede operar.
Capacidades	Activa capacidades de dominio como Code u Ops.
Modelo	Elige el modelo y el nivel de razonamiento para el trabajo.
Permisos de archivos	Define rutas permitidas, editables o bloqueadas.
Permisos de comandos	Permite o bloquea patrones de comandos, por ejemplo `git *`, y bloquea comandos destructivos.
Instrucciones y memoria	Da al agente reglas de trabajo a largo plazo y notas editables que pueda mantener entre conversaciones.
Agentes especializados	Configura colaboradores especializados para trabajos más grandes.
Triggers y notificaciones	Ejecuta comprobaciones programadas, flujos activados por webhook o notificaciones de finalización y alerta.

Uso diario

Abre la aplicación web. Selecciona el agente del proyecto y continúa la conversación o indícale el siguiente trabajo.
Describe el trabajo. Dale una tarea real, no solo un prompt.
Deja que actúe. El agente puede leer y escribir archivos, ejecutar comandos, buscar código y analizar datos dentro del entorno aprobado.
Aprueba acciones sensibles. Las operaciones que necesitan confirmación piden primero la aprobación humana.
Recibe notificaciones. BoltLynx puede avisarte cuando el trabajo termina, aparece una anomalía o una tarea programada informa de su resultado.

Modelo de seguridad

BoltLynx está diseñado en torno a límites explícitos. El agente trabaja dentro de los directorios y permisos de comandos que configuras.

El acceso a archivos se controla mediante el directorio de trabajo y reglas adicionales de permiso o bloqueo.
Los comandos sensibles pueden requerir aprobación humana.
Las capacidades privadas se ejecutan mediante tu cliente local, en lugar de cargarse como herramientas del servidor.
Las notificaciones pueden mostrar finalización, fallos e informes programados.

Límites de los datos

BoltLynx está diseñado para minimizar tanto el acceso local como la transferencia de datos. No replica tu espacio de trabajo ni examina y sube archivos no relacionados.

El contenido del trabajo solo sale del cliente cuando es necesario para el razonamiento del modelo, los resultados de acciones requeridos, un servicio en línea que eliges o los diagnósticos operativos necesarios para ejecutar y proteger el Servicio.

Instala el cliente local. Empieza a trabajar.