L'agent de code Pi expliqué : ce que c'est, comment il fonctionne et ce que Pi 1.0 a changé

Qu'est-ce que l'agent de code Pi ?

Pi se décrit en une ligne dans son README : "a minimal, extensible agent harness that you can make your own." Un harnais (harness) est le programme qui entoure un modèle de langage d'une boucle, d'outils et d'une interface, pour que le modèle puisse réellement lire des fichiers, exécuter des commandes et modifier du code. Claude Code, OpenAI Codex et OpenCode sont aussi des harnais, et ensemble ils forment la catégorie des CLI de code agentique. Ce qui distingue Pi, c'est le peu qu'il embarque et le nombre de choses qu'il vous laisse changer.

Les chiffres montrent qu'il a cessé d'être un outil de niche depuis un moment :

Une réserve sur ce nombre de téléchargements : les chiffres npm incluent les exécutions de CI et les applications qui intègrent le SDK de Pi, ce n'est donc pas un décompte de personnes. Reste que 5,2 millions par semaine placent Pi dans une autre catégorie que la plupart des agents open source, y compris le bien plus jeune DeepSeek Harness.

Pi est aussi plus grand que sa propre CLI. L'agent personnel OpenClaw, qui compte 391,521 étoiles à lui seul, est construit sur les composants de Pi. Armin Ronacher l'a dit clairement dans son article sur Pi : "what's under the hood of OpenClaw is a little coding agent called Pi."

Qui construit Pi, et pourquoi est-il passé chez Earendil ?

Pi a démarré comme projet parallèle de Mario Zechner, un développeur autrichien surtout connu pour le framework de jeu libGDX. Le déclencheur a été sa frustration envers Claude Code, devenu selon son article de conception un "spaceship with 80% of functionality I have no use for", avec des prompts et des outils qui changeaient à chaque version. Il a construit un harnais où rien n'est injecté dans votre dos, et lui a donné, selon ses mots, "a name that's entirely un-Google-able, so there will never be any users."

Ce plan n'a pas survécu à OpenClaw. Quand l'agent de Peter Steinberger est devenu viral et que les gens ont appris qu'il tournait sur Pi, Mario a écrit que "any VC or big corp you can think of in this space has knocked on my door." Il ne voulait pas bâtir une startup autour, alors il a choisi un foyer.

