Pi Coding Agent erklärt: Was er ist, wie er funktioniert und was Pi 1.0 verändert hat

Was ist der Pi Coding Agent?

Pi beschreibt sich in einem Satz in seiner README: "a minimal, extensible agent harness that you can make your own." Ein Harness ist das Programm, das ein Sprachmodell mit einem Loop, Tools und einer Benutzeroberfläche umgibt, damit das Modell tatsächlich Dateien lesen, Befehle ausführen und Code bearbeiten kann. Claude Code, OpenAI Codex und OpenCode sind ebenfalls Harnesses, und zusammen bilden sie die Kategorie der agentischen Coding-CLIs. Pis Besonderheit ist, wie wenig es mitbringt und wie viel Sie ändern können.

Die Zahlen zeigen, dass es schon lange kein Nischen-Tool mehr ist:

Ein Vorbehalt zur Download-Zahl: npm-Zahlen enthalten CI-Läufe und Apps, die Pis SDK einbetten, sind also keine Personenzählung. Dennoch spielt Pi mit 5,2 Millionen pro Woche in einer anderen Liga als die meisten Open-Source-Agenten, einschließlich des deutlich jüngeren DeepSeek Harness.

Pi ist außerdem größer als seine eigene CLI. Der persönliche Agent OpenClaw, der selbst 391,521 Sterne hat, basiert auf Pis Komponenten. Armin Ronacher sagte es in seinem Pi-Beitrag deutlich: "what's under the hood of OpenClaw is a little coding agent called Pi."

Wer baut Pi, und warum ging es zu Earendil?

Pi begann als Nebenprojekt von Mario Zechner, einem österreichischen Entwickler, der vor allem für das Spiele-Framework libGDX bekannt ist. Auslöser war seine Frustration mit Claude Code, das laut seinem Design-Beitrag zu einem "spaceship with 80% of functionality I have no use for" geworden war, mit Prompts und Tools, die sich bei jedem Release änderten. Er baute ein Harness, in dem nichts hinter Ihrem Rücken eingeschleust wird, und gab ihm, in seinen Worten, "a name that's entirely un-Google-able, so there will never be any users."

Dieser Plan überlebte OpenClaw nicht. Als Peter Steinbergers Agent viral ging und die Leute erfuhren, dass er auf Pi läuft, schrieb Mario, "any VC or big corp you can think of in this space has knocked on my door." Er wollte kein Startup darum bauen und suchte stattdessen ein Zuhause.

Earendil ist eine in Wien ansässige Public Benefit Corporation, 2025 gegründet von Armin Ronacher (Schöpfer von Flask, etwa zehn Jahre bei Sentry) und Colin Daymond Hanna. Zu den Geldgebern zählen Accel, Balderton und die Gründer von n8n, OpenClaw, Revolut, Sentry und Slack. Das Lizenzversprechen steht in Armins RFC: "Pi remains MIT licensed and that will not change." Einige künftige Mehrwert-Funktionen werden Source-Available sein und nach einer Frist Open Source werden, einige Enterprise-Funktionen proprietär.

Nicht jeder mochte den Wechsel. Eine Antwort auf r/LocalLLaMA trauerte um "the only decent harness that isn't sketchy af." Sechs Monate später ist das Commit-Log die bessere Antwort: Mario hat weiterhin 3,849 Commits im Repo und Armin 849, und der Kern steht noch unter MIT.

Wie der Pi Coding Agent funktioniert

Das ganze Design passt auf eine Serviette. Ein Modell, ein Loop, der "just loops until the agent says it's done", und vier Tools.

Marios Begründung für den winzigen Kern ist, dass Frontier-Modelle bereits wissen, was ein Coding-Agent ist. "There does not appear to be a need for 10,000 tokens of system prompt," schrieb er, und "these four tools are all you need for an effective coding agent." Read-only-Helfer (grep, find, ls) gibt es, sie sind aber standardmäßig aus. Ihre Projektregeln kommen aus einer AGENTS.md-Datei (Pi liest auch CLAUDE.md), ähnlich wie beim Claude-Code-AGENTS.md-Setup, und eine SYSTEM.md kann den Standard-Prompt komplett ersetzen.

