Ast grep find

Skill vibeeval/vibecosystem/skills/ast-grep-find

AST-based code search and refactoring via ast-grep MCPFrom its SKILL.md

Install

npx -y skills add vibeeval/vibecosystem --skill ast-grep-find

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

runs commandsInstructs the agent to run 4 commands, including `uv run python -m runtime.harness scripts/ast_grep_find.py --pattern "import asyncio" --language python` and 3 more.

SKILL.md

2.7 KB, 671 tokens by cl100k_base, as published. Nobody here has run it

AST-Grep Find

Structural code search that understands syntax. Find patterns like function calls, imports, class definitions - not just text.

When to Use

Find code patterns (ignores strings/comments)
Search for function calls, class definitions, imports
Refactor code with AST precision
Rename variables/functions across codebase

Usage

Search for a pattern

uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "import asyncio" --language python

Search in specific directory

uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "async def \$FUNC(\$\$\$)" --language python --path "./src"

Refactor/replace pattern

uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "console.log(\$MSG)" --replace "logger.info(\$MSG)" \
    --language javascript

Dry run (preview changes)

uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "print(\$X)" --replace "logger.info(\$X)" \
    --language python --dry-run

Parameters

Parameter	Description
`--pattern`	AST pattern to search (required)
`--language`	Language: `python`, `javascript`, `typescript`, `go`, etc.
`--path`	Directory to search (default: `.`)
`--glob`	File glob pattern (e.g., `*/.py`)
`--replace`	Replacement pattern for refactoring
`--dry-run`	Preview changes without applying
`--context`	Lines of context (default: 2)

Pattern Syntax

Syntax	Meaning
`$NAME`	Match single node (variable, expression)
`$$$`	Match multiple nodes (arguments, statements)
`$_`	Match any single node (wildcard)

Examples

# Find all function definitions
uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "def \$FUNC(\$\$\$):" --language python

# Find console.log calls
uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "console.log(\$\$\$)" --language javascript

# Replace print with logging
uv run python -m runtime.harness scripts/ast_grep_find.py \
    --pattern "print(\$X)" --replace "logging.info(\$X)" \
    --language python --dry-run

vs morph/warpgrep

Tool	Best For
ast-grep	Structural patterns (understands code syntax)
warpgrep	Fast text/regex search (20x faster grep)

Use ast-grep when you need syntax-aware matching. Use warpgrep for raw speed.

MCP Server Required

Requires ast-grep server in mcp_config.json.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.