Earendil est une société à mission basée à Vienne, fondée en 2025 par Armin Ronacher (créateur de Flask, une dizaine d'années chez Sentry) et Colin Daymond Hanna. Parmi ses soutiens figurent Accel, Balderton et les fondateurs de n8n, OpenClaw, Revolut, Sentry et Slack. La promesse de licence figure dans le RFC d'Armin : "Pi remains MIT licensed and that will not change." Certaines futures fonctions à valeur ajoutée seront en source disponible et deviendront open source après un délai, et certaines fonctions entreprise seront propriétaires.

Tout le monde n'a pas aimé ce passage. Une réponse sur r/LocalLLaMA regrettait "the only decent harness that isn't sketchy af." Six mois plus tard, l'historique des commits répond mieux : Mario a toujours 3,849 commits sur le dépôt et Armin 849, et le cœur reste sous MIT.

Comment fonctionne l'agent de code Pi

Toute la conception tient sur une serviette. Un modèle, une boucle qui "just loops until the agent says it's done" et quatre outils.

Le raisonnement de Mario pour un cœur aussi petit est que les modèles de pointe savent déjà ce qu'est un agent de code. "There does not appear to be a need for 10,000 tokens of system prompt," a-t-il écrit, et "these four tools are all you need for an effective coding agent." Des assistants en lecture seule (grep, find, ls) existent mais sont désactivés par défaut. Les règles de votre projet viennent d'un fichier AGENTS.md (Pi lit aussi CLAUDE.md), un peu comme la configuration d'AGENTS.md dans Claude Code, et un SYSTEM.md peut remplacer entièrement le prompt par défaut.

Cette capture montre l'habitude dont les utilisateurs de Pi raffolent. Demandez à Pi de s'ajouter une fonction, et il lit sa propre documentation, écrit une extension dans son dossier de configuration, puis vous lancez /reload. Le pied de page affiche aussi le contexte utilisé et le coût en dollars à chaque tour, un détail qui change la façon de travailler.

Quelques autres mécanismes à connaître avant l'installation :

• Les sessions sont des arbres. Chaque message est stocké avec un ID de parent dans un fichier JSONL, donc /tree permet de revenir à n'importe quel point et de bifurquer, et /fork ou /clone démarrent une nouvelle session à partir de là. /share transforme une session en lien partageable.
• Orienter en cours d'exécution. Appuyez sur Enter pendant que Pi travaille pour envoyer un message d'orientation, ou sur Alt+Enter pour mettre en file un suivi à traiter une fois terminé.
• Compaction. Quand le contexte se remplit (par défaut, à 16,384 tokens de la limite), Pi résume les anciens messages et garde intacts les 20,000 derniers tokens. Earendil a détaillé le fonctionnement de la compaction si vous voulez les rouages.
• 30+ fournisseurs. Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama et d'autres, avec /model pour changer en pleine session. Le catalogue de modèles de Pi liste 1,541 modèles chez 41 fournisseurs.

Ce que Pi laisse de côté volontairement

C'est la partie qui déroute la plupart des nouveaux utilisateurs, la voici donc en un seul tableau. Chacune est un choix délibéré et chacune a une solution de contournement documentée.

L'argument de Mario pour les laisser de côté porte sur la visibilité. À propos des sous-agents, dans son article de conception : "You have zero visibility into what that sub-agent does. It's a black box within a black box." Pour le mode plan, il préfère un fichier PLAN.md que vous pouvez lire, modifier et committer. Si vous avez utilisé les sous-agents de Claude Code et les avez aimés, vous voudrez le paquet, et c'est très bien. L'argument de Pi, c'est que vous choisissez.

La communauté a comblé chaque emplacement. Le catalogue de paquets affiche 5,553 paquets listés, et plusieurs des plus téléchargés correspondent directement au tableau ci-dessus :

Les extensions elles-mêmes sont de simples fichiers TypeScript qui peuvent enregistrer des outils, des commandes slash, des raccourcis clavier, des fournisseurs de modèles et une interface de terminal complète. L'extension de revue d'Armin montre bien jusqu'où cela va :

La contrepartie est que vous devenez le mainteneur de votre propre configuration. Un utilisateur de longue date de Pi sur Hacker News l'a dit honnêtement : "Pi's plugins are its strength, but also its weakness, because most feel more like personal vibe-coding projects than seriously maintained tools." La documentation dit la même chose plus sobrement : les paquets peuvent exécuter du code, donc "review third-party package source before installing it."

Pi 1.0 : l'agent « sans MCP » a maintenant MCP

Pendant la majeure partie de sa vie, pi.dev affichait fièrement que Pi ne prendrait jamais en charge MCP, le protocole qui permet à un agent de se brancher sur un serveur MCP externe. L'argument de Mario portait sur le coût en contexte. Il a mesuré le serveur MCP de Playwright à 21 outils et 13.7k tokens, et Chrome DevTools MCP à 26 outils et 18k tokens, ce qu'il a appelé "7-9% of your context window gone before you even start working."

Le 29 septembre 2026, Earendil est revenu dessus dans un article intitulé « You Said No MCP! » Leur raisonnement : "the MCP of today is not the MCP of yesteryear," et les changements dont MCP avait besoin étaient "generally useful." Deux jours plus tard, Pi 1.0 sortait avec MCP comme fonction phare. La page d'accueil indique désormais "No MCP Now with MCP+Codemode."

L'astuce qui tient la promesse sur les tokens, c'est Codemode. Au lieu de donner au modèle le schéma de chaque outil MCP, Pi lui donne un seul outil qui exécute de courts scripts JavaScript dans un bac à sable QuickJS sans système de fichiers, réseau ni minuteurs propres.

La documentation de Codemode le dit simplement : "Only the script's output reaches the model, so a script can run calls in parallel and filter large results before the model sees them." Le changelog de Pi 1.0 affirme que Codemode utilise désormais environ 40 % de tokens de prompt en moins, une requête GPT-5.6 passant d'environ 5,300 à 3,300 tokens. Chaque serveur MCP reçoit un réglage d'exposition :

• codemode (par défaut) : les outils ne sont appelables que depuis des scripts Codemode.
• deferred : les outils ne sont déclarés qu'après qu'un tool_search les a trouvés.
• direct : les outils se chargent comme les outils intégrés, comme le font la plupart des harnais.
• hidden : enregistrés mais inaccessibles, pratique pour les outils de type delete_*.

La configuration se trouve dans ~/.pi/agent/mcp.json ou dans le .pi/mcp.json d'un projet, au même format mcpServers que Claude Desktop et Cursor, vous pouvez donc coller des entrées existantes. Si vous venez des outils MCP de Claude Code, le principal changement mental est que le modèle écrit du code pour appeler les outils plutôt que de les appeler un par un.

Était-ce une trahison envers les minimalistes ? La réponse de Mario sur Hacker News : "All of these features are still entirely optional and the only thing I could think of that could be considered "bloat" is the additional few megabytes for the QuickJS WASM blob." L'explication d'Armin était plus pragmatique :

"we look at what the models are doing. They are trained on their respective harnesses and we're not here to fight their behavior."

the_mitsuhiko, Hacker News

Pi 1.0 a aussi ajouté le chargement différé des outils, le préchauffage du cache pour les modèles Anthropic, la prise en charge dans les extensions de « modèles virtuels » (une démo planifie avec Claude Opus et implémente avec GPT), et fait du mode plein écran le mode par défaut. Le fil Pi 1.0 a atteint 1,686 points sur Hacker News, environ trois fois plus que toute discussion précédente sur Pi.

Quatre façons de l'exécuter

Pi n'est pas qu'une fenêtre de discussion dans votre terminal. Le même agent et le même moteur de sessions fonctionnent en quatre modes :

Le SDK est la façon dont OpenClaw et d'autres produits se construisent sur Pi, et c'est la même idée que le SDK de Claude Code pour des agents de code personnalisés. Le mode print est la vedette discrète : c'est ainsi que les utilisateurs de Pi simulent des sous-agents (Pi appelle pi --print via bash) et branchent Pi dans une automatisation à la Claude Code.

Le 1er octobre, Earendil a aussi lancé Pi Durable, une bibliothèque expérimentale sous licence MIT pour "long-running, durable, and malleable agents that can run anywhere." Elle enregistre un point de reprise à chaque étape pour qu'une exécution survive à un plantage, permet à plusieurs personnes de se connecter à une même conversation et stocke l'état de l'application, comme des tickets ou des plans, à côté de la transcription. Elle "does not replace the Pi coding agent", et ce n'est pas un produit hébergé. Son exemple de crochet d'approbation demande dans Slack avant l'exécution d'un outil deploy, et Earendil dit qu'un bot Slack et un bot de tri GitHub construits dessus arrivent. Gardez cela en tête pour la section support ci-dessous.

L'agent de code Pi est-il sûr ?

Voici la ligne de la documentation de sécurité de Pi, que je relirais deux fois : Pi "can read, change, and execute files with the permissions of the account that started it, and it does not ask for approval before every tool call."

C'est le célèbre mode YOLO par défaut, et c'est une position, pas un oubli. Mario a qualifié les garde-fous des autres agents de "mostly security theater" dans son article de conception, soutenant qu'une fois qu'un agent peut écrire et exécuter du code, une boîte de confirmation ne sert pas à grand-chose. La documentation est d'accord et ajoute que "watching the transcript, using project trust, and reviewing changes do not create a security boundary." Sa recommandation est d'exécuter Pi dans un conteneur, une VM ou un bac à sable, et elle documente des recettes pour Docker, Docker Sandboxes, NVIDIA OpenShell et la micro-VM Gondolin.

Les nouveaux utilisateurs sont quand même surpris :

"I love Pi, but minimal mean minimal. I realized it when it rm -f /tmp/somefile.log without asking for permission."

u/mantafloppy, Reddit r/LocalLLaMA

Et la solution bricolée a des failles. Un autre commentateur du même fil a signalé que l'extension de permission d'exemple "blocks rm -rf, but not rm -fr which does the exact same thing" (u/GalladeGuyGBA). C'est la vérité honnête sur les garde-fous par motifs, et c'est exactement pourquoi la documentation de Pi vous pousse vers un vrai bac à sable.

Trois autres réglages par défaut à connaître :

1. Confiance du projet. La configuration au niveau du projet (.pi/settings.json, .pi/mcp.json, extensions et skills du projet) ne se charge qu'après votre approbation du dossier. AGENTS.md et CLAUDE.md se chargent dans tous les cas.
2. Télémétrie. Le signalement anonyme des installations et mises à jour est activé par défaut (enableInstallTelemetry: true) ; désactivez-le avec PI_TELEMETRY=0. Les analyses sont sur option. --offline arrête les appels réseau automatiques.
3. Chaîne d'approvisionnement. Pi s'installe via npm, comme ses paquets. Un utilisateur Reddit a dit que sa VM de travail avait été compromise quand une dépendance transitive a été détournée pendant une fenêtre de mise à jour npm i -g d'environ 30 minutes. Le README recommande désormais l'installateur épinglé pi.dev/install.sh, qui épingle toutes les dépendances.

Mon avis : exécutez Pi dans un conteneur pour tout ce qui est sans surveillance, installez les paquets comme vous installeriez n'importe quel code npm, et mettez vos attentes de demandes de permission à zéro. Si votre équipe a besoin de confirmations par défaut, le modèle de permissions de Claude Code paraîtra plus sûr d'emblée.

Combien coûte l'agent de code Pi ?

Pi lui-même est gratuit. Il n'y a ni prix par siège, ni offre payante, ni page de tarifs, car le harnais sous licence MIT est tout le produit. Ce que vous payez, c'est le modèle derrière, et Pi offre trois façons d'en apporter un.

Deux bémols. D'abord, le changelog de Pi indique que Pi avertit que "Anthropic third-party usage draws from extra usage and is billed per token" quand vous vous connectez avec un abonnement Claude, donc ne supposez pas que votre offre Max couvre Pi comme elle couvre Claude Code. Mon guide des tarifs de Claude Code explique comment ces offres mesurent l'usage. Ensuite, les connexions Gemini CLI et Antigravity de Google ont été supprimées dans la version 0.71.0 (30 avril 2026), donc Gemini nécessite désormais une clé d'API ou Vertex AI.

Là où Pi fait ses preuves, c'est sur l'efficacité en tokens. Comme le prompt système est si petit, le cache de prompt fonctionne bien et chaque tour envoie moins. Un benchmark Databricks sur une base de code de plusieurs millions de lignes, relaté par Earendil, a conclu que "simple harnesses like Pi performed best" sur ses charges de travail, Pi envoyant environ trois fois moins de contexte par tour.

Prenez cela comme une donnée proche du fournisseur, pas comme parole d'évangile ; Earendil cite une étude qui avantage son produit. Mais des utilisateurs individuels rapportent la même tendance. Un commentateur de Hacker News a fait des tests de tokens et trouvé que "both pi and my own 3code used 4x fewer tokens than Claude Code, while opencode used 2x fewer tokens than Claude Code." Un autre a dit que des sessions entières de profilage et de refactorisation se terminent "in <20k tokens." Sur l'ancien classement Terminal-Bench 2.0 (décembre 2025), Pi avec Claude Opus 4.5 s'est classé #7 à 49.8%, devant Claude Code avec Sonnet 4.5 à #18 et 40.1%.

Ce que disent les développeurs de Pi

Les éloges sont constants d'une plateforme à l'autre : un petit prompt, une faible consommation de tokens, de la transparence et un agent qu'on peut plier à sa guise. Le plus fort soutien individuel vient de X :

"Pi is the best agent harness and more importantly framework we have right now. The stats are stunning: - highest cache hit rate - lowest latency - highest performance - smallest bundle - cleanest code - cheapest cache + tiny system prompt over months adds up. Try it"

0xSero, X

Les utilisateurs de modèles locaux l'apprécient pour une raison facile à manquer. Un énorme prompt système met des minutes à être préchargé sur un portable, celui de Pi non :

"Love pi. I tried to run some local models and pi was the only one that actually worked decently because it didn't have a gargantuan system prompt that would take minutes to prefill on my scrawny ass laptop."

FacelessJim, Hacker News

D'autres adorent qu'il reste en retrait pendant que les éditeurs changent sans cesse leurs outils :

"The result is that the tool gradually morphs into the thing I need rather than me having to adapt myself to whatever new thing Anthropic or OpenAI comes up with."

unknownfuture, Hacker News

Les critiques sont tout aussi constantes, et justifiées. La plainte la plus courante est que « tout est un plugin » signifie faire un travail de configuration que d'autres agents font pour vous :

"Need to set the reasoning effort? Install pi-reasoning. Need subagents? Install pi-subagents. Need permission gating? Install one of the permission extensions (otherwise the agent can do everything)."

mixermachine, Hacker News

Le meilleur résumé en une ligne que j'ai trouvé vient d'un fil comparant Pi à OpenCode : "Pi vs opencode for example is like gentoo vs macos." Sur Reddit, le conseil aux nouveaux venus est de résister à l'envie de tout installer dès le premier jour. Comme l'a dit un utilisateur de r/PiCodingAgent : "Pi actually works pretty well out of the box." Ceux qui veulent tout inclus sont en général orientés vers le fork oh-my-pi ou vers OpenCode.

Agent de code Pi vs Claude Code

Comme la plupart des gens arrivent à Pi depuis Claude Code, voici la comparaison côte à côte sur ce qui change vraiment votre quotidien.

Mon avis : si vous utilisez surtout des modèles Claude et voulez des garde-fous, un ensemble de fonctions stable et un seul éditeur à qui s'en prendre, restez sur Claude Code. Si vous changez souvent de modèle, vous vous souciez des tokens, vous exécutez des modèles locaux ou vous voulez maîtriser chaque ligne que voit l'agent, Pi est l'outil le plus intéressant, et sa version 1.0 l'a rendu bien plus facile à adopter. Pour un panorama plus large incluant Cursor et GitHub Copilot, mon tour d'horizon des assistants de code IA est le meilleur point de départ.

Faut-il construire un agent de support sur Pi ?

C'est une idée raisonnable. Pi a un SDK, un mode RPC et maintenant Pi Durable, dont les propres exemples parlent de bots Slack, de crochets d'approbation et de bots de tri. Les modèles sont moins chers que jamais. Pourquoi ne pas brancher Pi sur votre helpdesk et appeler cela un agent de support ?

Parce que le harnais est la plus petite partie du travail. Voici la répartition telle que je la vois :

Un agent de support a besoin d'une connexion bidirectionnelle à votre helpdesk (lire le ticket, l'étiqueter, répondre, escalader), d'un moyen de garder synchronisés votre centre d'aide, vos macros et vos anciens tickets au fil de leurs changements, de règles sur ce qu'il peut faire sans humain, et d'un moyen de le tester sur de vrais anciens tickets avant qu'il parle à un client. Cette dernière étape est celle que je ne sauterais jamais. eesel l'a appris à la dure, en regardant un bot au ton assuré donner de mauvaises réponses pendant des jours avant que quiconque s'en aperçoive, et c'est pourquoi chaque déploiement eesel est désormais d'abord simulé sur des tickets historiques.