Dieser Screenshot zeigt die Gewohnheit, von der Pi-Nutzer schwärmen. Bitten Sie Pi, sich selbst eine Funktion hinzuzufügen, und es liest die eigenen Docs, schreibt eine Erweiterung in seinen Konfigurationsordner, und Sie führen /reload aus. Die Fußzeile zeigt außerdem bei jedem Zug den genutzten Kontext und die Kosten in Dollar, eine Kleinigkeit, die die Arbeitsweise verändert.

Ein paar weitere Mechaniken, die Sie vor der Installation kennen sollten:

• Sessions sind Bäume. Jede Nachricht wird mit einer Eltern-ID in einer JSONL-Datei gespeichert, sodass Sie mit /tree zu jedem Punkt springen und verzweigen können, und /fork oder /clone starten von dort eine neue Session. /share macht aus einer Session einen teilbaren Link.
• Steuern während des Laufs. Drücken Sie Enter, während Pi arbeitet, um eine Steuerungsnachricht zu senden, oder Alt+Enter, um eine Folgenachricht für das Ende einzureihen.
• Kompaktierung. Wenn der Kontext voll wird (standardmäßig innerhalb von 16,384 Tokens des Limits), fasst Pi ältere Nachrichten zusammen und behält die letzten 20,000 Tokens unangetastet. Earendil hat aufgeschrieben, wie die Kompaktierung funktioniert, falls Sie die Interna wollen.
• 30+ Anbieter. Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama und mehr, mit /model zum Wechseln mitten in der Session. Pis Modellkatalog listet 1,541 Modelle von 41 Anbietern.

Was Pi absichtlich weglässt

Das ist der Teil, über den die meisten Neulinge stolpern, deshalb hier alles in einer Tabelle. Jedes davon ist eine bewusste Entscheidung, und jedes hat einen dokumentierten Workaround.

Marios Argument für das Weglassen betrifft die Sichtbarkeit. Zu Subagenten, aus seinem Design-Beitrag: "You have zero visibility into what that sub-agent does. It's a black box within a black box." Beim Plan-Modus hätte er lieber eine PLAN.md-Datei, die Sie lesen, bearbeiten und committen können. Wenn Sie Claude-Code-Subagenten genutzt und gemocht haben, werden Sie das Paket wollen, und das ist in Ordnung. Pis Versprechen ist, dass Sie wählen.

Die Community hat jeden Slot gefüllt. Der Paketkatalog zeigt 5,553 gelistete Pakete, und mehrere der meistgeladenen passen direkt zur Tabelle oben:

Erweiterungen selbst sind einfache TypeScript-Dateien, die Tools, Slash-Befehle, Tastenkürzel, Modellanbieter und eine komplette Terminal-Oberfläche registrieren können. Armins eigene Review-Erweiterung zeigt gut, wie weit das geht:

Der Preis dafür ist, dass Sie zum Maintainer Ihres eigenen Setups werden. Ein langjähriger Pi-Nutzer auf Hacker News formulierte es fair: "Pi's plugins are its strength, but also its weakness, because most feel more like personal vibe-coding projects than seriously maintained tools." Die Docs sagen dasselbe nüchterner: Pakete können Code ausführen, also "review third-party package source before installing it."

Pi 1.0: Der „No MCP"-Agent hat jetzt MCP

Den größten Teil seines Lebens trug pi.dev einen stolzen Satz, dass Pi MCP nie unterstützen werde, das Protokoll, mit dem ein Agent an einen externen MCP-Server andockt. Marios Argument waren die Kontextkosten. Er maß den Playwright-MCP-Server mit 21 Tools und 13.7k Tokens und Chrome DevTools MCP mit 26 Tools und 18k Tokens, was er "7-9% of your context window gone before you even start working" nannte.

