Euthynos

Ein Agent, der eine Datei liest, kann sehen, wovon diese Datei abhängt. Er kann nicht sehen, was von der Datei abhängt. Eingehende Kanten sind von innen unsichtbar, daher kompensieren Agenten, indem sie mehr Dateien lesen, was Kontext verbraucht und dennoch Aufrufer übersieht. Euthynos beantwortet diese Fragen stattdessen aus dem AST, dem Importgraphen und der Git-Historie — keine LLM-Aufrufe, kein Netzwerk im Abfragepfad.

Es liefert Nachweise. Es bescheinigt nicht, dass eine Änderung sicher ist.

Installation

Global installieren. Das -g ist wichtig: Es legt den Befehl euthynos auf Ihren PATH, damit Ihr MCP-Client den Server starten kann.

npm install -g euthynos

Überprüfen Sie vor dem Verbinden, ob die Installation erfolgreich war:

euthynos --help

Dann registrieren Sie es bei Ihrem Agenten:

claude mcp add euthynos -- euthynos mcp

Oder in einer beliebigen MCP-Client-Konfiguration:

{ "mcpServers": { "euthynos": { "command": "euthynos", "args": ["mcp"] } } }

Erfordert Node.js 18+. Funktioniert unter Windows, macOS und Linux.

Fast immer eine lokale Installation anstelle einer globalen. npm install euthynos ohne -g legt die Binärdatei in ./node_modules/.bin/ ab, was nicht auf Ihrem PATH liegt, sodass Ihr MCP-Client nichts ausführen kann. Überprüfen Sie mit:

npm ls -g euthynos --depth=0

Wenn dies (leer) ausgibt, installieren Sie mit -g neu. Um die versehentliche lokale Kopie zu entfernen, löschen Sie den Ordner node_modules und die package.json, die in dem Verzeichnis erstellt wurden, in dem Sie den Befehl ausgeführt haben.

Wenn es global installiert ist und dennoch nicht gefunden wird, ist Ihr npm-globales Bin-Verzeichnis nicht im PATH — npm config get prefix zeigt, wo es sich befindet. Oder weisen Sie Ihren Client direkt auf die Binärdatei:

{ "mcpServers": { "euthynos": { "command": "C:\\full\\path\\to\\euthynos.cmd", "args": ["mcp"] } } }

Related MCP server: codemap

Die 23 Werkzeuge, nach der Frage, die sie beantworten

Jede Antwort gibt ihren eigenen Gültigkeitsbereich an. Eine negative Antwort sagt, was nicht untersucht wurde, anstatt zu implizieren, dass nichts existiert.

Gemessen, nicht behauptet

M2 ist ein vorab registrierter Benchmark: Die Aufgaben, Gültigkeitsregeln und Antwortschlüssel wurden vor dem Start einer Sitzung per Commit eingefroren, der Rückruf wurde blind anhand der endgültigen Antworten manuell bewertet, und die ungültigen Sitzungen werden zusammen mit den gültigen veröffentlicht. Gleiches Modell, gleiches Repository, gleiche Eingabeaufforderungen — ein Arm mit Euthynos, einer ohne.

Bei den drei Aufgaben, die vollständig gemessen wurden:

Der Rückruf war in beiden Armen identisch und perfekt — jeweils 42 von 42 erforderlichen Elementen — während der Euthynos-Arm 13–31 % weniger frische Tokens verwendete. Der Agent gelangte zur gleichen Antwort, nachdem er weniger gelesen hatte. Eine vorab registrierte Falle, die einen plausiblen falschen Aufrufer induzieren sollte, löste in keinem der Arme aus.

Was dies nicht aussagt. 21 von 46 versuchten Sitzungen waren gültig; eine externe Ratenbegrenzungsmauer nahm 14 davon. Geführte Bearbeitungs- und Orientierungsaufgaben wurden nie gemessen und es wird keine Zahl für sie impliziert. Ein Testrahmen, ein Repository. Dies ist eingesparte Arbeit, nicht verbesserte Antwortqualität — und wir veröffentlichen lieber diesen Satz als eine größere Zahl.

