Pi Interactive Shell : une extension pour laisser un agent piloter des CLI interactives dans un overlay observable

https://github.com/nicobailon/pi-interactive-shell

📌 Pi Interactive Shell est une extension pour l’agent Pi qui permet de lancer et piloter des applications CLI interactives (éditeur, REPL, shell, process long) dans un overlay TUI visible, avec reprise en main immédiate par l’utilisateur.

L’idée est très utile dans les cas où un agent doit passer par des outils normalement pénibles à automatiser proprement: vim, psql, ssh, htop, un serveur de dev, un git rebase -i, ou tout autre programme interactif. Au lieu d’exécuter ça “dans le noir”, le flux reste observable et contrôlable.

Le point fort du projet est le compromis entre autonomie et supervision. L’agent peut piloter le sous-processus, lire la sortie, envoyer des entrées, suivre l’état d’une session, puis l’utilisateur peut reprendre la main à tout moment en tapant simplement dans l’overlay.

Le projet propose trois modes complémentaires selon le besoin:

• interactive pour les sessions bloquantes que l’agent doit suivre en direct
• hands-free pour lancer un process long puis le monitorer par polling
• dispatch pour déléguer une tâche et être notifié à la fin sans polling continu

Ce découpage rend l’outil pratique aussi bien pour des usages manuels (édition, shell, SSH) que pour de l’orchestration plus avancée avec sous-agents, tâches en arrière-plan et récupération de sortie à la demande.

La gestion des sessions est bien pensée pour les workflows réels: reattach, background, timeout, auto-exit sur silence, capture de sortie, envoi de touches (ctrl+c, flèches, entrée), et même transfert direct du résultat d’un sous-agent vers l’agent principal.

• 👀 Overlay TUI observable pendant l’exécution
• ✋ Reprise en main utilisateur immédiate
• 🧠 Pilotage agent + sessions interactives
• 🔁 Modes interactive, hands-free, dispatch
• 🧵 Support de sessions en arrière-plan et réattache
• ⌨️ Envoi d’input texte, touches, paste et séquences plus fines

Pour les workflows d’agents, la valeur principale est de rendre visibles et auditables des étapes qui sont souvent opaques. On gagne en contrôle sans perdre la capacité d’automatiser des tâches CLI complexes.

Au final, Pi Interactive Shell apporte une brique très concrète pour connecter un agent de code à des interfaces terminal interactives, avec un niveau de supervision qui évite l’effet “boîte noire”.