Am 29. September 2026 kehrte Earendil das in einem Beitrag mit dem Titel „You Said No MCP!" um. Ihre Begründung: "the MCP of today is not the MCP of yesteryear," und die Änderungen, die MCP brauchte, seien "generally useful" gewesen. Zwei Tage später erschien Pi 1.0 mit MCP als Hauptmerkmal. Die Startseite lautet jetzt "No MCP Now with MCP+Codemode."

Der Trick, der das Token-Versprechen hält, ist Codemode. Statt dem Modell das Schema jedes MCP-Tools zu geben, gibt Pi ihm ein einziges Tool, das kurze JavaScript-Skripte in einer QuickJS-Sandbox ausführt, die selbst weder Dateisystem noch Netzwerk noch Timer hat.

Die Codemode-Docs sagen es einfach: "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." Pi 1.0s Changelog behauptet, Codemode brauche jetzt etwa 40 % weniger Prompt-Tokens, wobei eine GPT-5.6-Anfrage von etwa 5,300 auf 3,300 Tokens fiel. Jeder MCP-Server bekommt eine Einstellung für die Sichtbarkeit:

• codemode (Standard): Tools sind nur aus Codemode-Skripten aufrufbar.
• deferred: Tools werden erst deklariert, nachdem ein tool_search sie gefunden hat.
• direct: Tools werden wie eingebaute Tools geladen, so wie es die meisten Harnesses machen.
• hidden: registriert, aber nicht erreichbar, praktisch für Tools im Stil von delete_*.

Die Konfiguration liegt in ~/.pi/agent/mcp.json oder in der .pi/mcp.json eines Projekts, im selben mcpServers-Format wie bei Claude Desktop und Cursor, sodass Sie bestehende Einträge einfügen können. Wenn Sie von Claude Codes MCP-Tools kommen, ist die größte Umstellung im Kopf, dass das Modell Code schreibt, um Tools aufzurufen, statt sie einzeln aufzurufen.

War das ein Verrat an den Minimalisten? Marios Antwort auf 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." Armins Erklärung war pragmatischer:

"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 brachte außerdem verzögertes Tool-Laden, Cache-Warming für Anthropic-Modelle, Erweiterungsunterstützung für „virtuelle Modelle" (eine Demo plant mit Claude Opus und setzt mit GPT um) und machte den Vollbildmodus zum Standard. Der Pi-1.0-Thread erreichte 1,686 Punkte auf Hacker News, etwa dreimal so viel wie jede frühere Pi-Diskussion.

Vier Wege, es zu betreiben

Pi ist nicht nur ein Chatfenster im Terminal. Derselbe Agent und dieselbe Session-Engine laufen in vier Modi:

Das SDK ist der Weg, auf dem OpenClaw und andere Produkte auf Pi aufbauen, und es ist dieselbe Idee wie das Claude Code SDK für eigene Coding-Agenten. Der Print-Modus ist der stille Star: So täuschen Pi-Nutzer Subagenten vor (Pi ruft pi --print über bash auf) und binden Pi in Automatisierung im Claude-Code-Stil ein.

Am 1. Oktober veröffentlichte Earendil außerdem Pi Durable, eine experimentelle, MIT-lizenzierte Bibliothek für "long-running, durable, and malleable agents that can run anywhere." Sie legt jeden Schritt als Checkpoint ab, sodass ein Lauf einen Absturz übersteht, lässt viele Personen an einer Unterhaltung teilnehmen und speichert App-Zustand wie Tickets oder Pläne neben dem Transkript. Sie "does not replace the Pi coding agent", und es ist kein gehostetes Produkt. Ihr Beispiel-Freigabe-Hook fragt in Slack nach, bevor ein deploy-Tool läuft, und Earendil sagt, ein Slack-Bot und ein GitHub-Triage-Bot darauf seien in Arbeit. Merken Sie sich das für den Support-Abschnitt unten.

Ist der Pi Coding Agent sicher?

Hier die Zeile aus Pis eigenen Sicherheits-Docs, die ich zweimal lesen würde: 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."

