Documentation · BoltLynx

Démarrage rapide

Configurez la machine ou l’environnement isolé dans lequel les agents doivent agir. Un client local peut servir plusieurs agents.

Installez le client local.
Démarrez le client local et confirmez la page d’association dans votre navigateur.
Ouvrez l’application web et créez ou sélectionnez un agent.
Choisissez le dossier de projet que l’agent peut utiliser.

Client local pour Windows

Téléchargez le lanceur Windows :

Télécharger le lanceur Windows

Créez un dossier permanent que vous conserverez, par exemple C:\BoltLynx, puis extrayez-y tous les fichiers du ZIP. Cette version est portable ; aucun programme d’installation n’est nécessaire.

N’exécutez pas boltlynx-desktop.exe directement depuis la fenêtre de l’archive ZIP. Windows pourrait le lancer depuis un dossier temporaire, ce qui rendrait ensuite le lanceur et ses fichiers locaux difficiles à retrouver.

Depuis le dossier extrait, double-cliquez sur boltlynx-desktop.exe. Le lanceur Windows gère le client local ; ce n’est pas l’interface où vous parlez aux agents. Utilisez-le pour démarrer ou arrêter le client et pour ouvrir ou copier la page d’association.

Windows peut afficher un avertissement Microsoft Defender SmartScreen, car cette première version n’est pas encore signée. Si vous l’avez téléchargée depuis le bouton officiel, cliquez sur More info, puis Run anyway.

Si l’antivirus signale le lanceur Windows

Le client local peut effectuer les actions système, les commandes et les opérations sur les fichiers que vous autorisez. Une version non signée peut donc déclencher une détection heuristique de l’antivirus, telle que Trojan:Win32/Sprisky.U!cl. N’autorisez pas automatiquement une détection.

Vérifiez d’abord que le ZIP provient du bouton de téléchargement officiel ci-dessus et que le fichier détecté est C:\BoltLynx\boltlynx-desktop.exe. Si la source, le nom ou le fichier détecté ne correspond pas, supprimez-le et téléchargez une nouvelle copie depuis le bouton officiel.
Si ces éléments correspondent, ouvrez Sécurité Windows → Protection contre les virus et menaces → Historique de protection, ouvrez la détection et choisissez Autoriser sur l’appareil. Si le fichier a été mis en quarantaine, choisissez Restaurer. Les libellés peuvent varier légèrement selon la version de Windows.
Si Defender remet régulièrement le fichier confirmé en quarantaine, ouvrez Paramètres de Protection contre les virus et menaces → Gérer les paramètres → Exclusions → Ajouter ou supprimer des exclusions, choisissez Dossier et ajoutez uniquement C:\BoltLynx.

Ne désactivez pas la protection en temps réel et n’excluez pas Téléchargements, tout votre dossier utilisateur ou un disque entier.

Instructions Microsoft : Historique de protection et exclusions de dossiers.

Après l’association, laissez le client local fonctionner en arrière-plan. Ouvrez l’application web pour parler aux agents et choisir le dossier de projet qu’ils peuvent utiliser.

Lorsqu’une mise à jour est disponible, le lanceur Windows peut télécharger le nouveau client local. Comme il est portable, ses fichiers locaux restent dans le dossier depuis lequel vous exécutez le programme.

Ligne de commande Linux

Installez le client local :

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

Le programme d’installation place le binaire boltlynx dans ~/.boltlynx/bin/ et l’ajoute au PATH. Redémarrez le terminal, puis démarrez le client local. Au premier lancement, la commande affiche un lien vers la page d’association ; ouvrez-le dans le navigateur et confirmez. Le client local continue ensuite de fonctionner en arrière-plan. Aucune autre commande d’association n’est nécessaire.

boltlynx start

Consultez l’état du client à tout moment :

boltlynx status

Ligne de commande macOS

Installez le client local :

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

boltlynx start

Consultez l’état du client à tout moment :

boltlynx status

Une fois le client local démarré et associé, ouvrez l’application web, créez ou sélectionnez un agent, puis choisissez le dossier de projet qu’il peut utiliser.

