pi-web : une interface web pour Pi Coding Agent
Interface utilisateur Web pour Pi Coding Agent qui maintient les sessions actives dans des espaces de travail réels.
En bref
- De quoi s’agit-il ?
- Une interface web qui maintient les sessions d'agents actives dans de vrais espaces de travail
- À qui s’adresse-t-il ?
- pi-web place une surface de contrôle accessible par navigateur au-dessus de sessions d'agents qui restent actives dans de vrais espaces de travail. Le README précise que l'outil suppose des utilisateurs de confiance et n'est ni un bac à sable ni une plateforme multi-locataires.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 4 jours.
- En quel langage est-il écrit ?
- Principalement TypeScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Ce qu'est pi-web et le problème qu'il résout
pi-web est une interface web pour Pi Coding Agent, écrite en TypeScript, dont l'objectif déclaré est de maintenir les sessions d'agents actives dans de vrais espaces de travail. Le README part du principe que le développement agentique fonctionne mieux lorsque l'environnement de travail est persistant. Le navigateur n'est que la surface de contrôle ; le travail lui-même reste sur une machine, pour que l'agent puisse continuer à fonctionner après la déconnexion du laptop qui l'a lancé. Le dépôt se présente comme un moyen d'exécuter les agents là où se trouvent le code, les outils, les identifiants et les caches de build, et de les superviser depuis n'importe quel navigateur.
Démarrage rapide et prérequis
Le README liste les prérequis pour un démarrage rapide : Node.js 22.19.0 ou plus récent, npm, Pi Coding Agent >=0.82.1 <0.83 configuré pour l'utilisateur, ainsi que git et les outils de développement dont les agents ont besoin. L'installation se fait sous forme de services par utilisateur : `npm install -g @jmfederico/pi-web --allow-scripts=node-pty`, puis `pi-web install` et `pi-web doctor`. Sous npm 12, le flag scopé permet à node-pty de préparer son module natif sans activer les scripts d'installation des autres dépendances. L'interface locale par défaut est `http://127.0.0.1:8504`. Le README liste aussi les commandes `status`, `logs`, `restart`, `doctor`, `version` et `uninstall`, et renvoie au guide d'installation pour l'installation en une ligne, l'installation par paquet Pi, l'utilisation WSL/manuelle et l'accès distant.
Le modèle central : machines, projets, espaces de travail, sessions
pi-web organise le travail autour de quatre niveaux. Une machine est un point de terminaison d'exécution pi-web local ou distant. Un projet est un dossier sur cette machine. Un espace de travail est un worktree git, ou le dossier du projet lui-même pour les projets non git. Une session est un chat Pi Coding Agent qui s'exécute dans un espace de travail. Le flux typique décrit dans le README est : ajouter un projet, choisir un espace de travail ou un worktree git, démarrer une session, laisser l'agent travailler, puis revenir plus tard depuis n'importe quel navigateur. Ce modèle sépare l'activité d'un agent de longue durée de toute connexion navigateur particulière.
Conception remote-first
Le README décrit pi-web comme conçu pour le développement distant piloté par l'IA. Plutôt que de lier le travail de l'agent à une session de laptop, pi-web est destiné à fonctionner sur une machine qui reste disponible : un serveur, un poste de travail, une VM cloud, une machine de home lab ou une boîte de développement distante. Pour l'accès distant, le README suggère un réseau privé, un tunnel SSH, un reverse proxy de confiance ou une configuration de machines pi-web fédérées. Le README ne décrit pas la mécanique précise de ces méthodes d'accès ; il renvoie à la documentation et à un guide remote-first.
Machines et support de flotte
pi-web peut enregistrer d'autres runtimes pi-web comme machines distantes. Une instance pi-web orientée navigateur peut servir de proxy pour les projets, fichiers, état git, sessions, terminaux, activité, gestion des paquets Pi et paramètres de machine sélectionnée provenant de machines distantes de confiance. Lorsqu'une machine distante est sélectionnée, les onglets des paramètres indiquent leur cible. Les paramètres affectant la machine, comme les paquets Pi, l'activation des plugins PI WEB, les interrupteurs du daemon de session, l'accès aux fichiers externes et les valeurs par défaut d'upload, ciblent la machine sélectionnée, tandis que les paramètres de passerelle/serveur tels que l'hôte, le port, les hôtes autorisés, les machines/tokens enregistrés et les raccourcis clavier restent locaux à la passerelle/navigateur.
Plugins et configuration
pi-web prend en charge des plugins côté navigateur de confiance qui peuvent ajouter des actions, des panneaux d'espace de travail et des métadonnées d'espace de travail. Le README indique Settings → PI WEB plugins pour les activer ou les désactiver sur la machine sélectionnée. Il distingue également les paquets Pi des plugins navigateur PI WEB : un paquet Pi peut inclure un plugin, mais installer le paquet et activer le plugin sont des opérations distinctes. La configuration se répartit entre une configuration globale sous `$PI_WEB_CONFIG` ou `~/.config/pi-web/config.json`, et une configuration locale au projet sous `<project>/.pi-web/config.json`. Les paramètres courants incluent l'hôte/le port, l'accès aux chemins, les uploads, l'activation des plugins, les raccourcis et les options du daemon de session, la configuration affectant la machine ciblant la machine sélectionnée.
Modèle de sécurité et notes de développement
Le README précise explicitement que pi-web suppose des utilisateurs de confiance, des dépôts de confiance et des chemins serveur de confiance. Ce n'est ni un bac à sable, ni un système de permissions, ni une plateforme multi-locataires, et il ne doit pas être exposé directement à l'Internet public sans réseau de confiance, pare-feu, VPN, tunnel SSH ou reverse proxy authentifié. Pour le développement, le README indique de cloner le dépôt et d'exécuter `npm install` et `npm run dev`, l'URL Vite étant généralement `http://localhost:8505`. Il existe aussi une configuration divisée avec `dev:sessiond`, `dev:web` et `dev:client`, et les modifications peuvent être validées avec `npm run verify`. Le projet est sous licence MIT, copyright Federico Jaramillo Martinez, 2026.
Conclusion éditoriale
pi-web place une surface de contrôle accessible par navigateur au-dessus de sessions d'agents qui restent actives dans de vrais espaces de travail. Le README précise que l'outil suppose des utilisateurs de confiance et n'est ni un bac à sable ni une plateforme multi-locataires.
Notes de la communauté