Je vois aussi l'attrait du « construire soi-même » de l'autre côté. Plusieurs clients d'eesel, dont une entreprise de réalité augmentée et de technologie du bâtiment et une marque de beauté DTC, sont partis construire directement sur l'API Claude. Et les équipes qui restent disent souvent la même chose. Un responsable ingénierie chez GENERAL BYTES, le fabricant de distributeurs de Bitcoin, a expliqué pourquoi ils ont choisi d'acheter plutôt que de construire :

"We could try to write our own LLM application but we didn't want to invest our time into that. We wanted something that we would not have to maintain."

Ma réponse : construisez sur Pi si votre équipe aime maîtriser toute la pile et a le temps de suivre un projet qui publie des versions correctives presque chaque jour. Si l'objectif est d'obtenir des tickets traités plutôt qu'un framework à maintenir, embauchez le coéquipier et laissez Pi faire ce qu'il fait très bien, c'est-à-dire écrire du code.

Essayer eesel

Pi est le harnais ; eesel est l'employé. eesel est une plateforme de coéquipiers IA où vous embauchez des coéquipiers prêts à travailler sur des tâches précises. Pour le support, c'est le coéquipier IA helpdesk : il se branche en quelques minutes sur Zendesk, Freshdesk, Gorgias et Slack, apprend de vos anciens tickets et de votre centre d'aide, et vous pouvez le simuler sur votre propre historique de tickets avant qu'il réponde à un seul client. Si vous avez besoin de contenu plutôt que de tickets, la même plateforme propose un coéquipier rédacteur de blog IA.