Ouvrir l’application web

Mettre à jour le client local

Après une mise à jour :

Windows : mettez à jour le client local depuis le lanceur, puis redémarrez le noyau du client.
Linux / macOS : redémarrez le client local depuis le terminal.

Redémarrer le client local

boltlynx restart

Concepts clés

Application web

Échangez avec les agents, créez et gérez le travail, puis décidez de la suite. L’application web fonctionne dans votre navigateur.

Client local

Le client s’exécute sur votre machine. Il donne aux agents autorisés accès aux fichiers locaux, aux commandes, à l’analyse de données, à la recherche de code et aux compétences privées.

Un client n’est pas un seul agent. C’est un environnement d’exécution isolé : une machine, un conteneur ou un autre utilisateur du système. Installez le client une fois dans cet environnement ; il peut héberger plusieurs agents.

Agent

Un agent associe une conversation et un environnement de travail. Il possède un historique, un répertoire de travail, une mémoire, des compétences activées et ses propres instructions.

Compétences

Les compétences donnent des capacités métier à un agent. Ce guide couvre Code pour le développement logiciel et Ops pour les opérations et les règles de sécurité des bases de données.

Agents spécialisés

Un agent principal peut déléguer du travail à des agents spécialisés spécialisés. Chacun peut avoir son propre modèle, répertoire de travail, ses compétences et son rôle.

Configuration de l’agent

Chaque agent peut être configuré pour un projet ou une charge de travail précis.

Nom, description et répertoire de travail	Identifiez l’agent et définissez le dossier racine dans lequel il peut agir.
Compétences	Activez des capacités métier comme Code ou Ops.
Modèle	Choisissez le modèle et le niveau de raisonnement.
Permissions des fichiers	Définissez les chemins autorisés, modifiables ou bloqués.
Permissions des commandes	Autorisez ou bloquez des motifs de commandes, par exemple `git *`, tout en bloquant les commandes destructrices.
Instructions et mémoire	Donnez à l’agent des règles de travail durables et des notes modifiables qu’il peut conserver entre les conversations.
Agents spécialisés	Configurez des collaborateurs spécialisés pour les travaux plus importants.
Déclencheurs et notifications	Lancez des contrôles planifiés, des workflows déclenchés par webhook ou des notifications de fin et d’alerte.

Utilisation quotidienne

Ouvrez l’application web. Sélectionnez l’agent du projet, puis reprenez la conversation ou confiez-lui le travail suivant.
Décrivez le travail. Donnez-lui une tâche réelle, pas seulement un prompt.
Laissez-le agir. L’agent peut lire et écrire des fichiers, exécuter des commandes, rechercher du code et analyser des données dans l’environnement autorisé.
Approuvez les actions sensibles. Les opérations qui nécessitent une confirmation demandent d’abord une validation humaine.
Recevez des notifications. BoltLynx peut vous prévenir lorsque le travail se termine, qu’une anomalie apparaît ou qu’une tâche planifiée rend son rapport.

Modèle de sécurité

BoltLynx repose sur des limites explicites. L’agent travaille dans les répertoires et avec les permissions de commandes que vous configurez.

L’accès aux fichiers est contrôlé par le répertoire de travail et des règles d’autorisation ou de blocage supplémentaires.
Les commandes sensibles peuvent nécessiter une approbation humaine.
Les compétences privées s’exécutent via votre client local au lieu d’être téléversées comme outils côté serveur.
Les notifications peuvent signaler les fins de travaux, les échecs et les rapports planifiés.

Limites des données

BoltLynx est conçu pour réduire au minimum l’accès local et le transfert de données. Il ne réplique pas votre espace de travail et n’analyse ni ne téléverse de fichiers sans rapport avec le travail.

Le contenu du travail ne quitte le client que lorsque cela est nécessaire au raisonnement du modèle, aux résultats d’action requis, à un service en ligne que vous choisissez ou aux diagnostics opérationnels nécessaires au fonctionnement et à la sécurité du Service.

Installez le client local. Commencez à travailler.