ast-grep review
A strong open-source choice for structural search, codemods, and custom linting.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
ast-grep is an open-source command-line tool for developers who need structural code search, linting, rewriting, or codemod work. Instead of matching only plain text, it works with abstract syntax tree patterns and supports regular-expression matching within AST nodes. Its scope covers codebase search, code navigation, code outlines for symbols, imports, and exports, and programmatic AST manipulation through JavaScript and Python APIs. Developers working on Windows, macOS, or Linux can install it locally, with editor integrations for Visual Studio Code, Neovim, and Emacs.
The strongest fit is for teams building repeatable code transformations or custom static-analysis workflows. Code rewriting and interactive codemods support one-off changes as well as larger migrations, while custom YAML lint rules let developers define project-specific checks. The language server adds diagnostic and fix actions, and the online playground provides another way to work with the tool. Multi-language parsing through tree-sitter broadens its use across repositories, although the practical fit depends on whether the relevant languages are among its built-in language support.
ast-grep is distributed as open-source software and installed locally, making it a self-hosted option rather than a paid hosted service with separate tiers. That model suits developers who want direct control over their code-search and rewriting workflow, but it places setup and ongoing maintenance with the user. Choose ast-grep when structural matching, codemods, lint rules, or editor-based fixes are central requirements. For a developer who only needs straightforward text search, its AST-oriented approach may introduce more capability than necessary.
ast-grep pros and cons
- Where it wins
- AST patterns support structural search beyond plain-text matching
- Codemods, lint rules, and rewrites cover several code-maintenance workflows
- Works across Windows, macOS, Linux, and three major editors
- Where it doesn't
- Self-hosted installation requires local setup and maintenance
- Built-in language support varies by the languages in your codebase
- Structural workflows may be more than needed for simple text search
ast-grep fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update