Es werden keine Latenzzahlen veröffentlicht. Zwei intern gültige Messungen stimmten nicht überein, und das kontrollierte Experiment, das dies geklärt hätte, konnte nicht abgeschlossen werden. Daher veröffentlichen wir keine und liefern stattdessen den Testrahmen aus — docs/PROVENANCE.md enthält die Begründung.

Lokal zuerst

• Es wird nichts vom Abfragepfad hochgeladen. Der MCP-Server tätigt keine Netzwerkaufrufe und keine LLM-Aufrufe. Er liest Ihren Arbeitsbaum, einschließlich nicht festgeschriebener Bearbeitungen.

• Schreibgeschützt. Er ändert niemals Ihren Quelltext.

• Pfad-gekapselt. Der Server fixiert seine bedienbaren Wurzeln beim Start; ein Pfad außerhalb wird abgelehnt. Symlinks werden nicht verfolgt.

• Ein Verzeichnis auf der Festplatte: .euthynos/ im Repository-Stammverzeichnis, das den inhaltsadressierten Index und ein lokales, nur Metadaten enthaltendes Telemetrieprotokoll enthält. Es wird mit einer eigenen .gitignore erstellt, und das Löschen kostet nur einen erneuten Scan. Deaktivieren mit EUTHYNOS_NO_INDEX=1 und EUTHYNOS_NO_TELEMETRY=1.

• Eine Ausnahme, opt-in und nur CLI: euthynos scan --ai sendet Kandidaten für doppelte Code-Schnipsel an die Anthropic-API, um Ergebnisse zu bestätigen. Es erfordert ANTHROPIC_API_KEY, ist standardmäßig deaktiviert und ist nicht Teil des MCP-Servers.

Skalierung — was wir behaupten und was nicht

Euthynos ist bis zu etwa 10.000 Dateien validiert. Unterhalb von etwa 1.500 ist es komfortabel. Oberhalb von 10.000 ist es nicht validiert und sollte nicht als funktionierend vorausgesetzt werden.

~10.000 Dateien ist die Obergrenze des validierten Bereichs, keine Garantie.

Der Speicher ist die begrenzende Einschränkung am oberen Ende, nicht die Latenz. Das geparste Korpus wird im Speicher gehalten: Ein Repository mit 10.000 Dateien benötigt einen Prozess-RSS von etwa 0,6 GB bis ~1,1 GB während einer Bearbeitungsschleife. Linear extrapoliert — eine Schätzung, keine Messung — ist ein standardmäßiger Node-Heap wahrscheinlich irgendwo zwischen 25.000 und 35.000 Dateien erschöpft. Die 60.000-Dateien-Erkennungsobergrenze im Code ist daher keine erreichbare Grenze.

Präzise Latenzzahlen werden in V1 nicht veröffentlicht. Wir haben zwei intern konsistente Messungen, die bei den größeren Größen voneinander abweichen, und das kontrollierte Experiment, das entschieden hätte, welcher zu vertrauen ist, konnte nicht abgeschlossen werden. Anstatt eine Zahl zu veröffentlichen, hinter der wir nicht stehen können, veröffentlichen wir keine und liefern den Testrahmen aus, damit Sie Ihre eigene Maschine messen können:

node scripts/measurement/gen-scale-repos.mjs
node --expose-gc scripts/measurement/measure-latency.mjs --reps=20

Die Begründung findet sich in docs/PROVENANCE.md; der Bereich und was die Leistung beeinflusst, finden Sie in docs/SUPPORTED-SCALE.md.

Andere Grenzen, die Sie vor der Installation kennen sollten:

• Die Abfertigung ist synchron. Jeweils ein Werkzeugaufruf, und der erste Kalt-Scan blockiert die Warteschlange für seine gesamte Dauer — Sekunden, die mit der Repository-Größe wachsen. Es gibt kein Timeout pro Aufruf; Ihr MCP-Client muss eines bereitstellen, das diesen ersten Aufruf toleriert.

