OpenParable
Skip to content
← Back to skills

Ast Grep Find

Development
ast-grep-find

Ast Grep Find is an Agent Skill for development published in the parcadei/Continuous-Claude-v3 repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

AST-based code search and refactoring via ast-grep MCP

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/parcadei/Continuous-Claude-v3/blob/HEAD/.claude/skills/ast-grep-find/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ast-grep-find, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

ParameterDescription
--patternAST pattern to search (required)
--languageLanguage: python, javascript, typescript, go, etc.
--pathDirectory to search (default: .)
--globFile glob pattern (e.g., **/*.py)
--replaceReplacement pattern for refactoring
--dry-runPreview changes without applying
--contextLines of context (default: 2)

Pattern Syntax

SyntaxMeaning
$NAMEMatch 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

ToolBest For
ast-grepStructural patterns (understands code syntax)
warpgrepFast 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.