Butterfish

Une phrase pour présenter

Butterfish est un wrapper Shell open source pour bash et zsh qui ajoute des fonctionnalités de question-réponse par IA, de génération de commandes, de complétion automatique et d’exécution par agent, permettant aux utilisateurs d’obtenir une aide contextuelle sans avoir à copier la sortie du terminal.

Le logiciel lui-même est libre et distribué sous la licence MIT, mais il nécessite par défaut une clé API OpenAI propre à l’utilisateur ; les tokens générés par les appels aux modèles ainsi que les frais liés à la couche de service sont à la charge de l’utilisateur.

Qu’est-ce que le Butterfish ?

Butterfish Shell est maintenu par Peter Bakkum et s’adresse principalement aux développeurs et aux administrateurs qui travaillent régulièrement dans des terminaux macOS ou Linux. Il ne remplace pas la shell système, mais lance une session d’enveloppe au-dessus de bash ou zsh existants et intercepte les entrées et sorties.

Les commandes ordinaires sont toujours exécutées par Shell, tandis que les entrées en langage naturel commençant par une lettre majuscule sont envoyées au modèle. Butterfish prend en compte les commandes récentes, les résultats et les conversations précédentes dans le contexte, ce qui permet de demander directement pourquoi la commande précédente a échoué.

État de maintenance actuel

Au 20 août 2026, la dernière version officielle publiée sur GitHub est v0.4.3, et le journal des mises à jour mentionne des correctifs tels que le traitement des entrées de l’agent, les messages d’invitation au lancement de Shell et le complétion automatique à faible latence. La page du module Go indique également v0.4.3 et confirme la licence MIT.

Le projet est encore à la version 0.x, il n’est donc pas possible d’assumer une compatibilité en se basant sur une interface stable 1.0. Avant la mise à niveau, il convient de lire les modifications, de conserver les paramètres de configuration personnalisés, et de tester l’interaction avec le shell ainsi que les paramètres du modèle dans un environnement non critique.

Fonction principale

Question-réponse dans un contexte terminal

Dans Butterfish Shell, il suffit de commencer à taper en lettres majuscules pour poser une question au modèle. Les entrées et sorties récentes de Shell, ainsi que les réponses de l’IA, entrent dans le contexte, ce qui permet d’expliquer les erreurs, de poser des questions supplémentaires et de suggérer la prochaine étape en fonction du répertoire actuel.

Complétion automatique des commandes

Lorsque l’utilisateur tape une commande, Butterfish peut prédire la commande complète en se basant sur l’historique du Shell et les suggestions d’IA précédentes, et l’accepter avec Tab. La complétion automatique lance fréquemment des requêtes au modèle, ce qui peut non seulement augmenter les coûts, mais aussi transmettre des contenus sensibles en cours de saisie au service du modèle.

Agent Mode

Commencer une tâche avec un seul point d’exclamation active le Mode Agent, permettant au modèle de formuler et d’exécuter des commandes à plusieurs reprises en fonction de l’objectif, puis d’ajuster sa stratégie en fonction des résultats. Le mode de sécurité actuel conserve l’étape de confirmation manuelle, tandis que deux points d’exclamation activent le mode dangereux sans confirmation.

Action Mode

Commencer une requête par un seul @ demande au modèle de générer exactement une commande Shell, qui est ensuite affichée dans la terminal pour que l’utilisateur puisse la vérifier. Deux @ exécutent immédiatement le résultat généré ; cette option ne doit être envisagée que lorsque la cible, le répertoire et les effets secondaires sont clairement définis.

Commande prompt indépendante

La sous-commande prompt peut envoyer directement du texte, ou bien combiner des entrées par pipeline avec des prompts pour restituer les résultats du modèle de manière fluide. Elle convient à l’interprétation de configurations, à la rédaction de résumés, ou pour effectuer des questions-réponses ponctuelles en dehors d’un script.

Génération par la commande gencmd

gencmd convertit le langage naturel en commandes Shell et permet à l’utilisateur de vérifier les résultats au préalable. L’option forcée passe outre la confirmation pour exécuter directement la commande générée, ce qui présente un risque élevé pour les opérations de suppression, de remplacement, de téléchargement réseau et de modification des permissions.

Correction d’erreur exec

