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. Fallback ast-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 formats
• cookbook/: troubleshooting and recipes