AI Harnesses sind die Software-Schicht, die aus einem Sprachmodell einen arbeitsfähigen Agenten macht. Mastra Code ist der Terminal-Coding-Agent-Harness von Mastra: aufgebaut auf dem quelloffenen Mastra-Framework, mit Observational Memory statt klassischer Kontext-Kompaktierung und Zugriff auf eine breite Modellauswahl über einen zentralen Model Router. Stand: 20. September 2026.
Was ist Mastra Code?
Mastra Code wird vom Team hinter Mastra entwickelt, dem TypeScript-Framework für KI-Anwendungen und Agenten (rechtlicher Anbieter laut Nutzungsbedingungen: Kepler Software, Inc.). Der Quellcode liegt im Monorepo mastra-ai/mastra im Verzeichnis mastracode; außerhalb der separat lizenzierten ee/-Verzeichnisse steht das Repository laut eigener Lizenzdatei unter der Apache-2.0-Lizenz. Installiert wird Mastra Code per npm install -g mastracode oder direkt per npx mastracode; im Projektverzeichnis startet der Befehl mastracode einen Einrichtungsassistenten, der Modellanbieter und Modi für den ersten Start konfiguriert. Laut Dokumentation ist Node.js 22.19.0 oder neuer Voraussetzung.
Mastra Code als AI Harness
Die Architektur besteht aus vier Schichten: einer Terminal-Oberfläche, dem AgentController für Modus-Verwaltung, Thread-Persistenz und Ereignisfluss, der eigentlichen Mastra-Agent-Schicht für Modellwahl und Werkzeugausführung sowie einer LibSQL-Speicherschicht für Verlauf und Observational Memory. Drei Modi – Build, Plan und Fast – passen Tiefe und Antwortzeit an die Aufgabe an. Werkzeuge für Datei- und Shell-Zugriff lassen sich über MCP-Server (/mcp) sowie programmatisch über eigene Werkzeuge und Subagenten erweitern; dazu kommen Skills in SKILL.md-Dateien, die Mastra Code laut Dokumentation unter anderem aus .claude/skills/ und .agents/skills/ liest – also kompatibel zu Claude Code und dem offenen Agent-Skills-Standard. Projektinstruktionen liest Mastra Code aus AGENTS.md oder CLAUDE.md. Für mehrstufige Aufgaben verfolgt /goal ein Ziel, bis ein separates Judge-Modell den Abschluss mit dem Status „done“, „continue“ oder „waiting“ bewertet; /subagents zeigt eine Modellauswahl für die eingebauten Subagenten.
Modelle und Modellzugang
Mastra Code nutzt den Mastra Model Router, der Anfragen anhand der Modell-ID und verfügbarer Zugangsdaten automatisch an den passenden Anbieter leitet. Für Mastra Code selbst dokumentiert code.mastra.ai native Anbindung per API-Schlüssel oder Provider-Abo an Anthropic (Claude Max), OpenAI (ChatGPT Plus/Codex), Google Gemini, DeepSeek, Cerebras und Kimi For Coding; über den zugrunde liegenden Model Router ist laut mastra.ai/models grundsätzlich eine deutlich größere Zahl weiterer Anbieter erreichbar. Für einen eigenen Endpunkt trägt man über /custom-providers Name, Basis-URL, optionalen API-Schlüssel und Modell-IDs eines OpenAI-kompatiblen Providers ein. Damit lässt sich der Modellzugriff grundsätzlich über einen zentralen Proxy wie unser AI Gateway führen, indem dessen Endpunkt als eigener Provider hinterlegt wird.
Einsatz im Unternehmen: Datenschutz und Governance
Laut Dokumentation sammelt Mastra Code standardmäßig anonyme Produktanalysen – Betriebssystem, Versionsnummern, CPU-Architektur, eine aus dem Hostnamen abgeleitete ID sowie Nutzung von Sessions, Prompts und Slash-Befehlen; Prompt-Text, Nachrichteninhalte, Dateipfade und Tool-Eingaben werden laut Dokumentation ausdrücklich nicht erfasst, abschalten lässt sich dies über die Umgebungsvariable MASTRA_TELEMETRY_DISABLED=1. Threads, Nachrichten, Token-Nutzung und Observational Memory bleiben laut Produktankündigung standardmäßig lokal gespeichert (technisch laut Konfigurationsdokumentation über eine lokale LibSQL-Datei) und werden nicht automatisch übertragen; für Teams beschreibt die Dokumentation zusätzlich Remote-LibSQL (Turso)- und PostgreSQL-Backends. Die vier Freigabekategorien Lesen, Bearbeiten, Ausführen und MCP lassen sich über /settings oder programmatisch einzeln auf Erlauben, Nachfragen oder Verweigern setzen; ein zentrales Unternehmens-SSO für Mastra Code selbst ist nicht dokumentiert. Unverändert gilt: Sobald ein Cloud-Modellanbieter oder ein Provider-Abo genutzt wird, gehen Quellcode und Prompts an diesen Anbieter – das gehört vorab in Ihr Verarbeitungsverzeichnis.
Mastra Code mit herdr orchestrieren
herdr überwacht mehrere Coding-Agenten gleichzeitig in einem Terminal-Multiplexer. Laut herdr-Dokumentation erkennt es MastraCode ausschließlich über installierte Lifecycle-Hooks und liefert darüber sowohl Zustands- als auch Sitzungsinformationen – ohne den bei anderen Harnesses üblichen Screen-Manifest-Fallback.
Einordnung: Entwickler-Harness und Unternehmens-Harness
Mastra Code ist ein Terminal-Werkzeug für Entwickler, die im Coding-Alltag lang laufende Projekte ohne Kontextverlust bearbeiten wollen. Für Fachanwender ohne Terminal im gesamten Unternehmen ist CompanyGPT der passende Harness: Werkzeuge über MCP-Server und Integrationen, Rollen aus Entra ID oder Keycloak und Audit-Logs für Governance. Unser AI Gateway liefert dafür die gemeinsame Kosten- und Governance-Schicht über verschiedene Harnesses und Modellanbieter hinweg. Weitere Agent-Harnesses zeigt unsere Harness-Übersicht. Wenn Sie prüfen möchten, wie sich ein Terminal-Coding-Agent wie Mastra Code sicher und kostentransparent in Ihre Entwicklungsumgebung einfügt, sprechen Sie uns an.