Das ist der berühmte YOLO-Standard, und er ist eine Haltung, kein Versehen. Mario nannte die Leitplanken anderer Agenten in seinem Design-Beitrag "mostly security theater" und argumentierte, dass ein Bestätigungsdialog wenig bringt, sobald ein Agent Code schreiben und ausführen kann. Die Docs stimmen zu und fügen hinzu: "watching the transcript, using project trust, and reviewing changes do not create a security boundary." Ihre Empfehlung ist, Pi in einem Container, einer VM oder einer Sandbox auszuführen, und sie dokumentieren Rezepte für Docker, Docker Sandboxes, NVIDIA OpenShell und die Gondolin-Micro-VM.

Neue Nutzer werden trotzdem überrascht:

"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

Und die Do-it-yourself-Lösung hat Lücken. Ein anderer Kommentator im selben Thread wies darauf hin, dass die Beispiel-Berechtigungserweiterung "blocks rm -rf, but not rm -fr which does the exact same thing" (u/GalladeGuyGBA). Das ist die ehrliche Wahrheit über Leitplanken per Mustererkennung, und genau deshalb schiebt Pis Dokumentation Sie in Richtung einer echten Sandbox.

Drei weitere Standards, die Sie kennen sollten:

1. Projektvertrauen. Konfiguration auf Projektebene (.pi/settings.json, .pi/mcp.json, Projekt-Erweiterungen und -Skills) wird erst geladen, nachdem Sie den Ordner freigegeben haben. AGENTS.md und CLAUDE.md werden immer geladen.
2. Telemetrie. Anonyme Installations- und Update-Meldungen sind standardmäßig an (enableInstallTelemetry: true); abschalten mit PI_TELEMETRY=0. Analytics sind Opt-in. --offline stoppt automatische Netzwerkaufrufe.
3. Lieferkette. Pi wird über npm installiert, und seine Pakete ebenso. Ein Reddit-Nutzer sagte, seine Arbeits-VM sei kompromittiert worden, als eine transitive Abhängigkeit während eines npm i -g-Update-Fensters von etwa 30 Minuten gekapert wurde. Die README empfiehlt jetzt den gepinnten Installer pi.dev/install.sh, der alle Abhängigkeiten festnagelt.

Meine Einschätzung: Führen Sie Pi für alles Unbeaufsichtigte in einem Container aus, installieren Sie Pakete so, wie Sie jeden npm-Code installieren würden, und setzen Sie Ihre Erwartung an Berechtigungsabfragen auf null. Wenn Ihr Team standardmäßig Freigabeabfragen braucht, fühlt sich das Berechtigungsmodell von Claude Code von Haus aus sicherer an.

Was kostet der Pi Coding Agent?

Pi selbst ist kostenlos. Es gibt keinen Preis pro Platz, keinen kostenpflichtigen Tarif und keine Preisseite, denn das MIT-lizenzierte Harness ist das ganze Produkt. Bezahlt wird das Modell dahinter, und Pi bietet drei Wege, eines anzubinden.

Zwei Haken. Erstens sagt das Pi-Changelog, dass Pi bei einem Login mit Claude-Abo warnt: "Anthropic third-party usage draws from extra usage and is billed per token". Gehen Sie also nicht davon aus, dass Ihr Max-Tarif Pi so abdeckt wie Claude Code. Mein Leitfaden zu den Claude-Code-Preisen erklärt, wie diese Tarife messen. Zweitens wurden die Logins für Googles Gemini CLI und Antigravity in Version 0.71.0 (30. April 2026) entfernt, Gemini braucht jetzt einen API-Schlüssel oder Vertex AI.

Seinen Wert zeigt Pi bei der Token-Effizienz. Weil der System-Prompt so klein ist, funktioniert Prompt-Caching gut und jeder Zug sendet weniger. Ein Databricks-Benchmark auf einer Codebasis mit mehreren Millionen Zeilen, von Earendil aufgeschrieben, kam zu dem Ergebnis, dass "simple harnesses like Pi performed best" bei seinen Workloads, wobei Pi pro Zug etwa dreimal weniger Kontext sendete.

