¿Qué es ast-grep?
ast-grep encuentra código por su estructura y no por su texto. Escribes un patrón que parece código normal, como `$A && $A()`, con marcadores para las partes que cambian, y localiza cada lugar del código con esa forma, sin importar los espacios ni los nombres de variables. Los mismos patrones alimentan reglas de lint en YAML (`ast-grep scan`), pruebas de reglas y reescrituras, aplicadas en bloque o una a una con `--interactive`. Analiza con tree-sitter y admite 28 lenguajes de serie, de Bash y C a TypeScript y Zig.
El proyecto, dirigido por Herrington Darkholme, tiene licencia MIT, está escrito en Rust y suma unas 16.600 estrellas en GitHub; la versión 0.51.2 salió el 11 de noviembre de 2026. Se instala desde Homebrew, npm, pip, cargo, MacPorts o Nix, y además ofrece APIs para JavaScript, Python y WebAssembly, un servidor de lenguaje para editores y un modo de salida JSON. Para agentes de código hay un comando `outline` (vista previa alfa desde la 0.44.0), una skill oficial para agentes y un servidor MCP experimental.
¿Merece la pena ast-grep?
La búsqueda de texto es la herramienta equivocada para la mayoría de las refactorizaciones, y los agentes cometen ese error más rápido que las personas. Una regex que reescribe una llamada a función también reescribe las mismas palabras en un comentario, en una cadena y en una variable que comparte el nombre. ast-grep analiza primero el archivo, así que un patrón solo coincide con código real de esa forma. Por eso se ha convertido en una dependencia habitual en las configuraciones de agentes: npm contó unos 9,6 millones de descargas de @ast-grep/cli en los 30 días hasta el 12 de noviembre de 2026, una cifra que incluye CI e instalaciones transitivas, no solo personas tecleando comandos.
El diseño mantiene los patrones legibles. En lugar de aprender un lenguaje de consultas, escribes código con metavariables y añades reglas YAML (inside, has, not, any) cuando un patrón solo no basta. Las reglas pueden llevar una corrección, una severidad y pruebas, lo que convierte búsquedas puntuales en un linter del proyecto. El ritmo de versiones es constante, con la 0.51.1 el 2 de noviembre y la 0.51.2 nueve días después, y el historial tiene más de 100 colaboradores.
La pega: solo ve sintaxis. Las FAQ dicen claramente que no hace análisis de ámbito, tipos, flujo de control, flujo de datos ni taint, así que no puede encontrar una variable de un tipo concreto ni seguir una entrada de usuario hasta una llamada a la base de datos. Para reglas de seguridad de ese tipo, Semgrep o CodeQL llegan más lejos. Los patrones también deben ser código que tree-sitter pueda analizar, lo que confunde con fragmentos como una clave JSON suelta, y en Linux el alias corto `sg` choca con el comando setgroups del sistema. El servidor MCP está marcado como experimental y funciona con Python y uv, así que a la mayoría de los agentes les sirven mejor la CLI y la skill.
Nuestra opinión: piensa en ast-grep como un grep que sabe dónde empieza y acaba una llamada a función. Deja que el agente lo use para cada búsqueda y reescritura que tenga forma, y guarda una herramienta con tipos para las preguntas sobre significado.
Dónde se gana su sitio
Un ingeniero de plataforma en un monorepo grande de TypeScript
Sustituir en todas partes una llamada de logging obsoleta sin tocar comentarios ni cadenas
Escribe un patrón con una corrección, revísalo con `ast-grep run --interactive` y aplícalo a todo el árbol. Se ejecuta en local en segundos en la mayoría de los repos y no cuesta nada; lo que dependa de tipos sigue necesitando el compilador.
Un líder técnico que impone normas internas en CI
Bloquear código nuevo que llama mal a una API interna
Añade reglas YAML a un proyecto sgconfig.yml, dale a cada una un caso de prueba y ejecuta `ast-grep scan` en el pipeline. Las reglas viven en el repo y se revisan como código, sin coste de licencia.
Un desarrollador que usa Claude Code en un código que no conoce
Que el agente busque y edite código por estructura en lugar de por regex
Instala la CLI y la skill oficial para que el agente escriba reglas de ast-grep, y deja que `ast-grep outline` liste los símbolos de un archivo antes de leerlo entero. Menos ediciones erróneas; outline sigue en vista previa alfa.
Antes de decidirte
- Puesta en marcha
- `brew install ast-grep`, `npm i @ast-grep/cli -g`, `pip install ast-grep-cli` o `cargo install ast-grep --locked`; una primera búsqueda lleva un minuto. `ast-grep new` crea la estructura de un proyecto de reglas.
- Integraciones
- 28 lenguajes integrados y otros propios mediante tree-sitter, un servidor de lenguaje para VS Code y otros editores, salida JSON, APIs para JavaScript (napi), Python y WebAssembly, un playground en línea, el plugin ast-grep/agent-skill y el servidor experimental ast-grep-mcp.
- Datos y privacidad
- Se ejecuta por completo en tu equipo sobre archivos locales; no intervienen cuentas ni servicios de red. Licencia MIT.
- Coste a escala
- Gratuito, sin plan de pago. El mantenedor acepta GitHub Sponsors; el coste a escala es escribir y probar las reglas.
- Límites
- Solo sintaxis: sin análisis de tipos, ámbito, flujo de control, flujo de datos ni taint. Los patrones deben ser código analizable. `outline` es una vista previa alfa cuya cobertura de lenguajes puede cambiar. Unas 46 issues y pull requests abiertas en la última comprobación.
Lo bueno
- Los patrones se escriben como código normal con marcadores
- 28 lenguajes integrados mediante tree-sitter
- Búsqueda, reglas de lint con pruebas y reescrituras en un solo binario
- APIs para JavaScript, Python y WebAssembly, más un servidor de lenguaje
Lo malo
- Sin análisis de tipos, ámbito ni flujo de datos
- Los patrones deben ser código válido, lo que confunde a los recién llegados
- El alias `sg` choca con un comando del sistema en Linux
- El servidor MCP sigue siendo experimental
Ideal para
Desarrolladores y agentes de código que necesitan búsquedas y codemods precisos y repetibles en un código grande sin escribir un plugin de compilador.
Alternativas a ast-grep
ast-grep: preguntas frecuentes
- ¿Merece la pena ast-grep?
- ast-grep es la herramienta de búsqueda estructural que conviene dar a un agente de código antes de que recurra a sed, siempre que nadie confunda su coincidencia sintáctica con un análisis semántico. Le damos un 4.5 sobre 5.
- ¿Cuánto cuesta ast-grep?
- Gratuito y de código abierto (MIT).
- ¿Qué inconvenientes tiene ast-grep?
- Sin análisis de tipos, ámbito ni flujo de datos; los patrones deben ser código válido, lo que confunde a los recién llegados; el alias `sg` choca con un comando del sistema en Linux; el servidor MCP sigue siendo experimental.
- ¿Para quién es ast-grep?
- Desarrolladores y agentes de código que necesitan búsquedas y codemods precisos y repetibles en un código grande sin escribir un plugin de compilador.
- ¿Cuánto cuesta ast-grep para un equipo o en producción?
- Gratuito, sin plan de pago. El mantenedor acepta GitHub Sponsors; el coste a escala es escribir y probar las reglas.
- ¿Es ast-grep seguro para los datos de la empresa?
- Se ejecuta por completo en tu equipo sobre archivos locales; no intervienen cuentas ni servicios de red. Licencia MIT.
- ¿Cuáles son las mejores alternativas a ast-grep?
- Las alternativas más cercanas que hemos analizado son grepai, Repowise y jevgrep.
Respuestas comprobadas el 13 nov 2026.
¿Desarrollas ast-grep? Muestra esta nota en tu web