exec sert à exécuter la commande spécifiée et, en cas d’échec, à demander une analyse du modèle ainsi que des suggestions de correction. Il peut réduire les étapes nécessaires pour copier les journaux d’erreurs, mais les recommandations doivent néanmoins être vérifiées manuellement en fonction du système d’exploitation, de la version des outils et de l’état du projet.

• Poser des questions à l’IA directement dans la terminal, avec le contexte d’historique du shell.
• Fournir la complétion automatique par Tab en fonction de l’entrée actuelle et des commandes récentes.
• Convertir le langage naturel en commandes Shell vérifiables.
• Exécuter la commande et générer des suggestions de correction pour les erreurs affichées.
• Utiliser le mode Agent pour exécuter en boucle et déboguer des objectifs à plusieurs étapes.
• Utilisez le Mode Action pour générer une commande adaptée à la tâche actuelle.
• Voir et modifier les messages système et les instructions de commande envoyés au modèle.
• Services de modèles compatibles permettant de se connecter à OpenAI ou d’implémenter une interface en flux pour les Responses.
• Envoyer des fichiers ou d’autres sorties de commandes à la modèle pour traitement via l’entrée standard.

Comment fonctionne le mode Shell

1. L’utilisateur lance Butterfish Shell, le programme lance alors le bash ou zsh d’origine dans une couche d’enveloppement.
2. La saisie par clavier ordinaire et la sortie des commandes continuent d’apparaître dans le terminal et sont enregistrées dans l’historique de la mémoire.
3. Les commandes ordinaires sont transmises directement à Shell, tandis que les prompts en majuscules et les préfixes de mode spécial sont interceptés par Butterfish.
4. Lors de la soumission d’une demande de modèle, le programme utilise les informations système, les modèles de suggestions et le contexte historique récent.
5. La demande doit être envoyée via l’interface OpenAI Responses ou un serveur compatible, et les résultats doivent être écrits en flux continu vers le terminal.
6. Si le modèle suggère une commande, le mode sécurisé la place d’abord dans le Shell pour que l’utilisateur puisse la vérifier et la modifier.
7. L’utilisateur continue d’exécuter, pose des questions supplémentaires ou quitte ; l’historique de la session actuelle est tronqué et organisé avec la fenêtre de contexte.

L’historique de la mémoire ne signifie pas que les données ne quittent jamais le dispositif. Chaque fois qu’une demande d’IA est initiée, les commandes sélectionnées dans le contexte, les résultats, les suggestions et les informations système sont envoyés au serveur de modèle configuré.

Guide d’installation

Installation via Homebrew

Les utilisateurs de macOS peuvent l’installer à l’aide du Homebrew Tap fourni par le mainteneur, puis lancer le Butterfish Shell. Une fois l’installation terminée, consultez d’abord la version et la documentation pour vous assurer que c’est bien le fichier binaire attendu qui est utilisé.

1. Vérifier que le matériel prend en charge macOS et que Homebrew est déjà installé.
2. Installez Butterfish depuis la Tap du mainteneur, et n’utilisez pas de paquets logiciels du même nom provenant de sources non fiables.
3. Exécuter la commande de version et la comparer avec la dernière publication officielle.
4. Lors de la première mise en marche du mode Shell, configurez la clé API du modèle selon les indications.
5. Exécuter des commandes ordinaires et des questions-réponses simples dans le répertoire temporaire, afin de vérifier qu’il n’y a pas d’anomalies dans les entrées/sorties du Shell.
6. Vérifiez que le mode de sécurité attend une vérification manuelle avant d’exécuter la commande de génération.

Installation via Go

macOS et Linux permettent également d’installer les modules les plus récents à l’aide de la chaîne d’outils Go, ce qui convient aux utilisateurs qui ne souhaitent pas utiliser Homebrew ou qui veulent compiler depuis le code source. Les binaires installés se trouvent généralement dans le répertoire bin de l’environnement Go ; il est nécessaire de s’assurer que ce répertoire est ajouté à PATH.

1. Installez la chaîne d’outils Go actuellement disponible et vérifiez le répertoire de l’environnement Go.
2. Installez les commandes Butterfish les plus récentes en utilisant le chemin du module officiel.
3. Ajoutez le répertoire bin de Go à PATH et rouvrez la terminal.
4. Vérifier la version de Butterfish, la licence et les informations d’aide.
5. Configurez la clé lors du premier démarrage, et testez la connexion avec des tests sans effets secondaires.

