Can I search for relationships between code nodes?

Yes, ast-grep excels at relational searches using rules like 'inside' or 'has' to find patterns within specific contexts, such as a specific method call inside a class constructor.

Which programming languages does this skill support?

It supports a wide range of popular languages including JavaScript, TypeScript, Python, Rust, C++, Java, and Go, leveraging tree-sitter for parsing.

What is the difference between ast-grep and standard grep?

Unlike standard grep which searches for literal text strings, ast-grep understands the syntax and structure of code (AST), allowing it to find logical patterns regardless of spacing, comments, or formatting.

How do I debug a search rule that isn't returning results?

You can use the --debug-query flag with 'cst' or 'ast' to inspect how the code is being parsed and identify the correct node 'kinds' for your rule.

AST-Grep Structural Code Search

Name: AST-Grep Structural Code Search
Author: ast-grep

byast-grep

•

470

開発者ツール

Performs precise, structural code searches and analysis using Abstract Syntax Tree patterns across multiple programming languages.

概要

The ast-grep skill empowers Claude to perform advanced code discovery by leveraging structural matching rather than simple text-based searching. By understanding the Abstract Syntax Tree (AST) of a codebase, it allows for highly specific queries such as finding functions missing error handling or identifying specific API call patterns within nested contexts. This skill provides a comprehensive workflow for translating natural language into ast-grep rules, testing them against code samples, and executing searches across large-scale repositories to facilitate deep code auditing and refactoring.

主な機能

Support for relational queries like 'inside', 'has', and 'precedes'
470 GitHub stars
Natural language to ast-grep rule translation and generation
Multi-language support including JavaScript, Python, and TypeScript
Structural pattern matching using Abstract Syntax Tree (AST) logic
AST structure debugging for precise node identification

ユースケース

Identifying complex code patterns like async functions missing try-catch blocks
Finding code within specific logical contexts that text-based search misses
Auditing large codebases for specific structural characteristics or API usage

概要

主な機能

Support for relational queries like 'inside', 'has', and 'precedes'
470 GitHub stars
Natural language to ast-grep rule translation and generation
Multi-language support including JavaScript, Python, and TypeScript
Structural pattern matching using Abstract Syntax Tree (AST) logic
AST structure debugging for precise node identification

ユースケース

Identifying complex code patterns like async functions missing try-catch blocks
Finding code within specific logical contexts that text-based search misses
Auditing large codebases for specific structural characteristics or API usage