Einführung in Pi mit lokalem Modell

Schritt 2

Bereite Workspace und Modelldienst vor

1. Verwende ein entbehrliches Git-Repository ohne vertrauliche Dateien oder Zugangsdaten.
2. Prüfe vor der Installation die aktuellen Runtime-Anforderungen in der Pi-Dokumentation.
3. Starte den gewählten lokalen Modelldienst und dokumentiere seinen Loopback-Endpunkt, wenn lokale Inferenz vorgesehen ist.
4. Führe git status --short außerhalb von Pi aus und sichere den Ausgangszustand.

Prüfung: Workspace, Runtime, Modell-Endpunkt und Git-Ausgangslage sind vor dem Start verfügbar.

Voraussetzungen am 25. August 2026 anhand der offiziellen Pi-Dokumentation geprüft.

Schritt 3

Installiere Pi aus dem aktuellen gepflegten Paket

1. Vergleiche den Paket-Namespace mit dem aktuellen offiziellen Repository und der Dokumentation.
2. Installiere mit npm install -g --ignore-scripts @earendil-works/pi-coding-agent.
3. Öffne ein neues Terminal, wenn die ausführbare Datei in der aktuellen Shell noch nicht sichtbar ist.
4. Führe pi --version aus und dokumentiere das Ergebnis zusammen mit dem Prüfdatum der Quelle.

Prüfung: Die installierte ausführbare Datei meldet eine Version und ihr Paketweg entspricht der gepflegten Pi-Quelle.

Paket-Namespace und Befehl am 25. August 2026 anhand des offiziellen Repositorys geprüft.

Schritt 4

Bestätige Workspace, Provider und Inferenzweg

1. Starte Pi im vorgesehenen Repository und bestätige den aktuellen Arbeitsordner.
2. Prüfe vor dem ersten Prompt den konfigurierten Provider, das Modell und den Endpunkt.
3. Verwende für einen lokalen Weg den dokumentierten, an 127.0.0.1 gebundenen llama.cpp-Router oder die gepflegte Ollama-Integration.
4. Beobachte während einer Anfrage den lokalen Modellprozess oder das Dienstprotokoll. Dokumentiere jede auftretende Remote-Verbindung.

Prüfung: Sichtbarer Endpunkt und beobachteter Prozesszustand stützen den angegebenen Inferenzort.

Offizielle llama.cpp-Integration · Offizielle Ollama-Integration

Schritt 5

Prüfe Anweisungshierarchie und Overrides

Pi liest hierarchische AGENTS.md-Dateien und kann außerdem CLAUDE.md verwenden. Eine AGENTS.override.md ersetzt die Anweisungsdatei auf derselben Verzeichnisebene.

1. Bestimme Anweisungsdateien von der Projektwurzel bis zum aktuellen Arbeitsordner.
2. Ordne jeder Datei ihren Verzeichnis-Scope und die Regeln für die aktuelle Aufgabe zu.
3. Prüfe, ob eine AGENTS.override.md die reguläre Datei auf ihrer Ebene ersetzt.
4. Löse widersprüchliche Anweisungen auf, bevor ein schreibfähiges Werkzeug verfügbar wird.

Prüfung: Du kannst die wirksamen Anweisungsdateien und jedes aktive Override benennen.

Laden der Anweisungen am 25. August 2026 in der offiziellen Nutzungsdokumentation geprüft.

Schritt 6

Setze eine explizite Allowlist für lesende Werkzeuge

Pi läuft mit den Betriebssystemrechten des startenden Nutzers. Pi besitzt keine eingebaute Ausführungs-Sandbox. Project Trust steuert das Laden von Projektressourcen, während Handlungen bereitgestellter Werkzeuge unter den Betriebssystemrechten des Nutzers ausgeführt werden.

1. Stelle für die erste Aufgabe ausschließlich read, grep, find und ls bereit.
2. Prüfe die Wirkung jedes zusätzlichen Werkzeugs vor seiner Aufnahme in die Allowlist.
3. Verwende einen Container oder einen eingeschränkten Betriebssystem-Account für Aufgaben mit stärkerem Isolationsbedarf.
4. Halte Zugangsdaten und vertrauliche Dateien außerhalb des Übungs-Workspaces.

Prüfung: Die aktiven Werkzeuge unterstützen Repository-Inspektion und stellen keinen Weg zum Schreiben von Dateien oder Ausführen einer Shell bereit.

Offizielle Pi-Sicherheitsdokumentation, geprüft am 25. August 2026.

Schritt 7

Bestimme Erweiterungen und bewusst ausgelassene Built-ins

Pi unterstützt Skills, Extensions und Packages. Eingebaute Permission Prompts, Plan Mode, Model Context Protocol und Subagents fehlen im Kernprodukt.

1. Prüfe Quelle und bereitgestellte Werkzeuge einer Extension vor dem Laden.
2. Verwende Skills für gepflegte Verfahren mit expliziten Triggern und Prüfungen.
3. Verwende getrennte Prozesse und isolierte Workspaces für unabhängige parallele Arbeit.
4. Füge Allowlists, Container oder Extensions für einen definierten Funktionsbedarf hinzu.

Prüfung: Jede ergänzte Funktion besitzt eine bekannte Quelle, einen Werkzeug-Scope und eine Prüfmethode.

Produktgrenzen am 25. August 2026 in der offiziellen Nutzungsdokumentation geprüft.

Schritt 8

Führe eine reversible Orientierung aus und prüfe jede Grenze

Starte Pi mit einer expliziten Allowlist für lesende Werkzeuge und fordere eine Repository-Orientierung an, deren Aussagen direkt prüfbar sind.

1. Führe pi --tools read,grep,find,ls -p "Summarize this repository and explain how its checks are run." aus.
2. Vergleiche die Antwort mit den zitierten Anweisungsdateien und Prüfdefinitionen.
3. Dokumentiere Pi-Quelle und Version, konfigurierten Provider-Endpunkt und beobachteten Modellprozess als getrennte Evidenz.
4. Führe git status --short außerhalb von Pi aus und vergleiche das Ergebnis mit der Ausgangslage.

Prüfung: Die Orientierung ist quellengebunden, die Evidenz für lokale Inferenz ist explizit und das Repository bleibt unverändert.

Pi-Dokumentation · Sicherheitsgrenze · Quellen geprüft am 25. August 2026