Première configuration et clé API

Lors de la première appel, Butterfish demandera une clé API d’OpenAI, qu’il stockera dans un fichier d’environnement du répertoire de configuration de l’utilisateur. La clé n’est pas liée à une abonnement en ligne de ChatGPT ; le solde et les droits d’accès dépendent d’un compte API indépendant.

• Utilisez uniquement des clés de projet dont les droits et les quotas sont contrôlés, et ne réutilisez pas les clés de production à hauts droits.
• Restreignez les permissions système du répertoire de configuration et des fichiers de clés pour empêcher les autres utilisateurs locaux de les lire.
• Ne soumettez pas le répertoire de configuration à Git, ne le synchronisez pas sur un stockage en ligne public, et n’allez pas le copier dans les rapports de problèmes.
• Lorsqu’une clé est découverte dans les journaux, des captures d’écran ou partagée via une terminal, elle doit être immédiatement annulée et remplacée.
• Lors de la connexion à un serveur compatible, veillez à ce que la clé soit envoyée à ce serveur avec la requête.
• Des clés et des budgets distincts doivent être attribués aux équipements d’équipe, afin de permettre des audits et de stopper toute consommation anormale.

Guide d'utilisation quotidienne

1. Entrez dans le répertoire du projet et lancez Butterfish Shell ; utilisez d’abord des commandes ordinaires pour vérifier l’état actuel.
2. Lorsqu’une erreur se produit, demandez la raison en langue naturelle en majuscules, et demandez au modèle d’expliquer plutôt que de corriger immédiatement.
3. Vérifier les commandes citées dans la réponse, les chemins, les versions des outils et les différences de système d’exploitation.
4. Utilisez le mode Action sécurisé lorsqu’une commande est nécessaire, afin que le résultat soit d’abord affiché dans la terminal plutôt que d’être exécuté directement.
5. Les tâches complexes peuvent utiliser le Mode Agent, mais il faut examiner les commandes et les résultats à chaque fois.
6. Une fois terminé, vérifiez si des journaux sensibles ont été générés, puis quittez le shell d’emballage.

Utilisation sécurisée d’Agent et d’Action

Le mode d’exécution automatique peut supprimer des fichiers, écraser des données, télécharger des informations secrètes, installer du logiciel malveillant ou modifier les permissions du système. Même si la tâche semble simple, ne l’activez pas sur des serveurs de production, dans une Shell d’administrateur ou dans des dossiers contenant des données non sauvegardées.

• Exécutez d’abord une vérification en lecture seule, puis envisagez les opérations d’écriture, d’installation, de déplacement ou de suppression.
• Utilisez des utilisateurs ordinaires, des conteneurs, des branches temporaires ou des environnements virtuels uniques pour limiter l’impact.
• Déplier les variables, les wildcards, les cibles récursives et le répertoire de travail actuel avant l’exécution.
• Maintenir une validation manuelle pour le téléchargement et l’exécution de scripts, l’escalade de privilèges et les commandes disque.
• Apportez d’abord les modifications importantes au système de contrôle de version ou créez une sauvegarde vérifiable.
• Ne considérez pas les réponses du modèle comme une audit de sécurité ou une autorisation d’accès.

Sélection de modèles et modèles locaux

La documentation actuelle de la branche principale GitHub indique que les modèles par défaut pour Shell et prompt sont GPT-5.5, avec un niveau d’inférence élevé ; le mode rapide demande également l’utilisation du niveau de service priority de l’API Responses. Les utilisateurs peuvent remplacer le modèle, le niveau d’inférence, la longueur maximale de la sortie et le niveau de service à l’aide de paramètres.

Les pages plus anciennes du site officiel présentent encore des exemples de GPT-4 Turbo et GPT-3.5 Turbo, ce qui relève de documents historiques. Les valeurs par défaut réelles doivent se baser sur les informations fournies par l’aide de la version installée ainsi que sur le dépôt actuel, car les noms des modèles et leur disponibilité peuvent varier en fonction de la plateforme API.

