Une interface web pratique pour l'agent IA en console pi

Travailler dans le terminal est formidable tant que le contexte tient sur un écran. L'agent de codage en console pi est excellent pour les modifications rapides, mais une session de débogage d'une heure se transforme en chaos d'appels de fonctions, de code généré et de messages d'erreur. Bonne chance pour trouver le point dans ce flux où le modèle s'est écarté du sujet, ou pour se souvenir du fichier qu'il modifiait vingt minutes plus tôt.

Le développeur agegr a résolu ce problème de manière très pratique : il a créé un shell web local appelé pi-web. L'outil lit les fichiers journaux de l'agent pi et lance un tableau de bord visuel pratique dans le navigateur.

Qu'est-ce que pi-web et comment ça fonctionne

Au cœur du système, pi-web est un wrapper autour de l'agent en console pi. Au lieu de réécrire l'agent lui-même, l'auteur a créé un frontend qui analyse les fichiers .jsonl du répertoire ~/.pi/agent/sessions.

L'application s'exécute entièrement en local. Vous pouvez la lancer sans aucune installation préalable avec une seule commande :

npx @agegr/pi-web@latest

Le serveur démarrera sur le port 30 141 et ouvrira automatiquement un onglet dans le navigateur. Si le port est occupé ou si vous avez besoin d'un accès local uniquement, les paramètres se modifient facilement via des drapeaux :

pi-web --port 8080 --hostname 127.0.0.1

Ce qui change dans le flux de travail

Le principal problème des dialogues IA en console est la perte de structure. Dans le terminal, tout ressemble à un mur de texte continu. L'interface web décompose la même session en blocs visuels nets.

Branche-ment visuel de session

Lorsque l'agent IA commence à atteindre des impasses, dans la console vous devez soit réinitialiser le dialogue, soit générer un historique long de tentatives de réessai. Pi-web propose deux voies pour une expérimentation sécurisée :

• Fork crée un fichier de session .jsonl séparé. Vous pouvez suivre une nouvelle voie tout en préservant l'ancien résultat.
• L'édition à partir d'un message sélectionné crée une branche supplémentaire dans la même session.

Visualisation des fichiers à côté du chat

Pendant que l'agent modifie du code ou rédige de la documentation, vous pouvez suivre les modifications directement dans le panneau adjacent. L'explorateur de projet se trouve à gauche et la zone d'aperçu à droite. La visionneuse intégrée affiche non seulement les fichiers sources et les diffs. Elle gère sans peine les images, l'audio, les PDF et les documents DOCX.

Contrôle transparent des jetons et des paramètres

La barre supérieure affiche les jetons consommés, le coût de la session et l'état de compression du contexte. Plus besoin de deviner quelle partie de vos limites a été utilisée et quel prompt système est actif à un moment donné.

La gestion des modèles et des clés API a également migré des fichiers JSON de la console vers une interface graphique. Via les panneaux de paramètres, vous pouvez modifier le modèle par défaut, tester les connexions et activer ou désactiver les compétences de l'agent.

Support des Git worktrees

Si vous utilisez les Git worktrees pour travailler en parallèle sur plusieurs branches, la barre latérale pi-web peut basculer les environnements à la volée. L'explorateur de fichiers et les nouvelles sessions s'adaptent automatiquement au checkout sélectionné.

Comment l'architecture est conçue

Le projet est écrit en TypeScript en utilisant le framework Next.js. La structure du dépôt est simple et directe.

Le dossier app/api contient les endpoints pour travailler avec l'agent :

• agent/ gère le lancement de session et le streaming d'événements via Server-Sent Events (SSE).
• files/ gère la lecture des fichiers, les diffs et le suivi des modifications.
• models-config/ et skills/ gèrent les configurations de l'agent.

La sécurité est assurée par le module lib/file-access.ts. Il restreint le gestionnaire de fichiers au projet actuel et aux répertoires impliqués dans la session. Vous ne pourrez pas lire un fichier système aléatoire via l'interface utilisateur.

Qui trouvera ce projet utile

Si vous utilisez activement l'agent de codage pi, vous devriez absolument essayer pi-web. Le projet résout le principal problème des outils CLI — le manque de clarté visuelle.

L'interface devient particulièrement pratique dans deux cas :

• Lors du débogage de tâches complexes nécessitant des retours fréquents aux étapes précédentes et la comparaison de variantes de solutions.
• Lors du travail avec des fichiers multimédias et de la documentation, lorsque la possibilité de prévisualiser rapidement les résultats dans le navigateur fait gagner du temps.

L'outil est activement développé : il compte déjà plus de 16 000 étoiles sur GitHub et des commits récents. Vous n'avez besoin que de Node.js et de l'agent pi installé pour l'exécuter, donc la configuration ne prendra littéralement que quelques minutes.