Pi Coding Agent von Mario Zechner: minimaler Agent Harness fürs Terminal, MIT lizenziert, Basis von OpenClaw. Installation, Extensions und NCA Einordnung
Mehr erfahren
DeepSeek Harness ist eine offene Agent Runtime unter MIT Lizenz, im Terminal erreichbar über das Kommando dsh. Der Kerngedanke steht schon in der Beschreibung des Repositorys: Alles ist ein Plugin. Modelle, Tools, Skills, Sessions, Sandboxes, Speicher, die Agent Schleife und sogar die Oberfläche lassen sich per Konfiguration austauschen.
Eine Harness ist die Schicht zwischen dem Modell und der Umgebung, in der es arbeitet. DeepSeek bringt das auf die Formel: Agent gleich Modell plus Harness. Das Modell denkt, die Harness gibt ihm Hände.
Die meisten Frameworks verdrahten diese Schicht fest. Agent Schleife, Tool Registry und Session Speicher liegen im Code, erweitern kann man nur an den Haken, die die Autoren vorgesehen haben. Harness dreht das um. Jede Komponente sitzt hinter einer Plugin Grenze des Cordis Meta Frameworks und lässt sich ersetzen, ohne den Quellcode der Harness anzufassen.
Geschrieben ist das Ganze in TypeScript auf Node.js. Der Code liegt offen im Repository deepseek-ai/deepseek-harness. Seit der Preview von Version 0.2 am 29. September 2026 gibt es zusätzlich Desktop Installer für macOS und Windows.
Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.
Never Code Alone arbeitet täglich mit Coding Agenten im Terminal. Wir kennen den Unterschied zwischen einem Agenten, der in der Demo beeindruckt, und einem, der im echten Projekt hält. Der Punkt, an dem Teams scheitern, ist selten die Wahl der Runtime. Es sind fehlende Quality Gates: kein Test, keine statische Analyse, keine Möglichkeit nachzuvollziehen, was der Agent eigentlich getan hat.
Genau deshalb ist der Session Log bei Harness der interessantere Teil als die Plugin Architektur. Wer Agentenläufe wiederholen, verzweigen und durchsuchen kann, kann sie auch prüfen.
Wir unterstützen Teams beim Aufbau: Vibe Coding Beratung für den Einstieg, eine belastbare KI Strategie, die Einordnung, welches KI Modell ohne US Anbieter passt, und CI/CD Pipelines für Vibe Coding, in denen die Arbeit der Agenten auch wirklich geprüft wird.
Der Satz klingt erst mal nach Marketing. Er ist aber wörtlich gemeint. Neun Bereiche sitzen hinter Plugin Grenzen und lassen sich aus der Konfiguration heraus tauschen, ohne den Quellcode anzufassen.
Der spannendste Punkt in dieser Liste ist die Agent Schleife. Wer eine andere Denkstrategie ausprobieren will, ersetzt sie als Plugin, statt ein Framework zu forken. Das ist für Forschung und für Teams mit eigenen Anforderungen ein echter Unterschied. Verwandte Konzepte beschreiben wir unter Agent Looping und LangGraph.
Alles, was das Modell sieht, landet in einem Ereignisstrom, der nur angehängt und nie überschrieben wird: System Prompts, Denkketten, Werkzeugaufrufe, Ergebnisse, Kontexteinspielungen. Aus diesem Log heraus lassen sich Läufe fortsetzen, verzweigen, durchsuchen und noch einmal abspielen.
Für uns ist das der wichtigste Teil der ganzen Software. Ein Coding Agent, dessen Lauf du nicht nachvollziehen kannst, ist im Unternehmenskontext schwer zu verantworten. Wer prüfen können muss, was passiert ist, braucht genau so einen Log.
Dazu kommt ein Detail, das man leicht übersieht. DeepSeek hat in den Benchmark Tabellen zu seinen V4 Modellen als Messumgebung die eigene Harness angegeben, die damals niemand außerhalb der Firma einsehen konnte. Mit der Veröffentlichung ist ein Teil dieser Methodik nachprüfbar geworden. Für V4.1 Flash misst DeepSeek die Code Agent Benchmarks im Minimal Modus der Harness und legt für DeepSWE eine Anleitung zur Reproduktion bei. Unsere Einordnung der Modelle steht unter DeepSeek für Entwickler.
Im September 2026 erschien Harness 0.1.5. Die Version ist gezielt auf das Modell DeepSeek V4.1 Flash abgestimmt, und zwar in allen drei Modi: Standard, Programmatic Tool Calling und Minimal. System Prompts lassen sich ändern, ohne den vorhandenen KV Cache zu verwerfen. Bei langen Agent Läufen spart das Rechenarbeit.
Die weiteren Neuerungen in 0.1.5:
Am 29. September 2026 folgte die Preview von Version 0.2. Sie bringt Desktop Installer für macOS und Windows, eine Plugin Verwaltung, über die sich Plugins per npm Paketname installieren, deaktivieren und entfernen lassen, und Plugins für Automationen, die wiederkehrende Aufgaben zeitgesteuert ausführen. Damit zielt DeepSeek erstmals auch auf Nutzer ohne Terminal.
Spannend ist ein Detail aus DeepSeeks Modellkarte zu V4.1 Flash. Dort läuft das Modell in mehreren Umgebungen gegeneinander: Claude Code, Codex, OpenCode, Pi, mini-SWE und drei Harness Modi. Die Abstände sind klein. Auf Terminal Bench 2.1 liegt der Minimal Modus der Harness vorn, auf DeepSWE der mini-SWE Agent. Das bestätigt unsere Sicht: Die Runtime ist austauschbar, entscheidend sind die Quality Gates darum herum.
DeepSeek positioniert Harness offen gegen Claude Code. Der Unterschied ist weniger die Funktionsliste als die Bauweise. Claude Code ist ein fertiges Produkt mit viel Feinschliff. Harness ist ein Baukasten, bei dem du selbst zusammensteckst, was du brauchst, und bei dem die Teile noch wackeln.
Näher dran ist der Vergleich mit OpenCode. Beide sind offen, beide laufen lokal, beide lassen sich an beliebige Modelle hängen. OpenCode ist heute deutlich weiter und wird im Alltag ohne Nachdenken benutzt. Harness geht bei der Austauschbarkeit weiter, kostet dafür aber Aufbauarbeit.
Wer es noch minimaler mag, findet in unserem Glossar den Pi Coding Agent, einen bewusst winzigen Terminal Harness mit vier Werkzeugen.
Die Versionsnummer steht auch mit der 0.2 Preview noch ganz am Anfang. Im Projekt steht ausdrücklich, dass brechende Änderungen kommen. Das Agent Teams Plugin ist experimentell und standardmäßig aus. Wer heute darauf aufbaut, arbeitet morgen nach. Für Production ist das nichts, für einen Nachmittag im Testprojekt schon.
Der zweite Punkt betrifft die Bindung an den Hersteller. Die aktuellen Versionen sind sichtbar auf DeepSeeks eigenes Modell zugeschnitten. Die Plugin Architektur verhindert zwar einen Lock In, der Feinschliff landet aber zuerst beim Hausmodell. Das macht die Offenlegung nicht weniger wert, man sollte sie nur nicht als neutrales Werkzeug lesen.
Für uns wichtiger als beides: Harness ist local first und läuft mit deinem eigenen Schlüssel. Du kannst es auch gegen ein lokales Ollama oder einen europäischen Anbieter hängen. Es zwingt dich nicht zu DeepSeeks API.
Bleibt die Frage der Datensouveränität. DeepSeek ist ein chinesisches Unternehmen, und für Teams mit sensiblen Daten gehört das in die Risikobewertung. Unsere Regel ändert sich dadurch nicht: Coding Modelle, die nicht auf eigener Infrastruktur laufen, setzen wir gegen lokale Entwicklungsumgebungen mit Fake Daten ein. Coding aus der Cloud, Datenverarbeitung im eigenen Netz. Mehr dazu in unserem Beitrag zu lokaler KI für Compliance.
Wir empfehlen DeepSeek Harness nicht für Production. Wir helfen Teams, es einzuordnen und gegen ihren bestehenden Stack zu bewerten.
Am 24. August 2026 meldete das Threat Intelligence Center von Qi An Xin eine unauthentifizierte Remote Code Execution in DeepSeek Harness unter der Kennung QVD-2026-57410. Inzwischen ist die Lücke als CVE-2026-82533 registriert. VulnCheck bewertet sie mit CVSS 9.4. Betroffen sind Versionen vor 0.1.2-alpha.1, die Korrektur steckt in 0.1.2-alpha.1 und allen späteren Versionen.
Die Ursache ist ein Klassiker. Der /api Endpunkt entschied anhand des HTTP Host Headers, ob eine Anfrage vom eigenen Rechner kommt, und gab darüber privilegierte RPC Methoden frei. Den Host Header setzt aber der Client. Wer ihn auf localhost fälschte, galt als lokaler Aufrufer, konnte einen eigenen Modell Provider registrieren und die Agent Tools beliebige Systembefehle ausführen lassen. Ein gültiger API Key war dafür nicht nötig.
Betroffen war nicht jede Installation. Der Web Service lauscht per Default auf 127.0.0.1. Gefährlich wird es, sobald ein Docker Port Mapping oder ein Reverse Proxy die Oberfläche ins Netz hebt. Genau das passiert schneller als gedacht, wenn ein Team den Agenten auf einem Server statt auf dem Laptop laufen lässt.
Konkret heißt das: Auf eine aktuelle Version aktualisieren. Die Agent Oberfläche nicht ins offene Netz stellen, sondern hinter VPN oder einen Reverse Proxy mit Authentifizierung. Im Proxy den Host Header fest überschreiben. Und jede Instanz, die mit einer alten Version exponiert war, als kompromittiert behandeln und alle Schlüssel tauschen, die sie sehen konnte.
Für uns ist der Fall lehrreich über DeepSeek hinaus. Eine Agent Runtime darf Dateien lesen, Shell Befehle ausführen und Netzwerkzugriffe machen. Wer sie übernimmt, übernimmt die Maschine. Deshalb gehört jeder Coding Agent in eine abgesicherte Umgebung mit klaren Grenzen, nicht auf einen offenen Port. Wie das aussieht, zeigen wir in Vise Coding mit Guardrails, und wer solche Lücken selbst finden will, findet in Shannon als KI Pentester den passenden Ansatz.
DeepSeek Harness: Everything is a Plugin.
Pi Coding Agent von Mario Zechner: minimaler Agent Harness fürs Terminal, MIT lizenziert, Basis von OpenClaw. Installation, Extensions und NCA Einordnung
Mehr erfahrenBei Never Code Alone laufen KI Modelle nicht in der Präsentation, sondern im Terminal. Unsere Erfahrung: Die Runtime ist selten das Problem. Das Problem ist, dass niemand prüft, was der Agent produziert hat. Deshalb steht bei uns die Absicherung vor der Automatisierung. Statische Analyse, Unit Tests, funktionale Tests und E2E Tests mit Cypress sind die Bedingung dafür, dass ein Agent überhaupt sinnvoll arbeiten kann.
Gerade beim Aufräumen von Altlasten gilt das doppelt. Refactoring läuft bei uns stark manuell mit KI Unterstützung, nie als autonomer Agent. Erst die Quality Gates, dann das Aufräumen.
Weiterführende Themen aus dem NCA Glossar:
Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.
Die wichtigsten Fragen zu Lizenz, Reifegrad, Betrieb und Datenschutz kurz beantwortet.
DeepSeek Harness ist eine offene Agent Runtime unter MIT Lizenz, im Terminal als dsh erreichbar. Sie ist die Schicht zwischen Modell und Umgebung: Werkzeuge, Dateien, Sandboxes und die Agent Schleife. Der Leitsatz lautet, dass jede Komponente ein austauschbares Plugin ist. Seit der 0.2 Preview gibt es auch Desktop Installer für macOS und Windows.
Nein. Auch mit der 0.2 Preview steht die Software noch am Anfang, brechende Änderungen sind ausdrücklich angekündigt. Das Agent Teams Plugin ist experimentell und standardmäßig deaktiviert. Dazu kam im Sommer eine kritische Sicherheitslücke in frühen Versionen. Für Experimente und Forschung ist Harness geeignet, für Produktivsysteme nicht.
Die Harness ist der Rahmen um ein Sprachmodell herum: Tool Registry, Session Speicher, Sandbox, Rechte, Hooks und die Steuerschleife, die den Agenten weiterarbeiten lässt. DeepSeek fasst das als Agent gleich Modell plus Harness. Das Modell denkt und schlägt Schritte vor. Die Harness entscheidet, was diese Schritte anfassen dürfen, und führt sie aus.
Die Preview von Version 0.2 erschien am 29. September 2026. Sie bringt Desktop Installer für macOS und Windows, eine Plugin Verwaltung zum Installieren, Deaktivieren und Entfernen von Plugins per npm Paketname und Automations Plugins, die wiederkehrende Aufgaben zeitgesteuert ausführen. Damit öffnet sich Harness erstmals für Nutzer ohne Terminal.
Nein. Der Modelladapter ist selbst ein Plugin. Du kannst die Harness an ein lokales Ollama, an eine andere OpenAI kompatible API oder an einen europäischen Anbieter hängen. Local first ist ausdrücklich Teil des Konzepts, auch wenn die aktuellen Versionen auf DeepSeek V4.1 Flash abgestimmt sind und der Feinschliff zuerst beim Hausmodell landet.
Ja. MIT erlaubt praktisch jede Nutzung, auch kommerzielle Produkte auf Basis des Codes. Sie ist deutlich freizügiger als Copyleft Lizenzen, weil abgeleitete Werke nicht offengelegt werden müssen. Beachte aber: Die Lizenz gilt für die Runtime, nicht für die Modelle oder deren Nutzung über eine API. Dafür gelten die Bedingungen des jeweiligen Anbieters.
Version 0.1.5 ist auf DeepSeek V4.1 Flash abgestimmt, im Standard, PTC und Minimal Modus. System Prompts lassen sich ändern, ohne den KV Cache zu verlieren. Dazu kommen Upload von Bildern und PDFs, eine Dateibaum Vorschau, Plugin Einstiege in der Oberfläche, bessere Performance in langen Sessions und Kommunikation mit Child Agents.
Frühe Versionen akzeptierten einen gefälschten Host Header als lokalen Aufruf und gaben darüber privilegierte API Methoden frei. Das ermöglichte Remote Code Execution ohne API Key, sobald die Oberfläche im Netz erreichbar war. Die Lücke ist als CVE-2026-82533 registriert und ab Version 0.1.2-alpha.1 behoben. Exponierte alte Instanzen gelten als kompromittiert.
Claude Code ist ein fertiges, proprietäres Produkt von Anthropic mit viel Feinschliff im Alltag. Harness ist ein offener Baukasten in frühem Stadium. Der Vorteil liegt in der Austauschbarkeit jeder Komponente, bis hin zur Agent Schleife. Der Preis dafür ist Aufbauarbeit, fehlende Reife und häufige brechende Änderungen.
Beide sind offen, laufen lokal und lassen sich an beliebige Modelle hängen. OpenCode ist im Alltag deutlich weiter und stabiler. Harness geht bei der Austauschbarkeit weiter, weil auch die Agent Schleife selbst ein Plugin ist. Für produktive Arbeit ist OpenCode heute die bessere Wahl, für Experimente mit eigener Agent Logik ist Harness spannend.
Alles, was das Modell sieht, wird in einem nur anhängenden Ereignisstrom festgehalten: Prompts, Denkketten, Werkzeugaufrufe, Ergebnisse. Daraus lassen sich Läufe fortsetzen, verzweigen, durchsuchen und wiederholen. Für Nachvollziehbarkeit im Unternehmenskontext ist das der wichtigste Teil, weil sich jeder Schritt des Agenten später prüfen lässt.
Die Runtime läuft lokal mit deinem eigenen Schlüssel, damit hast du die Kontrolle über den Datenfluss. Entscheidend ist, an welches Modell du sie hängst. Unsere Regel: Coding Modelle ohne eigene Infrastruktur nur gegen Entwicklungsumgebungen mit Fake Daten. DeepSeek als chinesisches Unternehmen gehört in die Risikobewertung.
Nein. Wir ordnen die Software editorial ein. In unserem Stack arbeiten wir mit Claude Code, OpenCode und lokalen Modellen über Ollama. Wir helfen Teams, Harness gegen ihren bestehenden Aufbau zu bewerten und die nötigen Quality Gates mit statischer Analyse, Tests und Cypress darum herum zu bauen.
Der Begriff verbreitete sich 2026, nachdem Mitchell Hashimoto seinen KI Workflow so beschrieb. Die Idee ist simpel: Macht ein Agent einen Fehler, änderst du nicht den Prompt, sondern die Umgebung, damit der Fehler nicht wieder passieren kann. OpenAI griff das für Codex auf, LangChain ordnete es genauso ein. Genau das ist Arbeit an Regeln, Tests und Guardrails.
Oft ja. Ein solides Harness holt aus einem älteren Modell mehr heraus als ein Modellwechsel ohne Struktur. Der Grund liegt in der Umgebung. Klare Regeln, enge Tool Rechte, saubere Fehlerrückmeldungen und laufende Tests fangen falsche Schritte früh ab. Genau darum bauen wir bei Legacy Projekten zuerst die Quality Gates und lassen den Agenten danach arbeiten.