Butterfish peut également se connecter à des serveurs locaux ou distants qui implémentent une interface en flux de réponses compatible avec OpenAI. La compatibilité exige non seulement des chemins similaires, mais aussi une implémentation correcte des résultats en flux ; les modèles de prompt sont principalement optimisés pour OpenAI, et les performances des modèles locaux peuvent être nettement différentes.

Prix et coûts d’utilisation

Le programme Butterfish est lui-même gratuit, sans forfaits membres officiels, frais mensuels ou tarifs par poste. La licence MIT autorise l’utilisation, la modification et la distribution selon ses conditions ; les coûts réels pour les utilisateurs proviennent principalement de l’API des modèles, du niveau de service prioritaire, du calcul local et de la maintenance.

Une fois la complétion automatique activée, des requêtes vers le modèle peuvent être envoyées fréquemment pendant les pauses, ce qui constitue l’un des principaux canaux d’utilisation quotidienne. Il est possible de désactiver la complétion automatique ou d’augmenter le délai de déclenchement, ainsi que d’annuler les couches de service à priorité non nécessaires.

Suggérer la transparence et la personnalisation

Butterfish stocke les suggestions système, la génération de commandes et les complétions automatiques dans une configuration YAML que l’utilisateur peut consulter et modifier. Les entrées modifiées doivent désactiver le marqueur de remplacement automatique, sinon la mise à jour de la bibliothèque des suggestions pourrait écraser la version personnalisée.

• Vérifiez que les messages du système Shell correspondent au style de sécurité et aux commandes de l’équipe.
• Exiger que la commande génère des paramètres d’interprétation par défaut, des chemins et des effets secondaires.
• Définir des règles claires interdisant l’exécution automatique pour la production, les bases de données et les ressources cloud.
• Après la mise à niveau, comparez les indications par défaut ; ne conservez pas aveuglément des modèles obsolètes.
• Utilisez le contrôle de version pour enregistrer les fichiers de suggestions désensibilisés, mais excluez les clés et les chemins locaux.
• Les règles de suggestion ne peuvent qu’réduire la probabilité d’erreurs, elles ne peuvent pas remplacer les droits du système d’exploitation ni l’approbation humaine.

Confidentialité et sécurité des données

Butterfish est une CLI open source locale, sans compte Butterfish centralisé ni service de stockage historique des conversations. Les requêtes aux modèles envoient toujours l’historique du shell sélectionné, les sorties des commandes, les informations système, les prompts utilisateur et les dialogues avec l’IA vers l’endpoint API configuré.

Lorsque le mode détaillé est utilisé, la requête complète et la réponse peuvent être affichées dans la terminal ou écrites dans un fichier de journal situé dans le répertoire temporaire du système. La sortie de la terminal contient souvent le token d’accès, les variables d’environnement, le contenu de la base de données et les informations du client ; les fichiers de journal de débogage doivent être considérés comme des documents sensibles.

• Ne lancez pas de questions-réponses contextuelles directement après l’affichage des clés, des enregistrements de la base de données de production ou des informations des clients.
• Vider les journaux de Butterfish et les sorties de Shell avant d’utiliser les terminaux partagés, d’enregistrer l’écran et de signaler des problèmes.
• Vérifiez les journaux, les politiques de formation et de conservation lors de la connexion à des endpoints tiers ou compatibles localement.
• Restreindre la fenêtre historique ne garantit pas que les secrets soient systématiquement exclus ; il convient d’éviter activement de les afficher au cours de la session.
• Les serveurs distants doivent utiliser une transmission chiffrée ; ne transmettez pas les tokens d’authentification à des adresses non fiables.
• L’environnement de l’entreprise doit d’abord confirmer la politique d’utilisation des fournisseurs de code, de données et de modèles.

Systèmes de soutien et dépendances

À qui s’adresse-t-il

• Débutants en ligne de commande : obtenir l’explication des commandes et les raisons des erreurs, mais il reste nécessaire d’apprendre les bases du Shell.
• Développeur logiciel : Continuer à poser des questions en fonction du répertoire actuel, des résultats de la compilation et des échecs des tests.
• Ingénieur DevOps : Générer des commandes de diagnostic en lecture seule et analyser les journaux ; les modifications en production doivent néanmoins faire l’objet d’une approbation.
• Amateurs de logiciels libres : révision du code source, modèles de suggestions et logique d’envoi des données.
• Utilisateur du modèle local : connecter l’assistant terminal à un service local compatible avec l’interface Responses.
• Équipes ayant besoin de prompts personnalisables : intégrer le style des commandes et les exigences de sécurité dans une bibliothèque de prompts transparents.

