Documentation

1. Installer l'application de bureau

Rendez-vous sur la page de téléchargement pour obtenir le client Windows / macOS / Linux et l'installer. Après le lancement, deux entrées permanentes restent en haut : Home (actifs et sessions) et Deck (l'assistant d'exploitation). Les actifs du quotidien vivent dans la barre latérale Home : hôtes, clés, redirection, tâches et paramètres.

• Dans Paramètres, vous pouvez changer le terminal local par défaut (l'assistant et le shell local s'y exécutent) et la langue du système.
• L'application de bureau exige un compte du site. Les comptes Free conservent toutes les fonctions locales de connexion et de gestion ; la synchronisation cloud, la surveillance et l'exécution IA exigent Pro.

2. Connectez-vous — les modèles cloud fonctionnent immédiatement

L'assistant, les suggestions de commandes et l'exploration de surveillance utilisent les modèles cloud par défaut : connectez-vous et c'est parti, sans clés de modèle à configurer.

1. Sur la page de connexion, connectez-vous par e-mail ou Google / GitHub, puis choisissez « Autoriser cette machine » ; l'application de bureau reprend le compte courant.
2. La liste des modèles cloud est livrée avec votre compte et se choisit directement dans le sélecteur de modèle de la barre de saisie Deck.
3. L'usage des modèles cloud est décompté de votre quota d'abonnement : le quota mensuel est utilisé d'abord, puis votre solde ; Free reçoit aussi chaque mois un quota cloud et un nombre de suggestions limités (modèles de base uniquement).
4. Consultez l'état actuel, l'usage du quota mensuel et le solde sous Compte → Abonnement.

Abonnez-vous à Pro pour débloquer la synchronisation cloud, la surveillance, l'exécution IA et le catalogue complet des modèles cloud. L'achat se fait dans l'application de bureau ; les renouvellements sont gérés par l'app store. Voir Tarifs.

3. Enregistrer les appareils et les clés

Sessions, assistant, transfert de fichiers et redirection partagent un même jeu d'actifs. Placez d'abord « à qui se connecter et avec quoi » dans l'inventaire, pour ne plus jamais recomposer les détails de connexion.

Créer une clé (recommandé en premier)

1. Home → Clés → Nouvelle clé.
2. Collez la clé publique et la clé privée ; ajoutez la phrase secrète s'il y en a une ; collez le certificat si vous en avez besoin.
3. Seul le format OpenSSH est pris en charge ; convertissez d'abord les fichiers PPK de PuTTY vers OpenSSH.

Ajouter un appareil

