AI-agents besturen vanaf een messenger met botmux
Stel je een bekend scenario voor. Je bent begonnen met een zware refactoring met Claude Code of Codex op je werkstation, en bent toen weggegaan voor thee of naar huis gegaan. Vijf minuten later bevriest de CLI, wachtend op bevestiging om een bestand te verwijderen. Je zit in het openbaar vervoer met je smartphone, en het proces zit vast.
Voor degenen die actief console AI-assistenten gebruiken, heeft ontwikkelaar deepcoldy het botmux-hulpprogramma geschreven. Het transformeert de Feishu-messenger (bekend als Lark buiten China) tot een bedieningspaneel voor twee dozijn console-agents.
Wat is de kerngedachte van het project
De meeste platforms voor het integreren van AI in chats nemen de complexe weg. Ontwikkelaars pakken de SDK van het benodigde model, bouwen een wrapper eroverheen, implementeren functieaanroepen, geheugen en bestandsafhandeling opnieuw. Het resultaat is een afgeslankte versie van een echte console-agent.
botmux neemt een andere aanpak. Het hulpprogramma probeert geen AI-agent te zijn of context te beheren via eigen code. In plaats daarvan start een achtergrondservice een volledig console-hulpprogrammaproces op je server of werkstation. Elk nieuw onderwerp of dialoog in de chat creëert een aparte sessie, waarbij uitvoer naar de messenger wordt gestreamd als interactieve kaarten.
Deze architectuur levert een mooi voordeel op. Wanneer de ontwikkelaars van Claude Code, Codex, Gemini CLI of Cursor updates uitbrengen met nieuwe commando's of MCP-serverondersteuning, hoeft botmux niet herschreven te worden. Je werkt met de originele console-applicatie met al zijn functies intact.
Vier interessante functies
Hieronder vind je details over hoe het werken met agents in de chat is gestructureerd.
Streamende kaarten en overdracht van besturing
CLI-uitvoer streamt rechtstreeks naar het messenger-bericht. Je ziet bijgewerkte tekst en kunt het proces besturen via kaartknoppen. Terminal screenshots bekijken, lange logs samenvouwen en een bevroren sessie opnieuw opstarten is allemaal beschikbaar.
Als interactieve knoppen niet genoeg zijn, biedt botmux een webterminal-link. Je kunt rechtstreeks vanaf je smartphone werken, met een speciaal toetsenbord op het scherm met Esc, Ctrl+C en navigatiepijlknoppen.
Samenwerking tussen meerdere modellen
Je kunt meerdere bots, gekoppeld aan verschillende console-hulpprogramma's, toevoegen aan één groepschat. Koppel bijvoorbeeld één bot aan Claude Code en een andere aan Codex.
Wanneer je een bot vermeldt via @, gaat het bericht naar die specifieke agent. Dit is handig voor cross-reviewing van code. Je kunt twee verschillende modellen vragen om dezelfde pull request te analyseren, en ze gaan met elkaar debatteren in de discussiethread.
Sessiemigratie tussen apparaten
Stel dat je lokaal een sessie bent gestart in de vertrouwde tmux. Met het /adopt-commando in de chat kun je die sessie direct op je telefoon overnemen.
Als een taakbespreking te lang is geduurd en gedeeld moet worden met het hele team, dan draagt het /relay-commando het hele proces over, samen met opgehoopt geheugen en context, naar de gedeelde groepschat.
Automatisering en externe triggers
Het hulpprogramma ondersteunt planning en webhooks. Je kunt periodieke alert-parsing of geplande rapportgeneratie instellen door de taak in gewone taal te beschrijven. Externe systemen kunnen agents activeren via standaard HTTP-verzoeken.
Hoe het intern werkt
Het project is geschreven in TypeScript en draait op Node.js versie 22 of nieuwer. Het gebruikt intern een adapter-architectuur om verschillende CLI's te ondersteunen:
claude-codecodexgeminicursoropencodecopilot
Lokale hulpprogramma's draaien met procesisolatie. Je kunt altijd rechtstreeks verbinden met een draaiende agent via tmux attach als je op het werkstation zit.
Installatie en eerste configuratie zijn tot een minimum beperkt:
npm install -g botmux
botmux setup
botmux start
De interactieve wizard botmux setup helpt je Feishu-account te koppelen via QR-code, configureert automatisch app-machtigingen in het enterprise-dashboard en start de basisconfiguratie.
Is het de moeite waard om te proberen
Het project heeft bijna 900 sterren verzameld op GitHub, en niet zonder reden. De code is netjes gestructureerd, en het idee om een echte CLI te gebruiken in plaats van nog een SDK te schrijven klinkt verstandig.
Het belangrijkste nadeel van het hulpprogramma is de sterke koppeling aan de Feishu/Lark-messenger. Als je team in Slack of Telegram zit, kun je het kant-en-klare hulpprogramma niet gebruiken. Je moet ofwel je eigen brug schrijven of de adapters uit de repository porten.
Desondanks, als je in Lark werkt en actief terminal AI-agents gebruikt, bevrijdt botmux je van de noodzaak om constant achter een monitor te zitten. Bekijk de projectrepository op GitHub om de lijst met ondersteunde adapters te verkennen of architectuuroplossingen te bekijken.
Gerelateerde projecten