Scénarios d'utilisation typiques

• Expliquez la commande de construction, de test, de gestion de paquets ou de Git qui vient d’échouer.
• Générer des commandes en lecture seule pour rechercher des fichiers, afficher les ports, faire des statistiques sur les dossiers et filtrer les journaux.
• Transmettre le fichier de configuration ou la sortie des commandes au résumé du modèle via un pipe.
• Ajustez les paramètres en fonction des différences de version de l’outil, et expliquez la fonction de chaque indicateur.
• Laissez l’Agent exécuter des tests dans la branche temporaire et tenter de résoudre des problèmes simples.
• Utiliser des modèles locaux pour traiter les tâches terminales internes à faible risque qui ne conviennent pas à être envoyées dans le cloud public.

Avantages du produit

• Utiliser directement l’historique de Shell pour réduire les commandes à copier, les erreurs et les allers-retours de contexte.
• L’emballage inclut le bash ou zsh existant, et les habitudes liées aux commandes courantes restent globalement inchangées.
• Les agents de type Q&A, à commande unique et à plusieurs étapes ont des préfixes d’entrée clairement distincts.
• Les modèles de suggestions et les demandes de modèle original peuvent être consultés et modifiés.
• Il prend en charge le service par défaut d’OpenAI, et peut également se connecter à des modèles locaux ou distants compatibles.
• MIT est open source et ne comporte pas de frais de abonnement Butterfish ; le code source et son fonctionnement sont auditable.
• Les sous-commandes prompt, gencmd et exec peuvent être utilisées séparément, en dehors du mode Shell complet.

Restrictions d'utilisation et précautions

• Actuellement, le support officiel concerne principalement macOS ainsi que bash et zsh sous Linux, sans promesse de version native pour Windows.
• Le mode à double préfixe Agent et Action permet de sauter la confirmation ; les commandes erronées peuvent entraîner des pertes irréversibles.
• Le modèle peut générer des commandes invalides en fonction d’une version incorrecte d’outil, d’un système d’exploitation ou d’un chemin.
• L’historique et les sorties de Shell deviennent le contexte du modèle, ce qui crée un risque de fuite de données secrètes et commerciales.
• La complétion automatique des appels fréquents à l’API peut entraîner des frais de tokens et de priorité supérieurs aux prévisions.
• Le serveur compatible local doit implémenter l’interface en flux de Responses ; la compatibilité avec les Chat Completions ordinaires n’est pas nécessairement suffisante.
• Les projets 0.x pourraient encore modifier les paramètres, les modèles par défaut, l’interaction et le format des suggestions.
• Butterfish n’est pas un système d’isolation des droits, de sauvegarde, d’audit, de protection contre les logiciels malveillants ou de validation formelle des opérations de maintenance.

API, GitHub et open source

Le code source complet de Butterfish est hébergé dans un répertoire GitHub public, sous licence MIT, et est écrit en Go. Le répertoire contient l’entrée en commande, l’enveloppe Shell, les prompts, les tests, les configurations de publication et les informations sur les dépendances ; les développeurs peuvent le examiner, le modifier et le distribuer conformément à la licence.

Ce n’est pas un SaaS qui fournit une API pour les services à distance, mais plutôt un client de l’API OpenAI Responses. Le projet n’est pas non plus le modèle lui-même ; la licence MIT ne couvre que le code Butterfish, et non OpenAI, les modèles tiers, les données des utilisateurs ou d’autres licences auxquelles il est soumis.

Informations de base

Indice de recommandation

Le score de recommandation est de 4,3 sur 5. Butterfish intègre l’historique de Shell, des indications transparentes, des agents uniques et multi-étapes dans une interface terminale familière ; il est open source, léger et permet de se connecter à des modèles locaux, ce qui le rend très attrayant pour les utilisateurs avancés de la ligne de commande.