Le point qui plaira aux utilisateurs de Pi : vous n'avez pas à quitter le terminal. La CLI d'eesel pilote le même coéquipier et le même espace de travail que le tableau de bord, "another way in, not a separate copy." npx @eesel/cli init configure un agent sans compte, eesel integrations connect zendesk branche votre helpdesk (une personne l'approuve dans Zendesk), eesel instructions modifie les règles permanentes de l'agent en texte brut, eesel approvals list affiche les actions en attente d'un humain et eesel activity vous laisse lire chaque exécution. Chaque commande affiche du JSON et accepte --dry-run, et les erreurs reviennent avec un champ hint, exactement ce dont un agent de code a besoin pour piloter un outil seul.

La documentation d'eesel cite Claude Code, Cursor et Codex, mais rien n'empêche Pi de faire le même travail : il peut exécuter la CLI via son outil bash, ou se connecter au serveur MCP que chaque espace de travail eesel expose (eesel mcp token affiche l'URL et un jeton de 30 jours), maintenant que Pi 1.0 parle MCP. Les configurations sans interface utilisent EESEL_API_URL, EESEL_API_TOKEN et EESEL_AGENT_ID. Mes guides sur une CLI d'agent IA et une CLI pour le support client vont plus loin.

Vous pouvez commencer avec l'offre gratuite de 100 crédits, sans carte. Les offres payantes de coéquipiers démarrent à $299 par mois pour 500 crédits, et un ticket ou une discussion vaut un crédit quelle que soit sa durée. Les commandes de configuration et d'observation de la CLI sont gratuites ; seule la discussion est facturée. C'est le chemin le plus court si vous voulez des tickets résolus, et vous pouvez toujours laisser Pi faire la saisie.