Betrachten Sie das als herstellernahen Datenpunkt, nicht als Evangelium; Earendil zitiert eine Studie, die sein Produkt begünstigt. Aber einzelne Nutzer berichten dasselbe. Ein Hacker-News-Kommentator machte Token-Tests und fand "both pi and my own 3code used 4x fewer tokens than Claude Code, while opencode used 2x fewer tokens than Claude Code." Ein anderer sagte, ganze Profiling- und Refactoring-Sessions seien "in <20k tokens" fertig. Im älteren Terminal-Bench-2.0-Leaderboard (Dezember 2025) lag Pi mit Claude Opus 4.5 auf Platz #7 mit 49.8%, vor Claude Code mit Sonnet 4.5 auf #18 mit 40.1%.

Was Entwickler über Pi sagen

Das Lob ist plattformübergreifend einheitlich: ein kleiner Prompt, geringer Token-Verbrauch, Transparenz und ein Agent, den man verbiegen kann. Die stärkste einzelne Empfehlung kommt von 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

Nutzer lokaler Modelle mögen es aus einem Grund, der leicht übersehen wird. Ein riesiger System-Prompt braucht auf einem Laptop Minuten fürs Prefill, Pis nicht:

"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

Andere lieben, dass es nicht im Weg steht, während Anbieter ständig ihre Tools ändern:

"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

Die Kritik ist genauso einheitlich, und sie ist berechtigt. Die häufigste Beschwerde ist, dass „alles ist ein Plugin" Einrichtungsarbeit bedeutet, die andere Agenten für Sie erledigen:

"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

Die beste Ein-Zeilen-Zusammenfassung stammt aus einem Thread, der Pi mit OpenCode vergleicht: "Pi vs opencode for example is like gentoo vs macos." Auf Reddit lautet der Rat an Neulinge, nicht gleich am ersten Tag alles zu installieren. Wie ein Nutzer von r/PiCodingAgent sagte: "Pi actually works pretty well out of the box." Wer alles mitgeliefert haben will, wird meist auf den Fork oh-my-pi oder auf OpenCode verwiesen.

Pi Coding Agent vs. Claude Code

Da die meisten von Claude Code zu Pi kommen, hier der direkte Vergleich der Dinge, die Ihren Alltag tatsächlich verändern.

Mein Fazit: Wenn Sie hauptsächlich Claude-Modelle nutzen und Leitplanken, einen stabilen Funktionsumfang und einen Anbieter wollen, bei dem Sie sich beschweren können, bleiben Sie bei Claude Code. Wenn Sie oft das Modell wechseln, auf Tokens achten, lokale Modelle betreiben oder jede Zeile besitzen wollen, die der Agent sieht, ist Pi das interessantere Tool, und das 1.0-Release hat den Einstieg deutlich erleichtert. Für ein breiteres Feld mit Cursor und GitHub Copilot ist meine Übersicht zu AI-Coding-Assistenten der beste Startpunkt.

Sollten Sie einen Support-Agenten auf Pi bauen?

Der Gedanke ist naheliegend. Pi hat ein SDK, einen RPC-Modus und jetzt Pi Durable, dessen eigene Beispiele von Slack-Bots, Freigabe-Hooks und Triage-Bots sprechen. Die Modelle sind billiger denn je. Warum nicht Pi an Ihren Helpdesk anschließen und es einen Support-Agenten nennen?

Weil das Harness der kleinere Teil der Arbeit ist. So sehe ich die Aufteilung:

Ein Support-Agent braucht eine Zwei-Wege-Verbindung zu Ihrem Helpdesk (Ticket lesen, taggen, antworten, eskalieren), eine Möglichkeit, Ihr Help Center, Makros und frühere Tickets bei Änderungen synchron zu halten, Regeln dafür, was er ohne Mensch tun darf, und einen Weg, ihn an echten früheren Tickets zu testen, bevor er mit einem Kunden spricht. Diesen letzten Schritt würde ich nie überspringen. eesel hat das auf die harte Tour gelernt, als ein überzeugend klingender Bot tagelang falsche Antworten gab, bevor es jemand merkte, weshalb jeder eesel-Rollout heute zuerst gegen historische Tickets simuliert wird.

