Bash-exitcode, scriptoutput en bestandsdiffs in een chatkaart

Wat de agent kan doen

• Bestandenread_file, write_file, edit_file, grep, glob en list_dir werken in de werkmap van de chat, en edit_file toont een diff van elke wijziging. Een teller geeft aan hoeveel bestanden zijn aangemaakt, bewerkt en gelezen.
• Shellvoert een opdracht uit in de gekozen omgeving, zoals Windows, WSL of een server die je via SSH beheert, en rapporteert de echte exitcode. Gevaarlijke opdrachten worden geblokkeerd.
• Webweb_search zoekt informatie op en http_get haalt één documentatiepagina op, zodat je kunt lezen wat een opdracht doet voordat je hem gebruikt.
• Screenshots en afbeeldingenocr leest tekst uit een opgeslagen screenshot, bijvoorbeeld een foutmelding, en gen_image slaat afbeeldingsbestanden op.
• Orkestratietask start sub-agents parallel, run_on_model stuurt een moeilijke stap naar een groter model, en skills zijn herbruikbare playbooks.
• KeuzemodiAuto-run voert direct uit, Ask first pauzeert voordat er iets wordt gewijzigd, en Plan only schrijft een plan en voert niets uit.
• Cronvoert een prompt uit volgens een schema, bijvoorbeeld een dagelijkse testrun van je eigen script op een machine die je beheert.
• Modelleneen cloud-AI-aanbieder via een API-eindpunt, een model op je pc, of het ingebouwde model, dat direct klaarstaat zonder je eigen eindpunt.

Vier taken met exitcodes en argumenten

De exitcode controleren als een argument ontbreekt

Je vraagt de agent te onderzoeken wat er gebeurt als check.sh geen argument krijgt. read_file opent het script, en Shell voert bash check.sh uit zonder argumenten. De kaart toont de echte output en de exitcode, die 2 is als het script zijn gebruiksinstructies naar stderr schrijft en eindigt met exit 2. De bash-exitcode van de laatste opdracht staat in $?, en de aanroeper ziet alleen dat getal, dus een script dat eindigt met een duidelijke code is makkelijker te testen dan er eentje die altijd 1 retourneert. Shell voert het script daarna opnieuw uit met twee waarden, en de kaart zou 0 moeten tonen. Als de codes je verrassen, lees de kaart, laat edit_file een fix voorstellen onder Ask first en bekijk de diff.

Opties parseren met getopts

Je typt “verklari getopt aan mij” en de agent antwoordt in gewone woorden: getopts is een Bash-inbouwopdracht voor korte opties zoals -v of -f bestand, terwijl getopt een apart commando is dat ook lange opties zoals --bestand aankan en zich tussen systemen anders gedraagt. Dan opent read_file je script, edit_file voegt een getopts-lus toe en je ziet de diff. Shell voert het script uit met -v, met -f en met een verkeerde optie, en elke kaart heeft zijn eigen exitcode. Een verkeerde optie zou moeten eindigen met 2, de gebruikelijke code voor verkeerd gebruik. Voor een handvol opties is een while-lus met case en shift voldoende, dus vraag om die versie als je die prefereert. Accepteer de diff pas nadat je hem hebt gelezen.

Waarden met spaties intact houden

Argumenten met spaties doorgeven aan een script faalt als de waarden niet tussen aanhalingstekens staan, omdat de shell ze opsplitsen in aparte woorden. De agent leest het bestand met read_file, vindt de niet-aangehaalde $1 en $@, en edit_file stelt dubbele aanhalingstekens rondom voor. Shell voert het script daarna uit met een waarde zoals "twee woorden", en de output toont of het als één regel of als twee aankomt. Een van de trucs om opdrachtregelargumenten te beheren is shift, die de eerste waarde verwijdert zodat een lus door de rest kan lopen, en de agent kan dit toevoegen in dezelfde diff. Onder Ask first wacht de bewerking op jou. Bekijk de diff, voer de test opnieuw uit en vergelijk de twee outputs zelf.

Stoppen bij fouten met set -eu

Iedereen die zoekt naar “bash exit script” is meestal op zoek naar de exit-inbouwopdracht: exit N beëindigt het script met status N, terwijl return N alleen een functie verlaat. De agent kan set -eu en set -o pipefail bovenaan toevoegen, zodat het script stopt bij fouten en bij niet-gedefinieerde variabelen, en voert daarna het bestand uit met bash -n voor een syntaxcontrole en met bash -x om elke opdracht af te drukken. Als return niet de status van de laatste opdracht geeft, liep er meestal een andere opdracht ertussen, omdat $? alleen de exitcode van de meest recente opdracht vasthoudt. De Shell-kaart toont de trace. Lees deze van bovenaf, vergelijk hem met het script en beslis of de bewerking blijft staan.