Je laat een AI-agent autonoom code schrijven. Na twintig minuten kijk je terug: de sessie is gecrasht, de output weg, en je begint opnieuw. Herkenbaar? Het probleem zit niet in de agent. Het zit in de infrastructuur eromheen.
Tmux sessions: sluit je laptop, behoud je werk
De eerste fout: je agent draait in een gewone terminal.
Sluit je laptop en alles is weg. De oplossing heet tmux — een terminal multiplexer die sessies loskoppelt van je fysieke verbinding.
De setup is simpel.
Start een benoemde sessie met tmux new -s agent-build, draai je agent daarin, en detach veilig met Ctrl+B gevolgd door D. De sessie blijft draaien op je server, ongeacht wat er met je verbinding gebeurt.
Maar tmux biedt meer dan persistentie alleen:
- Meerdere vensters en panelen — een voor je agent, een voor logs, een voor testresultaten
- Real-time zicht op wat je agent doet, zonder de sessie te onderbreken
- Logging plugins voor een volledig audittrail, inclusief timestamps en foutmeldingen
Watchdog loops: automatisch herstel bij crashes
Je agent gaat crashen. De vraag is niet of, maar wat er daarna gebeurt.
Zonder watchdog loop stopt alles en wacht de agent tot jij handmatig ingrijpt. Met een watchdog detecteert een wrapper-script de crash en herstart automatisch.
De simpelste variant is een bash while-loop:
while true; do python agent.py; sleep 5; done
Een productie-waardige watchdog doet aanzienlijk meer:
- Checkt de exit code van het proces en logt de fout
- Past exponential backoff toe bij herhaalde crashes
- Stuurt een Slack- of Telegram-notificatie als de agent drie keer achter elkaar faalt
- Bevat een health-check die controleert of de agent daadwerkelijk voortgang boekt
Een agent die in een eindeloze loop zit zonder commits te maken is net zo problematisch als een agent die crasht. Meet voortgang, niet alleen uptime.
Completion hooks: weten wanneer het echt klaar is
Zonder afrondingslogica draait je agent eindeloos door, of stopt hij willekeurig.
Een completion hook lost dit op: een mechanisme dat bepaalt wanneer een taak daadwerkelijk af is.
Een goede completion hook controleert meerdere criteria:
- Zijn alle tests geslaagd?
- Is de code gelint zonder fouten?
- Is er een commit gemaakt met een beschrijvende message?
Pas als alle checks groen zijn, markeert de hook de taak als voltooid.
Implementeer dit als een apart script met drie exit codes: 0 (klaar), 1 (nog niet af), 2 (onherstelbare fout). Op basis daarvan besluit je agent of hij doorgaat, een andere aanpak probeert, of stopt en jou waarschuwt.
Voeg altijd een tijdslimiet toe.
Een taak die na twee uur nog niet af is, heeft een fundamenteel probleem dat menselijke interventie vereist.
Error recovery in drie lagen
Het verschil tussen een hobbyproject en een professionele pipeline zit in de herstelstrategie.
Je agent krijgt een falende test, een syntax error of een dependency conflict. "Gewoon opnieuw proberen" is geen strategie.
Effectieve error recovery werkt in lagen:
Laag 1: Zelfcorrectie.
De agent leest de foutmelding, analyseert de oorzaak en past zijn code aan. Dit vangt de meeste eenvoudige fouten op.
Laag 2: Alternatieve aanpak.
Komt dezelfde fout drie keer terug? De agent schakelt over naar een andere library, een ander algoritme of een vereenvoudigde implementatie.
Laag 3: Escalatie.
Faalt ook dat? De agent maakt een gedetailleerd foutenrapport — originele opdracht, geprobeerde oplossingen, exacte foutmeldingen — en escaleert naar jou via een notificatie.
Dit drie-lagenmodel voorkomt eindeloze loops. Je agent blijft productief zonder toezicht, maar weet wanneer hij om hulp moet vragen.
Git-discipline: je vangnet bij autonome sessies
Autonome agents die direct op je main branch werken zijn een gegarandeerd probleem.
Elke sessie draait op een eigen feature branch, met frequente, atomaire commits.
Instrueer je agent om na elke geslaagde stap te committen — niet aan het einde, maar na elke functionele wijziging. Dat geeft je twee voordelen:
- Je keert altijd terug naar een werkende staat als de agent de verkeerde kant opgaat
- Je hebt een gedetailleerde geschiedenis van het denkproces van de agent
Bouw een automatisch rollback-mechanisme in.
Falen de tests na drie opeenvolgende pogingen? Terug naar de laatste groene commit. Gebruik git stash om work-in-progress op te slaan, zodat je mislukte pogingen later kunt analyseren.
En de gouden regel: stel branch protection rules in.
De agent pusht nooit direct naar main. Alleen via pull requests die jij reviewt en goedkeurt.