name: ast-grep description: Read-only structural code search with ast-grep/sg. Grep/rg/sed alternative for AST-aware CLI exploration, pattern search, and fast code discovery. Activates on ast-grep/sg, structural search, AST search, find usages, tree-sitter. license: GPL-3.0-or-later metadata: author: anntnzrb allowed-tools: ""
ast-grep
Overview
Read-only CLI search with sg or ast-grep. AST-aware grep for code exploration and SWE tasks.
Quick start
- Prefer
sg. Fallbackast-grep run. Last resort:nix run nixpkgs#ast-grep -- run - Example:
sg -p 'console.log($MSG)' -l ts src - Files only:
sg -p 'console.log($$$)' -l ts --files-with-matches src
Guardrails
- Read-only: never use
--rewrite,-r,--update-all, or--interactive - Stdin requires
--lang
Resources
reference.md: flags, strictness, selectors, output formatscookbook/: troubleshooting and recipes