1. Home → Hôtes → Ajouter un appareil (l'état vide invite aussi « Aucun appareil pour le moment, cliquez pour ajouter »).
2. Informations de base : nom, hôte, type et groupe. Le type influe sur les suggestions de commandes et certaines interactions côté appareil, choisissez-le avec soin.
3. Renseignez SSH (port 22 par défaut, nom d'utilisateur, mot de passe ou clé), Telnet (port 23 par défaut) et/ou RDP (domaine, résolution, couche de sécurité, etc.) selon le besoin.
4. SSH a des options supplémentaires pour la réutilisation de session, l'agent SSH et la méthode d'authentification ; Telnet a la détection d'invite et la vérification de l'écho des commandes ; RDP a la profondeur de couleur, la disposition du clavier et la redirection de lecteurs.
5. Enregistrez, ou Enregistrer et connecter tout de suite.

Mots de passe, clés et autres actifs sensibles restent dans les données locales ; vous connecter au site ne les téléverse jamais comme inventaire cloud.

4. Ouvrir une session

Confirmez que la cible est joignable avant de la confier à l'assistant. Cliquez une carte d'hôte et choisissez le protocole à ouvrir.

• SSH / Telnet : ouvre un volet terminal. La première connexion vous demande de confirmer l'empreinte de l'hôte ; une empreinte changée déclenche une alerte et vous pouvez rejeter, faire confiance une fois ou faire confiance de façon permanente.
• SFTP : utilise la même identité que SSH et ouvre la vue fichiers à double volet.
• RDP : entre sur le bureau Windows, avec presse-papiers et lecteurs locaux partagés.
• Shell local : choisissez un terminal dans la barre d'outils des hôtes (Invite de commandes / PowerShell / WSL, etc., selon ce qui est trouvé sur votre machine).
• Après une coupure, utilisez Reconnecter ; le + en haut ouvre un nouvel onglet pour revisiter les connexions récentes.
• Ajustez les paramètres du terminal (police, thème) et rechercher dans le volet sans interrompre la session.

Les onglets peuvent être glissés pour les réordonner ou fusionnés en vues scindées : fusionnez lorsque vous avez besoin de deux appareils côte à côte, ramenez vers la barre d'onglets lorsque vous devez vous concentrer.

5. Transfert de fichiers et tunnels

Fichiers à double volet

Ouvrez SFTP dans une session pour voir le local et le distant côte à côte. Actions courantes : ouvrir, copier vers le répertoire cible, nouveau dossier/fichier, renommer, supprimer, changer les permissions, afficher les fichiers cachés, copier le chemin. En cas de conflit, choisissez ignorer ou écraser comme indiqué ; la progression reste en bas du volet.

Tunnels et redirection

1. Home → Redirection → Nouvelle redirection.
2. Choisissez un type : Local (un port local vers l'environnement cible), Distant (un port distant ramené de ce côté) ou Dynamique (proxy SOCKS5).
3. Renseignez nom, port, adresse de liaison, hôte et adresse cibles, puis utilisez Démarrer la redirection pour l'activer. Les états sont inactif, en cours ou erreur.

Fichiers et redirection ne dépendent pas de l'assistant et peuvent s'utiliser seuls.

6. Utiliser l'assistant d'exploitation (Deck)

Passez à Deck en haut. La gauche contient nouvelle discussion, compétences, serveurs MCP, discussions récentes et références d'appareils ; le centre est la zone de conversation et d'exécution des outils.

Votre première conversation

1. Assurez-vous qu'un modèle est sélectionné dans la barre d'outils ; les modèles cloud sont disponibles dès la connexion.
2. Laissez le mode d'approbation sur Demander l'approbation (par défaut) : vous cliquez Autoriser ou Ignorer pour chaque action.
3. Utilisez le + à gauche de la barre de saisie pour ajouter des appareils, groupes, compétences ou images, ou glissez depuis Références d'appareils. Les références deviennent des puces de contexte pour que l'assistant connaisse le périmètre.
4. Décrivez l'objectif en langage naturel. Commencez par une inspection en lecture seule, par exemple l'état du CPU, du disque et des interfaces clés.
5. Lorsqu'une action attend confirmation, choisissez Autoriser ou Ignorer ; pour des commandes similaires répétées, utilisez « Se souvenir d'autoriser » pour éviter d'être interrompu pour le même motif.

Modes d'approbation

• Demander l'approbation : vous cliquez Autoriser ou Ignorer pour chaque action.
• Réviser pour moi : l'approbation n'est demandée que pour les actions détectées comme risquées.
• Tout autoriser : pas d'invite par étape, mais les commandes dangereuses restent bloquées ; la liste de mots dangereux est personnalisable. N'utilisez pas ce niveau avant de connaître le flux.

7. Outils intégrés

L'assistant est livré avec 39 outils intégrés couvrant l'exécution sur appareil, les fichiers et documents, la recherche d'actifs, la recherche de code, l'accès web et la surveillance. Les actions de modification passent d'abord par le mode d'approbation ; les requêtes s'exécutent directement.

Exécution sur appareil

• Commande locale : exécute des commandes sur cette machine ; les tâches longues passent en arrière-plan et vous pouvez lister les processus, lire la sortie ou interrompre à tout moment.
• SSH / SSH par lots : exécute des commandes sur un ou plusieurs appareils enregistrés, en parallèle en mode lot.
• Telnet : exécute des commandes sur des cibles Telnet telles que les appareils réseau.

Fichiers et documents

• Transfert SFTP : téléversement et téléchargement entre cette machine et les appareils.
• Lire / modifier des fichiers : lire des fichiers texte locaux et distants et appliquer des remplacements exacts.
• Traitement de documents : lire des PDF, lire et écrire Excel et Word, et produire directement des rapports d'inspection.

Actifs et contexte

• Trouver des appareils / groupes / compétences : consultez les actifs de l'inventaire comme contexte à tout moment.
• Historique des discussions et liste de tâches : parcourez les conversations passées et gardez le travail en plusieurs étapes sous forme de liste.

Code et références

• Outils de code : carte de structure du dépôt, recherche de contenu, définitions et références de symboles.
• Sous-agent d'exploration : exploration parallèle en lecture seule de grands répertoires ou de longs documents, résumée dans la discussion principale.
• Recherche web / récupérer une page : recherchez des références externes et récupérez le contenu d'une page ; la recherche web accompagne votre compte.

Surveillance et compétences

• Lecture/écriture de métriques : lire les métriques de surveillance d'un appareil et, après confirmation, ajouter ou modifier des métriques.
• Distillation de compétence : écrire la procédure actuelle comme nouvelle compétence ou mettre à jour une existante (exige confirmation).

Scénarios typiques

• Inspection : vérifier l'état du CPU, du disque et des interfaces clés sur plusieurs appareils et produire une conclusion lisible.
• Changement : modifier un fichier de configuration et redémarrer le service, en confirmant étape par étape.
• Transfert : empaqueter des journaux distants, les ramener, analyser et produire un rapport.
• Dépannage : combiner recherche web et lecture de documents pour localiser la source d'une erreur.

8. Compétences

Une compétence est une invite Markdown réutilisable (nom + description d'une ligne + corps), stockée dans la bibliothèque locale de compétences et incluse dans la sauvegarde cloud.

• Créer : rédigez-en une sous Deck → Compétences ; distillez-en une depuis des conversations passées avec l'IA ; ou laissez l'assistant enregistrer une nouvelle compétence après votre confirmation.
• Utiliser : « + → Compétences » dans la barre de saisie, ou référencez-la directement. Une fois référencée, elle reste active pour le tour, les suivis n'ont plus besoin de la référencer à nouveau.
• Faire évoluer : l'assistant peut affiner le contenu d'une compétence pendant qu'il l'utilise ; les changements exigent aussi une confirmation.

9. Serveurs MCP

L'assistant peut se connecter à des serveurs MCP (Model Context Protocol) pour amener des outils externes dans la même conversation.

• Transports : stdio (lancé par une commande locale) et Streamable HTTP (URL distante).
• Configurer : Deck → Serveurs MCP → Ajouter ; renseignez commande, arguments et variables d'environnement, ou collez une configuration JSON à importer.
• Activation : une fois activé, ses outils rejoignent le jeu d'outils de l'assistant ; les outils intégrés l'emportent en cas de conflit de nom. La liste montre l'état de chaque serveur et le nombre d'outils.
• Sécurité : chaque appel d'outil MCP passe par le même mode d'approbation que les outils intégrés.

Les appels ne font rien tant qu'un serveur n'est pas prêt (processus non démarré ou URL injoignable) ; vérifiez d'abord son état dans la liste.

10. Suggestions de commandes du terminal

Activez Suggestions de commandes sous Paramètres → Capacités IA et les candidats apparaissent près du curseur pendant la saisie dans les terminaux locaux ou distants. Le modèle de suggestion est configuré dans le cloud ; en local, vous choisissez seulement le nombre de candidats.

• Aperçu et liste côte à côte ; Tab pour accepter, flèches pour changer ; fermez le panneau pour continuer à taper.
• Le panneau accepte une intention en langage naturel : appuyez sur Entrée pour générer des candidats.
• Les candidats suivent la session et le type d'appareil courants, et correspondent au dialecte du moment.
• Si les suggestions n'apparaissent pas : vérifiez que l'option est activée, que vous êtes connecté, et que le volet courant est un type de session qui prend en charge les suggestions.

11. Surveillance et découverte

Chemin : Home → Tâches. Deux onglets : Surveiller et Découvrir.

Surveiller

1. Cliquez Nouvelle tâche, cochez les hôtes à observer et confirmez.
2. Consultez les métriques sur la carte d'appareil ; ouvrez les détails pour configurer nom, protocole, intervalle, analyse, alertes et montée IA.
3. Options de montée IA : désactivée, analyse seulement (L1), réparation avec confirmation (L2). L2 passe encore par la confirmation de l'assistant et ne change jamais la configuration en silence.
4. Utilisez « Collecter maintenant » pour vérifier qu'une métrique unique produit la valeur attendue.

Découvrir

1. Choisissez un modèle d'exploration sous Paramètres → Capacités IA (les modèles cloud sont disponibles après connexion).
2. De retour dans Surveiller, lancez Découvrir les métriques automatiquement sur un appareil ; le processus s'affiche comme exploration.
3. Relisez le résumé d'exploration et les candidats dans l'onglet Découvrir ; chacun est en attente ou adopté. Cochez et cliquez Adopter avant qu'ils n'entrent dans la collecte de routine.

L'exploration ne propose que des candidats et ne lance jamais la collecte d'elle-même ; c'est vous qui décidez ce qui rejoint la routine.

12. Spécifications des protocoles

Les détails d'implémentation de SSH, Telnet, RDP, SFTP et du shell local — matrice d'authentification, négociation d'options, capacités de canaux, modèle de confiance et exigences système — sont rassemblés sur la page des spécifications techniques et restent alignés avec l'application de bureau.

13. Modèles personnalisés (avancé, facultatif)

Inutile par défaut : les modèles cloud fonctionnent après connexion. Configurez ceci seulement lorsque vous voulez utiliser votre propre service de modèles.

1. Ouvrez Home → Paramètres → Modèles → Ajouter un modèle.
2. Choisissez un modèle de fournisseur (OpenAI, Anthropic, DeepSeek, Ollama, OpenRouter, Moonshot, Qwen, Zhipu) ou une URL de base personnalisée.
3. Saisissez la clé API et le nom du modèle, enregistrez, et il devient sélectionnable dans la barre de saisie Deck.

Les clés de modèles personnalisés sont stockées uniquement sur cette machine.

14. Sécurité et valeurs par défaut

• L'assistant est par défaut sur Demander l'approbation. Habituez-vous au rythme des appels d'outils avec des tâches en lecture seule avant d'élargir le périmètre.
• « Se souvenir d'autoriser » ne s'applique qu'aux commandes similaires ; ce n'est pas une sourdine globale.
• « Tout autoriser » bloque encore les commandes de la liste de mots dangereux, que vous pouvez personnaliser.
• Les empreintes d'hôte doivent être confirmées à la première connexion ; lorsqu'une change, vérifiez que le changement est attendu avant de choisir comment lui faire confiance.
• Mots de passe d'appareils, matériel de clés et clés de modèles personnalisés sont dans le périmètre de confiance local — protégez l'ordinateur qui exécute Termini.
• La réparation automatique d'alerte (L2) suit votre politique de confirmation comme n'importe quelle action d'écriture de l'assistant.

Voir la page des fonctionnalités pour une description plus complète ; après l'installation, suivez les étapes 2 → 3 → 4 → 6 ci-dessus pour boucler votre première boucle.