AST-GREP

Write Code to Match Code

ast-grep(sg) is a fast and polyglot tool for code structural search, lint, rewriting at large scale.

Search and Rewrite
ast-grep is a code tool for structural search and replace. It is like syntax-aware grep/sed! You can write code patterns to locate and modify code, based on AST, in thousands of files, interactively.
sg -p '$A && $A()' -r '$A?.()'
Scan as Linter
ast-grep is a versatile and flexible tool for linting code with AST patterns. You can easily add new customized rules with intuitive syntax and enjoy pretty error reporting out of box.
sg scan
Programmatic Usage
ast-grep also provides node-js binding for manipulating syntax trees programmatically. You can use jQuery like utility methods to traverse and manipulate syntax tree nodes, or use operators to compose complex matching from simple patterns.
npm install @ast-grep/napi

⚡️

Performant

Blazing fast search and replace across thousands of source code files, powered by parallel Rust.

📚

Supports many programming languages out of box! You can also register your own tree-sitter parsers by dynamic loading.

👟

Supports multiple forms of usages from one-line command to fully programmatic interface, scaling to different scenarios.

🛠️

Not a toy but a batteries-included tool with interactive codemod, language server and testing tool.