Les points déduits proviennent principalement de l’exécution automatique à haut risque, de la confidentialité du contexte terminal, des coûts liés à l’utilisation des API et d’une portée de support limitée de la plateforme. Il convient mieux en tant que couche d’assistance pour les utilisateurs expérimentés, plutôt que de permettre à ceux qui ne connaissent pas Shell d’exécuter des commandes de modèle sans contrôle.

Questions fréquentes

Butterfish est-il gratuit ?

Le logiciel lui-même est gratuit et est distribué sous la licence MIT ; il n’existe pas de forfait d’abonnement officiel. Lorsque l’on utilise OpenAI ou d’autres modèles cloud, il est nécessaire de payer soi-même les frais associés à l’API.

Le Butterfish a-t-il un rapport avec l’écaille de poisson ?

Il n’y a pas de relation directe, Butterfish n’est que le nom du produit. Actuellement, les tests officiels portent sur bash et zsh ; il ne faut pas supposer une compatibilité avec le shell fish simplement parce que son nom contient « fish ».

Est-ce que cela prend en charge Windows ?

Les instructions officielles actuelles d’installation ne mentionnent que macOS et Linux, sans promesse de prise en charge native sous Windows. Il convient de tester par soi-même si WSL est adapté en fonction des configurations spécifiques de shell, de terminal et de modèle nécessaires.

Est-il nécessaire d’avoir un abonnement ChatGPT ?

Aucune abonnement web à ChatGPT n’est nécessaire, mais une clé API d’OpenAI distincte et un solde disponible sont requis par défaut. L’abonnement web et la facturation API sont des produits différents.

Quel modèle est utilisé par défaut ?

Selon les informations actuelles de la branche principale GitHub, GPT-5.5 et un niveau d’inférence élevé sont utilisés par défaut, tandis que le mode rapide fait appel à la couche de service de priorité. L’ancienne page officielle contient encore des exemples avec GPT-4 Turbo ; il convient de consulter la documentation de la version installée pour plus d’informations.

Est-il possible d’utiliser un modèle local ?

Il est possible de se connecter à un serveur local qui implémente une interface en flux de Responses compatible avec OpenAI. Les services compatibles uniquement avec l’interface de chat traditionnelle ne fonctionneront pas nécessairement, et la qualité du modèle pourrait également être inférieure à celle du modèle ciblé par les prompts par défaut.

L’historique de Shell sera-t-il envoyé dans le cloud ?

Lorsqu’une demande d’IA est initiée, Butterfish envoie les commandes récentes sélectionnées, les résultats et la conversation en tant que contexte à l’endpoint du modèle configuré. Les résultats sensibles ne doivent pas figurer dans la session prête à être envoyée.

Mode Agent est-il sûr ?

Le mode à un point d’exclamation nécessite encore une vérification minutieuse des commandes du modèle, tandis que deux points d’exclamation permettent de sauter la confirmation, ce qui représente un risque très élevé. Il est recommandé d’utiliser le mode sécurisé uniquement dans un environnement isolé et pour des tâches temporaires avec sauvegarde.

Quelle est la différence entre le Mode Action et le Mode Agent ?

Le mode Action tente de générer une seule commande Shell puis s’arrête, tandis que le mode Agent peut exécuter plusieurs étapes, observer les résultats et ajuster la stratégie. Un préfixe unique conserve par défaut la vérification, un double préfixe entraîne une exécution automatique.

Pourquoi le complétion automatique peut être coûteux ?

Il effectue des prédictions du modèle lorsque l’utilisateur cesse de saisir, et les requêtes fréquentes entraînent une accumulation de tokens et de frais liés à la couche de service. Il est possible de désactiver le complétion automatique, d’augmenter le temps d’attente ou de choisir un modèle moins cher.

Puis-je voir les indications complètes ?

Il est possible d’éditer la bibliothèque locale de prompts YAML, ainsi que de visualiser les requêtes et réponses originales en mode détaillé. Les journaux détaillés peuvent contenir des informations secrètes ; il convient de les supprimer soigneusement une fois utilisés.

Butterfish est-il complètement hors ligne ?

Par défaut, ce n’est pas le cas : il se connecte à l’API d’OpenAI. Seule la configuration d’un modèle compatible localement et la confirmation que toutes les requêtes ciblent des endpoints locaux permettent à l’interaction avec le modèle de rester sur le poste local ou dans le réseau privé.