Codes de sortie Bash, sortie du script et diffs de fichiers dans une carte de chat

Ce que l'agent peut faire

• Fichiers read_file, write_file, edit_file, grep, glob et list_dir fonctionnent dans le dossier de travail du chat, et edit_file affiche un diff de chaque modification. Un compteur indique combien de fichiers ont été créés, modifiés et lus.
• Shell exécute une commande dans l'environnement choisi, comme Windows, WSL ou un serveur que vous possédez via SSH, et rapporte le vrai code de sortie. Les commandes dangereuses sont bloquées.
• Web web_search effectue des recherches et http_get récupère une page de documentation, pour que vous puissiez lire ce qu'une commande fait avant de l'utiliser.
• Captures d'écran et images ocr lit le texte d'une capture d'écran enregistrée, par exemple un message d'erreur, et gen_image sauvegarde des fichiers image.
• Orchestration task lance des sous-agents en parallèle, run_on_model envoie une étape difficile à un modèle plus grand, et les skills sont des playbooks réutilisables.
• Modes d'approbation Auto-run agit immédiatement, Ask first met en pause avant les actions qui modifient quelque chose, et Plan only écrit un plan et n'exécute rien.
• Cron exécute une invite à intervalles réguliers, par exemple un test quotidien de votre propre script sur une machine que vous possédez.
• Modèles un fournisseur d'IA cloud via un point de terminaison API, un modèle sur votre PC, ou le modèle intégré, qui est prêt sans votre propre point de terminaison.

Quatre tâches avec des codes de sortie et des arguments

Vérifier le code de sortie quand un argument manque

Vous demandez à l'agent de découvrir ce qui se passe lorsque check.sh ne reçoit aucun argument. read_file ouvre le script, et Shell exécute bash check.sh sans rien après le nom. La carte affiche la sortie réelle et le code de sortie, qui est 2 si le script affiche sa ligne d'aide sur stderr et se termine par exit 2. Le code de sortie Bash de la dernière commande se trouve dans $?, et l'appelant ne voit que ce nombre, donc un script qui se termine par un code clair est plus facile à tester qu'un script qui retourne toujours 1. Shell exécute ensuite à nouveau le script avec deux valeurs, et la carte devrait afficher 0. Si les codes vous surprennent, lisez la carte, puis laissez edit_file proposer une correction sous Ask first et examinez le diff.

Analyser les options avec getopts

Vous tapez « expliquez-moi getopt » et l'agent répond en termes clairs : getopts est un utilitaire Bash pour les options courtes comme -v ou -f file, tandis que getopt est une commande distincte qui gère également les options longues comme --file et se comporte différemment selon les systèmes. Ensuite, read_file ouvre votre script, edit_file ajoute une boucle getopts et vous voyez le diff. Shell exécute le script avec -v, avec -f et avec une option incorrecte, et chaque carte a son propre code de sortie. Une option incorrecte devrait se terminer par 2, le code habituel pour une mauvaise utilisation. Pour quelques options, une boucle while avec case et shift suffit, alors demandez cette version si vous la préférez. Acceptez le diff seulement après l'avoir lu.

Conserver les valeurs avec des espaces intactes

Transmettre des arguments avec des espaces à un script échoue lorsque les valeurs ne sont pas entre guillemets, car le shell les divise en mots séparés. L'agent lit le fichier avec read_file, trouve le $1 et le $@ non entre guillemets, et edit_file propose des guillemets doubles autour d'eux. Shell exécute ensuite le script avec une valeur comme « deux mots », et la sortie montre si elle arrive comme une seule ligne ou comme deux. L'une des astuces pour gérer les arguments en ligne de commande est shift, qui supprime la première valeur afin qu'une boucle puisse parcourir le reste, et l'agent peut l'ajouter dans le même diff. Sous Ask first, la modification attend votre accord. Examinez le diff, relancez le test et comparez les deux sorties vous-même.

S'arrêter en cas d'erreur avec set -eu

Quiconque recherche « bash exit script » cherche généralement la commande intégrée exit : exit N met fin au script avec le statut N, tandis que return N ne quitte qu'une fonction. L'agent peut ajouter set -eu et set -o pipefail en haut, afin que le script s'arrête en cas d'erreur et de variables non définies, puis il exécute le fichier avec bash -n pour une vérification de syntaxe et avec bash -x pour imprimer chaque commande. Si return ne donne pas le statut de la dernière commande, une autre commande a probablement été exécutée entre-temps, car $? ne contient que le code de sortie de la commande la plus récente. La carte Shell affiche la trace. Lisez-la du début, comparez-la avec le script et décidez si la modification reste.