• Index-Lesevorgänge sind nicht kostenlos und nicht skalierungsinvariant. find_symbol, read_function und find_references benötigen reale Zeit und wachsen mit der Repository-Größe. Eine frühere Version dieser Datei behauptete, sie blieben bei jeder Größe unter einer Millisekunde; diese Zahl war ein Argument-Ablehnungs-Fehlerpfad, kein Lesevorgang. Siehe docs/BENCHMARK-INTEGRITY-AUDIT.md.

• Die Bearbeitungsschleife kostet ein Vielfaches eines warmen Aufrufs, da geänderte Dateien erneut geparst werden müssen. Jede Zahl, die nicht angibt, welche der beiden gemessen wurde, sagt nicht viel aus.

• Die Zeit für den Kaltaufbau hängt von der Maschine und der Speicherumgebung ab. Der Aufbau des Index ist I/O-gebunden.

• Alle bisherigen Messungen wurden unter TypeScript durchgeführt. Andere Sprachen werden abweichen.

Sprachen

16 werden geparst, über drei Strategien. TypeScript, JavaScript und Vue SFCs über die TypeScript-Compiler-API; Python, Go, Java, Ruby, Rust, PHP, C, C++, C#, Dart, Kotlin und Swift über tree-sitter WASM; COBOL über einen deterministischen Zeilenparser.

Jede Grammatik läuft als reines WASM — keine nativen Bindungen, keine plattformangepassten Vorbauten, keine Compiler-Toolchain. Die Qualität der Call-Graph-Auflösung ist für TypeScript am stärksten.

Was Euthynos nicht behauptet

Es ist ein statischer Analysator. Es sieht Importe, Deklarationen und Aufrufkanten. Es sieht keine Reflektion, dynamischen Dispatch, Laufzeit-Codegenerierung, zeichenkettenbasierte Symbolnamen, dynamische Importe oder Framework-Verdrahtung — und es tut niemals so, als ob.

Diese Phrasen sind in seiner Ausgabe verboten, und das Verbot wird durch Tests durchgesetzt:

ist sicher · sicher zu … · keine anderen Konsumenten · alle Referenzen · unbenutzt · vollständig getestet · keine Auswirkung · jede Behauptung eines mathematischen Sicherheitsbeweises

callers_of gibt nichts zurück – das bedeutet, der statische Graph hat keine Aufrufer gefunden, niemals nichts ruft dies auf. Mehrdeutige modulübergreifende Namen erzeugen keine Kante statt einer Schätzung, sodass Antworten eine untere Schranke darstellen und die Anzahl unaufgelöster Aufrufe mit ausgegeben wird.

Überzeugen Sie sich selbst

Nichts hier verlangt, dass Sie Zahlen blind glauben:

Der letzte Punkt ist kein Zufall der Offenlegung. Zwei unserer Benchmark-Harnesses haben Zeitmessungen von Argumentvalidierungsfehlern fälschlicherweise als Messungen behandelt, und eine veröffentlichte Behauptung war um drei Größenordnungen falsch. Das Audit dokumentiert, was kaputt ging, was ungültig wurde, was neu gemessen wurde und was weiterhin unbelegt ist.

Was nicht veröffentlicht wird: die M2-Antwortschlüssel und das vollständige Sitzungsprotokoll. Jede Aussage dazu ist von diesem Repository aus nicht verifiziert, und wir sagen das lieber, als etwas anderes zu implizieren.

Euthynos for Teams

◈  Euthynos for Teams

Die gleiche Engine, die zwischen einem Pull Request und main steht.

Noch nicht allgemein verfügbar. Es gibt heute keine öffentliche Instanz, bei der man sich anmelden kann. Dieser Abschnitt beschreibt Software, die existiert und läuft – damit Sie jetzt entscheiden können, ob sie Ihre Aufmerksamkeit verdient – nicht ein Produkt, das Sie sofort kaufen können. Zur Early-Access-Liste auf euthynos.dev beitreten →

Verbinden Sie ein Repository über eine GitHub-App. Jeder Push und jeder Pull Request wird serverseitig von der Engine in diesem Repository gescannt, und das Ergebnis landet dort, wo die Entscheidung tatsächlich getroffen wird.

