# Pi-Harness
English ·
简体中文 ·
繁體中文 ·
日本語 ·
한국어 ·
Русский ·
Français ·
Deutsch
Das Operational Superset von Pi Coding Agent
Native Pi mit visuellem Workspace, Ausführungssteuerung, Wiederherstellung und Agenten-Teams.
Pi Coding Agent ⊂ Pi-Harness
Download ·
Eigenen Skin erstellen ·
Screenshots
## Warum Pi-Harness?
Pi-Harness bringt Pi Coding Agent in einen Desktop-Workspace für macOS, Windows und Linux. Verwalte Chats, Projekte, Dateien, Git, Modelle und Skills an einem Ort und nutze Werkzeuge zur Prüfung von Ausführungen, Budgetsteuerung, Wiederherstellung und Zusammenarbeit von Agenten.
Native Pi führt die Agenten aus. Pi-Sitzungen, Konfiguration, Werkzeuge, Skills und Erweiterungen bleiben mit Pi kompatibel. Du kannst Pi auch außerhalb der Desktop-App weiter nutzen.
## Native Pi und Pi-Harness
Pi-Harness ist das operative Superset von Pi Coding Agent: Auf den Funktionen von Native Pi bauen Beobachtung, Steuerung, Wiederherstellung, Agentenkoordination und ein visueller Workspace auf.
| Funktion | Native Pi | Pi-Harness |
| ------------------------ | --------- | ---------------------------- |
| Agent Runtime | Ja | Native Pi |
| Agent Loop | Ja | Native Pi |
| Sessions | Ja | Ja + visuelle Verwaltung |
| Context | Ja | Ja + Prüfung |
| Compaction | Ja | Ja + visuelle Steuerung |
| Steering | Ja | Ja |
| Follow-up | Ja | Ja |
| Models | Ja | Ja + Verwaltung |
| Thinking | Ja | Ja + visuelle Steuerung |
| Tools | Ja | Ja + Auswahl und Richtlinien |
| Skills | Ja | Ja + Verwaltung |
| Extensions | Ja | Ja + Verwaltung |
| Packages | Ja | Ja + Verwaltung |
| MCP / Codemode | Ja | Ja + Auswahl und Richtlinien |
| Runs | — | Ja |
| Trace | — | Ja |
| Replay | — | Ja |
| Run Compare | — | Ja |
| Evaluation | — | Ja |
| Policy | — | Ja |
| Budget | — | Ja |
| Checkpoints | — | Ja |
| Recovery | — | Ja |
| Diagnostics | — | Ja |
| Regression | — | Ja |
| Artifacts | — | Ja |
| Multi-Agent | — | Ja |
| Task DAG | — | Ja |
| Handoff | — | Ja |
| Review Gates | — | Ja |
| Worktree isolation | — | Ja |
| Project architecture map | — | Ja |
## Funktionen
### Workspace, Dateien und Git
Starte einen eigenständigen Chat oder öffne ein Projekt und setze eine Pi-Sitzung fort. Verfolge Streaming-Antworten, Denkprozesse, Werkzeugaufrufe, Bilder und Dateiänderungen; wähle Modell, Denkstufe und Werkzeuge oder komprimiere den Gesprächskontext. Über die Workspace-Werkzeuge erreichst du Harness und Agenten, während Chat und ungesendeter Entwurf erhalten bleiben.
Durchsuche Dateien, zeige Medien und Dokumente in der Vorschau an und bearbeite Text mit Syntaxhervorhebung, Zeilennummern, Suche, Rückgängig/Wiederholen, ausdrücklichem Speichern und Schutz vor Konflikten durch externe Änderungen. Git bietet Diffs, Verlauf, Aktivitätsgrafiken, Commits, optionale KI-Commit-Nachrichten und Worktrees.
### Anbieter und Modelle
Richte Pi-kompatible Anbieter mit Vorlagen oder eigenen Endpunkten ein, verwalte Zugangsdaten, lade unterstützte Modelllisten, teste Verbindungen und wähle dein Chatmodell. Mit unterstützten Bildmodellen kannst du Bilder erzeugen oder bearbeiten und die Ergebnisse herunterladen.
### Skills, Erweiterungen, Pakete und MCP
Durchsuche und bearbeite integrierte und lokale Skills und verwalte Pi-Pakete und Erweiterungen im Funktionsbereich. Gib `@` im Eingabefeld ein, um einen installierten Skill zu suchen und aufzurufen. Verbinde MCP über unterstützte Pakete. Optionale Ergänzungen wie [Superpowers](https://github.com/obra/superpowers) und [Odai](https://github.com/orziz/odai) kannst du bei Bedarf installieren, aktualisieren oder entfernen.
### Harness: beobachten, steuern und wiederherstellen
Prüfe Runs, Trace, Replay, Zeitleisten und Werkzeugaktivitäten. Vergleiche Ausführungen, verfolge Verzweigungen und Wiederholungen im Run Tree und sieh Tokens, Kosten, Dauer, Artefakte und Projektstatistiken ein.
Lege Werkzeugrichtlinien und Budgets pro Ausführung fest, erstelle Checkpoints und setze Arbeit fort, verzweige sie oder wiederhole sie. Evaluation, Diagnose und Regressionsbaselines helfen, Ergebnisse und Fehler anhand aufgezeichneter Ausführungsdaten zu prüfen.
### Agenten-Teams und Aufgabenkoordination
Koordiniere Pi-Agenten mit wiederverwendbaren Teams und Vorlagen. Weise Aufgaben Abhängigkeiten, Prioritäten und Verantwortliche zu, starte sie manuell, nacheinander oder parallel, übergib Ergebnisse und Artefakte und nutze Prüfschritte. Worktrees trennen Änderungen; Budgets, Konflikthinweise sowie Pause, Fortsetzen, Abbrechen, Wiederholen, Überspringen und Neuzuweisen helfen bei der Steuerung.
### Lokaler Gesprächsverlauf
Durchsuche gemeinsam die Verläufe von Claude Code, Codex (einschließlich Desktop und Archiv), Cursor, Cursor Agent, Gemini CLI, OpenCode und Pi. Filtere nach Quelle, Projekt oder Zeitraum und füge eigene Verlaufsordner hinzu.
Das ursprüngliche Gespräch bleibt schreibgeschützt. Prüfe die Übergabevorschau und bearbeite die nächste Anweisung, bevor du in einem neuen Pi-Chat desselben Projekts fortfährst. Ansehen, lokale Vorschauen und erneute Scans verbrauchen keine Modell-Tokens. Optionale KI-Zusammenfassungen verwenden dein konfiguriertes Modell nur auf Wunsch.
### Projektarchitektur
Öffne Architecture im Workspace, um Module, Abhängigkeiten, Einstiegspunkte und Quellcode-Verweise zu erkunden. Filtere nach Paket, fokussiere ein Modul, wechsle Kartenseiten, zoome oder nutze Vollbild. Speichere Analysen, erkenne veraltete Ergebnisse nach Quellcodeänderungen und exportiere JSON, Offline-HTML oder die aktuelle Ansicht als PNG.
Die lokale Analyse verbraucht keine Modell-Tokens; KI-Beschreibungen sind optional. Importbeziehungen von JavaScript, TypeScript und Vue werden lokal analysiert, andere unterstützte Sprachen erhalten einen Dateiindex. Abdeckung und Grenzen der Analyse werden angezeigt.
### Themes und eigene Skins
Wähle klassische Farbpaletten, Ming, Starship Cockpit, macOS-27-Hintergründe oder einen importierten Skin. Neue Installationen starten im dunklen Theme. Passe Chatnamen, App-Symbole, lokale Hintergrundbilder, Fenster- und Bildschirmleuchten sowie den Flammeneffekt des Eingabefelds an. Eine Startanimation begleitet die Umgebungsprüfung; Builds ohne Maskottchen behalten die allgemeinen Darstellungsoptionen.
### Umgebung und App-Einstellungen
Prüfe Node.js, npm, PATH, Pi Coding Agent und die aktive Konfiguration. Installiere, aktualisiere oder repariere Pi in unterstützten Umgebungen, nutze Diagnosen, verwalte Konfigurationssicherungen und prüfe App-Updates. Die Oberfläche ist in acht Sprachen verfügbar.
## Eigenen Skin erstellen
Erstelle deinen gewünschten Stil mit dem [Pi-Harness Skin-Starter](https://github.com/wangmiaozero/pi-harness-skin-starter).
1. Verwende das Starter-Repository als Vorlage oder lade es herunter.
2. Öffne es mit deinem Coding-Agenten und beschreibe den Stil im mitgelieferten Prompt.
3. Importiere das fertige Projekt unter **Einstellungen → Thema → Skin importieren**.
Der mehrsprachige Starter enthält Hinweise zu Farben, Vorschauen, Hintergründen und optionalen Charakterbildern. Aktualisiere und teile deinen Skin unabhängig in einem eigenen Repository.
## Screenshots
Die Funktionsansichten sind nach Theme geordnet. Weitere Ansichten findest du im [vollständigen Screenshot-Verzeichnis](docs/README.md).
### Klassisches Theme
#### Workspace
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E5%B7%A5%E4%BD%9C%E5%8C%BA.png)
Git · Anbieter und Modelle · Funktionsbereich · Harness · Projektarchitektur
#### Git
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/Git.png)
#### Anbieter und Modelle
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/Provider%E4%B8%8E%E6%A8%A1%E5%9E%8B-1.png)
#### Funktionsbereich
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E8%83%BD%E5%8A%9B%E4%B8%AD%E5%BF%83-1.png)
#### Harness
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E5%B7%A5%E5%85%B7Harness-1.png)
#### Projektarchitektur
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E7%BB%8F%E5%85%B8%E4%B8%BB%E9%A2%98/%E9%A1%B9%E7%9B%AE%E6%9E%B6%E6%9E%84-1.png)
### Ming-Funktionsansichten
Allgemeine Einstellungen · Themes und Skins
#### Allgemeine Einstellungen
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E5%A4%A7%E6%98%8E/%E9%80%9A%E7%94%A8%E8%AE%BE%E7%BD%AE.png)
#### Themes und Skins
[](docs/%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2/%E5%A4%A7%E6%98%8E/%E4%B8%BB%E9%A2%98%E7%9A%AE%E8%82%A4%E5%BA%93.png)
### Theme-Galerie
Ming · Beamter im Schnee · Ming · Flötenspielerin in der Schneenacht · Ming · Gelehrte im Mondlicht · Starship Cockpit · macOS 27 · Liquid Ether
#### Ming · Beamter im Schnee
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E5%A4%A7%E6%98%8E/%E9%9B%AA%E5%A2%83%E6%9C%9D%E8%87%A3.png)
#### Ming · Flötenspielerin in der Schneenacht
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E5%A4%A7%E6%98%8E/%E9%9B%AA%E5%A4%9C%E7%AC%9B%E5%A7%AC.png)
#### Ming · Gelehrte im Mondlicht
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E5%A4%A7%E6%98%8E/%E6%9C%88%E5%9F%8E%E4%B9%A6%E5%A7%AC.png)
#### Starship Cockpit
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/%E6%98%9F%E8%88%B0/%E9%9C%9C%E6%98%9F%E9%A2%86%E8%88%AA.png)
#### macOS 27 · Liquid Ether
[](docs/%E4%B8%BB%E9%A2%98%E5%B1%95%E7%A4%BA/macOS%2027/Liquid%20Ether.png)
## Download
Lade einen veröffentlichten Installer von [GitHub Releases](https://github.com/wangmiaozero/pi-harness/releases) herunter und wähle die Datei für deine Plattform.
| Plattform | Installer |
| ------------------- | -------------------------- |
| macOS Apple Silicon | `.dmg` · `arm64` |
| macOS Intel | `.dmg` · `x64` |
| Windows x64 | `.exe` · Windows-Installer |
| Linux x64 | `.AppImage` |
Nutzer der paketierten App müssen das Repository nicht klonen oder pnpm installieren. In unterstützten Umgebungen hilft Pi-Harness bei der Einrichtung von Pi und dessen Laufzeitumgebung.
> macOS-Community-Builds können unsigniert sein. Falls der erste Start blockiert wird, nutze **Systemeinstellungen → Datenschutz & Sicherheit → Dennoch öffnen**.
## Erste Schritte
1. Starte Pi-Harness und prüfe die Umgebung in der Übersicht.
2. Richte einen Anbieter ein, teste die Verbindung und wähle ein Modell.
3. Starte einen eigenständigen Chat oder öffne ein Projekt.
4. Starte oder setze eine Pi-Sitzung fort und arbeite mit Chats, Dateien und Git.
5. Öffne die Workspace-Werkzeuge für Harness-Steuerung oder Agenten-Teams.
## Voraussetzungen
Die Desktop-App unterstützt macOS Apple Silicon, macOS Intel, Windows x64 und Linux x64. In unterstützten Umgebungen lässt sich Pi Coding Agent aus der App installieren oder reparieren. Für die Ausführung aus dem Quellcode sind Node.js ≥ 22.22.2 und pnpm 9.12.1 erforderlich.
## Dokumentation
- [Screenshot-Verzeichnis](docs/README.md)
- [Änderungsprotokoll](CHANGELOG.md)
## Danksagung und Autor
Pi-Harness baut auf den offiziellen Projekten [Pi Coding Agent und Pi Agent Harness](https://github.com/earendil-works/pi) auf.
Erstellt und gepflegt von [wangmiao](https://github.com/wangmiaozero) · [tuziling84@gmail.com](mailto:tuziling84@gmail.com).
## Lizenz
Pi-Harness steht unter der [GNU Affero General Public License v3.0 only](LICENSE) (`AGPL-3.0-only`).
Copyright © 2026 [wangmiao](https://github.com/wangmiaozero).