Den Reiz des Selbstbauens sehe ich auch von der anderen Seite. Mehrere eesel-Kunden, darunter eine AR- und Bautechnik-Firma und eine DTC-Beauty-Marke, sind gegangen, um direkt auf der Claude API zu bauen. Und die Teams, die bleiben, sagen oft dasselbe. Ein Engineering Lead bei GENERAL BYTES, dem Hersteller von Bitcoin-Geldautomaten, erklärte, warum sie sich fürs Kaufen entschieden:

"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."

Meine Antwort also: Bauen Sie auf Pi, wenn Ihr Team Freude daran hat, den ganzen Stack zu besitzen, und Zeit, ein Projekt im Blick zu behalten, das fast täglich Patch-Releases veröffentlicht. Wenn das Ziel beantwortete Tickets sind und nicht ein Framework, das Sie pflegen müssen, stellen Sie das Teammate ein und lassen Pi tun, was es hervorragend kann: Code schreiben.

eesel ausprobieren

Pi ist das Harness; eesel ist der Mitarbeiter. eesel ist eine AI-Teammate-Plattform, auf der Sie einsatzbereite Teammates für bestimmte Aufgaben einstellen. Für den Support ist das das AI-Helpdesk-Teammate: Es bindet sich in Minuten an Zendesk, Freshdesk, Gorgias und Slack an, lernt aus Ihren früheren Tickets und Ihrem Help Center, und Sie können es an Ihrer eigenen Ticket-Historie simulieren, bevor es einen einzigen Kunden beantwortet. Wenn Sie statt Tickets Inhalte brauchen, hat dieselbe Plattform ein AI-Blog-Writer-Teammate.

Das Beste für Pi-Nutzer: Sie müssen das Terminal nicht verlassen. Die eesel-CLI bedient dasselbe Teammate und denselben Workspace wie das Dashboard, "another way in, not a separate copy." npx @eesel/cli init richtet einen Agenten ohne Konto ein, eesel integrations connect zendesk verbindet Ihren Helpdesk (eine Person gibt das in Zendesk frei), eesel instructions bearbeitet die Standardregeln des Agenten als Klartext, eesel approvals list zeigt Aktionen, die auf einen Menschen warten, und mit eesel activity lesen Sie jeden Lauf. Jeder Befehl gibt JSON aus und unterstützt --dry-run, und Fehler kommen mit einem hint-Feld zurück, genau das, was ein Coding-Agent braucht, um ein Tool selbstständig zu bedienen.

eesels Docs nennen Claude Code, Cursor und Codex, aber nichts hindert Pi daran, dieselbe Aufgabe zu übernehmen: Es kann die CLI über sein bash-Tool ausführen oder sich mit dem MCP-Server verbinden, den jeder eesel-Workspace bereitstellt (eesel mcp token gibt die URL und ein 30-Tage-Token aus), nun da Pi 1.0 MCP spricht. Headless-Setups nutzen EESEL_API_URL, EESEL_API_TOKEN und EESEL_AGENT_ID. Meine Leitfäden zu einer AI-Agent-CLI und einer CLI für den Kunden-Support gehen tiefer.

Sie können mit dem kostenlosen Tarif mit 100 Credits und ohne Karte starten. Bezahlte Teammate-Tarife beginnen bei $299 im Monat für 500 Credits, und ein Ticket oder Chat ist ein Credit, egal wie lange er läuft. Die Setup- und Beobachtungsbefehle der CLI sind kostenlos; nur der Chat wird berechnet. Das ist der kürzere Weg, wenn Sie gelöste Tickets wollen, und Pi darf trotzdem das Tippen übernehmen.