# ast-grep Structural Code Search and Rewrite

> Use ast-grep (sg) to search, lint, and rewrite code across large codebases using AST pattern matching. A blazing-fast alternative to regex-based code transformations that understands syntax structure.

- Skill: `agentskillexchange/ast-grep-structural-code-search-and-rewrite` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/ast-grep-structural-code-search-and-rewrite`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/ast-grep-structural-code-search-and-rewrite/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/ast-grep-structural-code-search-and-rewrite

---


# ast-grep Structural Code Search and Rewrite

Use ast-grep (sg) to search, lint, and rewrite code across large codebases using AST pattern matching. A blazing-fast alternative to regex-based code transformations that understands syntax structure.

## Installation

Use the upstream install or setup path that matches your environment:
- npm install --global @ast-grep/cli
- pip install ast-grep-cli
- brew install ast-grep
- cargo install ast-grep --locked

Requirements and caveats from upstream:
- You can use $ sign + upper case letters as a [wildcard](https://en.wikipedia.org/wiki/Wildcard_character), e.g. $MATCH, to match any single AST node. Think of it as [regular expression dot](https://regexone.com/lesson...
- You can install it from [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm), [pip](https://pypi.org/), [cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html), [cargo-binstall](...

Basic usage or getting-started notes:
- bash
- # pnpm approve-builds may be needed
- <details>

- Source: https://github.com/ast-grep/ast-grep
- Extracted from upstream docs: https://raw.githubusercontent.com/ast-grep/ast-grep/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/ast-grep-structural-code-search-rewrite/)