Was ist ast-grep?
ast-grep findet Code anhand seiner Struktur statt seines Textes. Du schreibst ein Muster, das wie gewöhnlicher Code aussieht, etwa `$A && $A()`, mit Platzhaltern für die veränderlichen Teile, und es findet jede Stelle im Code mit dieser Form, unabhängig von Leerzeichen oder Variablennamen. Dieselben Muster treiben YAML-Lint-Regeln (`ast-grep scan`), Regeltests und Umschreibungen an, gesammelt oder einzeln mit `--interactive`. Es parst mit tree-sitter und unterstützt ab Werk 28 Sprachen, von Bash und C bis TypeScript und Zig.
Das Projekt unter der Leitung von Herrington Darkholme steht unter MIT-Lizenz, ist in Rust geschrieben und hat rund 16.600 GitHub-Sterne; Version 0.51.2 erschien am 11. November 2026. Es lässt sich über Homebrew, npm, pip, cargo, MacPorts oder Nix installieren und bringt außerdem APIs für JavaScript, Python und WebAssembly, einen Language Server für Editoren und einen JSON-Ausgabemodus mit. Für Coding-Agenten gibt es den Befehl `outline` (eine Alpha-Vorschau seit 0.44.0), einen offiziellen Agent-Skill und einen experimentellen MCP-Server.
Lohnt sich ast-grep?
Textsuche ist für die meisten Refactorings das falsche Werkzeug, und Agenten machen diesen Fehler schneller als Menschen. Eine Regex, die einen Funktionsaufruf umschreibt, ändert dieselben Wörter auch in einem Kommentar, einem String und einer Variablen mit gleichem Namen. ast-grep parst die Datei zuerst, ein Muster trifft also nur echten Code dieser Form. Deshalb ist es zu einer üblichen Abhängigkeit in Agent-Setups geworden: npm zählte rund 9,6 Millionen Downloads von @ast-grep/cli in den 30 Tagen bis zum 12. November 2026, eine Zahl, die CI und transitive Installationen einschließt, nicht nur Menschen, die Befehle tippen.
Das Design hält die Muster lesbar. Statt eine Abfragesprache zu lernen, schreibst du Code mit Metavariablen und ergänzt YAML-Regeln (inside, has, not, any), wenn ein Muster allein nicht genügt. Regeln können einen Fix, einen Schweregrad und Tests mitbringen, was aus einmaligen Suchen einen Projekt-Linter macht. Die Releases kommen regelmäßig, mit 0.51.1 am 2. November und 0.51.2 neun Tage später, und die Historie zählt mehr als 100 Mitwirkende.
Der Haken: Es sieht nur Syntax. Die FAQ sagen klar, dass es keine Scope-, Typ-, Kontrollfluss-, Datenfluss- oder Taint-Analyse gibt; es kann also keine Variable eines bestimmten Typs finden und keine Nutzereingabe bis zu einem Datenbankaufruf verfolgen. Für Sicherheitsregeln dieser Art gehen Semgrep oder CodeQL weiter. Muster müssen außerdem Code sein, den tree-sitter parsen kann, was bei Fragmenten wie einem einzelnen JSON-Schlüssel stolpern lässt, und unter Linux kollidiert der kurze Alias `sg` mit dem Systembefehl setgroups. Der MCP-Server gilt als experimentell und läuft über Python und uv, daher sind die meisten Agenten mit der CLI und dem Skill besser bedient.
Unser Fazit: ast-grep ist ein grep, das weiß, wo ein Funktionsaufruf beginnt und endet. Lass den Agenten es für jede Suche und Umschreibung nutzen, die eine Form hat, und behalte ein typbewusstes Werkzeug für Fragen nach der Bedeutung.
Wo es sich lohnt
Ein Platform Engineer in einem großen TypeScript-Monorepo
Einen veralteten Logging-Aufruf überall ersetzen, ohne Kommentare oder Strings anzufassen
Ein Muster mit Fix schreiben, mit `ast-grep run --interactive` prüfen und dann auf den ganzen Baum anwenden. Läuft lokal in den meisten Repos in Sekunden und kostet nichts; alles, was von Typen abhängt, braucht weiter den Compiler.
Ein Tech Lead, der Hausregeln in der CI durchsetzt
Neuen Code blockieren, der eine interne API falsch aufruft
YAML-Regeln in ein sgconfig.yml-Projekt legen, jeder einen Testfall geben und `ast-grep scan` in der Pipeline ausführen. Die Regeln liegen im Repo und werden wie Code reviewt, ohne Lizenzgebühr.
Eine Entwicklerin, die Claude Code in einer unbekannten Codebasis einsetzt
Den Agenten Code nach Struktur statt per Regex finden und bearbeiten lassen
CLI und offiziellen Agent-Skill installieren, damit der Agent ast-grep-Regeln schreibt, und `ast-grep outline` die Symbole einer Datei auflisten lassen, bevor er sie ganz liest. Weniger Fehlbearbeitungen; outline ist noch eine Alpha-Vorschau.
Bevor du dich festlegst
- Einrichtung
- `brew install ast-grep`, `npm i @ast-grep/cli -g`, `pip install ast-grep-cli` oder `cargo install ast-grep --locked`; eine erste Suche dauert eine Minute. `ast-grep new` legt ein Regelprojekt an.
- Integrationen
- 28 eingebaute Sprachen und eigene über tree-sitter, ein Language Server für VS Code und andere Editoren, JSON-Ausgabe, APIs für JavaScript (napi), Python und WebAssembly, ein Online-Playground, das Plugin ast-grep/agent-skill und der experimentelle Server ast-grep-mcp.
- Daten und Datenschutz
- Läuft vollständig auf deinem Rechner mit lokalen Dateien; weder Konto noch Netzwerkdienst sind beteiligt. MIT-Lizenz.
- Kosten im großen Maßstab
- Kostenlos, ohne Bezahlstufe. Der Maintainer nimmt GitHub Sponsors an; die Kosten im großen Maßstab sind das Schreiben und Testen der Regeln.
- Grenzen
- Nur Syntax: keine Typ-, Scope-, Kontrollfluss-, Datenfluss- oder Taint-Analyse. Muster müssen parsebarer Code sein. `outline` ist eine Alpha-Vorschau, deren Sprachabdeckung sich ändern kann. Rund 46 offene Issues und Pull Requests bei der letzten Prüfung.
Was gut ist
- Muster werden als gewöhnlicher Code mit Platzhaltern geschrieben
- 28 eingebaute Sprachen über tree-sitter
- Suche, Lint-Regeln mit Tests und Umschreibungen in einer Binärdatei
- APIs für JavaScript, Python und WebAssembly plus Language Server
Was nicht
- Keine Typ-, Scope- oder Datenflussanalyse
- Muster müssen gültiger Code sein, was Einsteiger verwirrt
- Alias `sg` kollidiert mit einem Linux-Systembefehl
- MCP-Server ist noch experimentell
Am besten für
Entwickler und Coding-Agenten, die präzise, wiederholbare Suchen und Codemods in einer großen Codebasis brauchen, ohne ein Compiler-Plugin zu schreiben.
Alternativen zu ast-grep
ast-grep: häufige Fragen
- Lohnt sich ast-grep?
- ast-grep ist das Werkzeug für strukturelle Suche, das ein Coding-Agent bekommen sollte, bevor er zu sed greift, solange niemand den syntaktischen Abgleich für semantische Analyse hält. Wir bewerten es mit 4.5 von 5.
- Was kostet ast-grep?
- Kostenlos und Open Source (MIT).
- Welche Nachteile hat ast-grep?
- Keine Typ-, Scope- oder Datenflussanalyse; Muster müssen gültiger Code sein, was Einsteiger verwirrt; Alias `sg` kollidiert mit einem Linux-Systembefehl; MCP-Server ist noch experimentell.
- Für wen eignet sich ast-grep?
- Entwickler und Coding-Agenten, die präzise, wiederholbare Suchen und Codemods in einer großen Codebasis brauchen, ohne ein Compiler-Plugin zu schreiben.
- Was kostet ast-grep für ein Team oder im Produktivbetrieb?
- Kostenlos, ohne Bezahlstufe. Der Maintainer nimmt GitHub Sponsors an; die Kosten im großen Maßstab sind das Schreiben und Testen der Regeln.
- Ist ast-grep sicher für Firmendaten?
- Läuft vollständig auf deinem Rechner mit lokalen Dateien; weder Konto noch Netzwerkdienst sind beteiligt. MIT-Lizenz.
- Was sind die besten Alternativen zu ast-grep?
- Die nächsten Alternativen, die wir getestet haben, sind grepai, Repowise und jevgrep.
Antworten geprüft am 13. Nov. 2026.
Du entwickelst ast-grep? Zeig diese Bewertung auf deiner Website
