Qu'est-ce que Pi (pi.dev) ?

Pi : un agent CLI minimaliste

Pi (pi.dev) est un agent de coding en ligne de commande, open-source (licence MIT), créé par Mario Zechner. Comme Claude Code, c’est un agent complet : il comprend du code, agit sur les fichiers, et boucle. Mais sa philosophie est radicalement différente.

Point clé : Pi mise sur le minimalisme : un coeur petit, tout le reste en extensions. Claude Code mise sur l’intégration : tout est embarqué dès le départ.

Les 4 outils core

Pi ne donne au modèle que 4 outils :

• read — lire un fichier
• write — écrire un fichier
• edit — modifier un fichier
• bash — exécuter une commande shell

Pas de Glob, pas de Grep, pas de WebFetch intégrés. Si l’agent veut chercher dans la codebase, il passe par bash avec grep, find ou rg.

---

System prompt et fenêtre de contexte

Le system prompt de Pi fait environ 200 tokens. Celui de Claude Code en fait ~10 000.

Aspect	Pi	Claude Code
System prompt	~200 tokens	~10 000 tokens
Outils intégrés	4	15+
Contexte libre pour le code	Plus large	Plus réduit
Gestion des cas limites	Dépend du modèle	Guidée par le prompt

Point clé : Un system prompt court = plus de fenêtre de contexte disponible pour le code du projet. C’est le trade-off central de Pi.

---

Multi-modèles

Pi supporte tous les fournisseurs de LLM : Anthropic (Claude), OpenAI (GPT-4, o1), Google (Gemini), xAI (Grok), Groq, et même des modèles locaux via Ollama.

Claude Code est limité aux modèles Anthropic.

Dans le Core Four, c’est le levier Model (LP2) en action : choisir le modèle optimal pour chaque tâche. Un modèle rapide et peu coûteux pour du scripting, un modèle puissant pour du refactoring complexe.

---

Extensibilité

Tout ce que Claude Code intègre en dur, Pi le propose via des extensions :

• Extensions — packages npm ou git qui ajoutent des outils, hooks, commandes.
• Skills — fichiers Markdown pour encapsuler des workflows récurrents.
• Prompt templates — templates réutilisables pour des tâches récurrentes.
• Sessions en arbre — branching et navigation entre sessions (linéaire chez Claude Code).

Attention : Pi n’a pas de sub-agents, de plan mode, de MCP natif, ni de système de permissions intégré. Tout cela peut être ajouté via des extensions, mais n’est pas là par défaut.

Ce que Pi a en plus

Fonctionnalité	Pi	Claude Code
Open-source (MIT)	Oui	Non
Multi-modèles	Tous fournisseurs	Anthropic uniquement
Sessions en arbre	Oui (branching)	Linéaire
Extensions npm/git	Oui	Plugins (marketplace)
Core minimal	~200 tokens, 4 outils	~10 000 tokens, 15+ outils

---

Modes d’exécution

Pi offre 4 modes :

• Interactive — session conversationnelle dans le terminal.
• Print / JSON — mode one-shot pour le scripting et la CI.
• RPC — mode serveur pour l’intégration programmatique.
• SDK — bibliothèque TypeScript pour construire des agents custom par-dessus Pi.

---

Quand préférer Pi ou Claude Code

Situation	Préférer	Pourquoi
Projet .NET avec CLAUDE.md bien rodé	Claude Code	Écosystème intégré (hooks, permissions, MCP)
Expérimentation multi-modèles	Pi	Switch de modèle trivial
Agent custom / intégration CI	Pi (SDK) ou Claude Code (-p)	Pi offre plus de contrôle via RPC/SDK
Codebase avec beaucoup de conventions	Claude Code	System prompt riche + CLAUDE.md
Minimalisme, contrôle total	Pi	Core minimal, tout extensible
Besoin de sub-agents / orchestration	Claude Code	Task tool natif

La règle pragmatique : ce n’est pas l’outil qui compte, c’est l’empilement des leverage points. Un Pi bien configuré (extensions + skills + tests) peut être aussi efficace qu’un Claude Code bien configuré (CLAUDE.md + hooks + MCP).

---