◈ Merge-Policy, als Regeln geschrieben

Fünf Regeltypen, jeweils warn oder block:

Grenzen werden serverseitig durchgesetzt. Das Formular dient der Bequemlichkeit; es ist nicht der Validator.

◈ Der Abhängigkeitsgraph, pro Scan

Jeder Scan erzeugt ein interaktives Graph-Artefakt – Module, Importkanten und die Zyklen, die sich nicht sauber durchtrennen lassen.

Bewertet auf vier Achsen plus Duplikation:

tiefe · nähte · lokalität · hebelwirkung

Jeweils als Band gemeldet – Stark, Stabil, Abdriftend, Gefährdet – weil das Band der Teil ist, der etwas bedeutet.

◈ Ein Check-Run bei jedem PR

Das Urteil wird zusammen mit der Regel aufgezeichnet, die es hervorgebracht hat, sodass „Warum wurde ich blockiert?" eine Antwort hat, die keine Bauchgefühl ist.

Alert-Zustände bleiben über Scans hinweg erhalten: neu · laufend · gelöst · archiviert-bis-schlechter · rückfällig.

◈ Nachweise, die ein Prüfer lesen kann

Exportieren Sie einen Datumsbereich und erhalten Sie den damaligen Regelsatz, jedes Merge-Urteil im Zeitfenster, jede Ausnahme mit ihrem Akteur und schriftlichem Grund sowie die Eigentümerabdeckung pro Modul.

Kein Konto erforderlich, um es zu lesen.

◈ Wissensrisiko aus der Git-Historie. Eigentumsanteil und Bus-Faktor pro Modul – sodass „das schwächste Modul wird auch nur von einer Person verstanden" etwas ist, das Ihnen das Dashboard sagt, und nicht etwas, das Sie herausfinden, wenn diese Person geht.

Auch hier null LLM-Aufrufe. Derselbe Diff erzeugt jedes Mal dasselbe Urteil. Es wird nichts stichprobenartig gezogen, also gibt es nichts zu halluzinieren und nichts, in das Prompt-Injection eingeschleust werden kann. Pushen Sie denselben Branch zweimal, erhalten Sie dieselbe Überprüfung zweimal.

Die CLI in diesem Repository bleibt kostenlos, lokal und Apache-2.0 – das ist eine Zusage, kein Testlauf. Sie ruft die Plattform nicht an, und die Plattform berührt niemals Ihren Rechner.

Möchten Sie es, wenn es geöffnet wird?

→  Zur Early-Access-Liste auf euthynos.dev beitreten

Lokale CLI bleibt für immer kostenlos · keine Kreditkarte · kein Konto nötig, um irgendetwas in diesem Repository zu nutzen

CLI

Der MCP-Server ist die primäre Oberfläche, aber die CLI steht eigenständig:

euthynos scan [path]        architecture scan — six metrics, module table
euthynos graph [path]       build the call graph; --impact/--callers/--path
euthynos dashboard [path]   self-contained interactive HTML, zero runtime deps
euthynos index [path]       inspect or rebuild the local index
euthynos mcp                start the MCP stdio server

euthynos --help gibt den vollständigen Parametersatz und den Build-Stempel aus.

Dokumentation

docs/ARCHITECTURE.md · docs/SUPPORTED-SCALE.md · docs/SECURITY.md · docs/CONTRIBUTING.md · docs/TRADEMARK.md · docs/PROVENANCE.md · CHANGELOG.md

Sicherheit

Melden Sie Schwachstellen vertraulich über GitHub Security Advisories, nicht über ein öffentliches Issue. Umfang und Erwartungen: docs/SECURITY.md.

Lizenz

Apache License 2.0 – siehe LICENSE und NOTICE.

Copyright © 2026 Tonil Kumar.

Die Lizenz deckt den Code ab. Sie deckt nicht den Namen ab: „Euthynos" wird als nicht eingetragenes Markenzeichen von Tonil Kumar beansprucht – es wurde kein Eintrag beantragt oder gewährt. Siehe docs/TRADEMARK.md.