Guía de Antigravity CLI: Cómo instalar, configurar MCP MySQL y uso para Dev

Antigravity CLI (la evolución directa y el nuevo ecosistema de Gemini CLI) es un asistente de inteligencia artificial que podemos emplear de forma totalmente local en nuestra PC o computadora.

Podemos utilizarlo mediante la terminal, la CMD o cualquier consola que estés usando. En mi caso, como estoy en Mac, uso la terminal; si estás en Windows, usarías la CMD.

A mí, como desarrollador, lo que más me interesa es poder crear y administrar proyectos con este asistente por línea de comandos. Sin embargo, se puede usar para muchas otras cosas: por ejemplo, si tienes una carpeta llena de vídeos sin organizar, puedes pedirle que te ayude a clasificarlos. En definitiva, permite automatizar muchas tareas en tu computadora.

Por qué usar Antigravity (Gemini CLI) localmente

Usar Antigravity CLI tiene varias ventajas frente a las herramientas web tradicionales o el ecosistema estándar de Gemini CLI:

• Mayor control: puedes decidir dónde se ejecutan tus archivos y cómo se gestionan los resultados.
• Automatización real: ideal para tareas repetitivas, como clasificar documentos, generar reportes o crear contenido en lote.
• Integración con proyectos: si ya trabajas con Node.js o Python, puedes integrar la IA directamente en tus flujos de backend.
• Rendimiento: menos consumo de recursos y ejecución inmediata desde la terminal.

En mi caso, lo empleo sobre todo para crear y gestionar proyectos. Pero también lo he usado para organizar carpetas con vídeos, donde Antigravity me ayudó a clasificar automáticamente el contenido según el nombre y el formato.

Qué es Antigravity CLI y para qué sirve

Antigravity CLI es la interfaz de línea de comandos de última generación basada en los modelos de Google. Es la forma avanzada de usar Gemini directamente desde tu terminal, sin necesidad de abrir el navegador ni depender de la interfaz web estándar.

Con esta herramienta puedes crear proyectos, ejecutar tareas automáticas, generar contenido, analizar archivos o interactuar con APIs, todo con simples comandos integrados.

Como trabajo desde Mac, me resulta muy cómodo ejecutar estos comandos en la terminal. Si usas Windows, puedes hacer exactamente lo mismo desde la CMD, y si estás en Linux, desde tu consola habitual. Es ideal si quieres aprovechar la potencia de los modelos Gemini 2.5 y superiores sin distracciones visuales, en un entorno rápido, limpio y local.

Características y límite de peticiones

En resumen, es un asistente enfocado en ejecutar tareas en tu computadora. El plan de acceso gratuito sigue esquemas muy generosos y cómodos para el desarrollo:

• Versión gratuita: 60 peticiones por minuto y 1.000 peticiones al día.
• Versión de pago: para quienes necesiten más capacidad de cómputo o un volumen de llamadas superior.

Creo que el plan gratuito es más que suficiente para la mayoría. Y si llegas al límite diario, siempre puedes cambiar de cuenta o esperar al día siguiente.

Ejemplos de uso con la CLI

• Automatizar tareas de sistema.
• Crear proyectos y andamiajes de código (scaffolding).
• Hacer peticiones directas y flujos encadenados.
• Generar e interactuar con archivos multimedia de forma local.

Instalación de Antigravity CLI paso a paso

Para instalarlo, vamos al apartado de instalación del repositorio oficial. Antigravity CLI se distribuye mediante Node.js, por lo que es necesario tenerlo configurado previamente en tu sistema.

Paso 1: Instalar Node.js

Si no tienes Node instalado en tu equipo:

1. Ve a la página oficial (nodejs.org).
2. Descarga la versión recomendada (LTS) para tu sistema operativo.
3. Instálala con el clásico "Next → Next → Finish".

Esto instalará automáticamente npm, el manejador de paquetes que utilizaremos a continuación.

Paso 2: Instalar el paquete de Antigravity

Abre tu terminal y ejecuta el comando de instalación global. Si buscas la compatibilidad clásica con el ecosistema de Gemini CLI, el nuevo comando de Antigravity lo gestiona todo:

$ sudo npm install -g @antigravity/cli

• El prefijo sudo se usa en Mac/Linux porque es una instalación global en el sistema.
• Una vez finalizado el proceso, podrás invocar el asistente escribiendo simplemente antigravity en tu consola.

Actualizar la herramienta

Para mantener el entorno al día con los últimos modelos y parches, puedes actualizarlo con:

$ sudo npm update -g @antigravity/cli

Primeros comandos y configuración inicial

Una vez instalado, puedes iniciar el asistente en modo interactivo escribiendo:

$ antigravity

Aparecerá el prompt en la consola y podrás comenzar a interactuar en lenguaje natural.

Ejemplos prácticos en la terminal

Crear un nuevo proyecto con estructura base:

$ antigravity new proyecto-ai

Automatizar una tarea de ordenamiento local:

$ antigravity "ordena mis archivos por tipo"

Generar un resumen o analizar un archivo de código:

$ antigravity "genera un resumen del archivo readme.md"

Integraciones útiles

Puedes combinar Gemini CLI con herramientas como:

• Google APIs (Drive, Docs, Sheets).
• Git para generar commits inteligentes.
• Node scripts para automatizar flujos completos.
• Configurar tu primer MCP MySQL en Antigravity CLI

Antigravity Agent VS Antigravity CLI: ¿Cuál es mejor para programar?

Es común preguntarse cuál es la diferencia entre los agentes integrados en el editor y las herramientas de terminal como Gemini CLI o Antigravity CLI. Veamos cómo se complementan en la programación.

El Enfoque del Agente (Extensiones IDE)

Un Agente IA en el editor es simplemente una extensión para VS Code, similar a GitHub Copilot. Vas a la sección de extensiones, buscas el agente e instalas. Una vez autenticado, trabajas visualmente sobre tu código seleccionando texto, presionando combinaciones como Ctrl + I o interactuando con botones en la interfaz gráfica.

El Enfoque de la CLI (Antigravity CLI)

Por otro lado, Antigravity CLI funciona directamente en la raíz de tu sistema mediante la terminal. Aquí no hay ventanas ni botones; todo se controla mediante comandos globales precisos.

La nueva forma de programar nos posiciona muchas veces más como "reviewers" que como escritores de código puro. Herramientas avanzadas como Claude Code o Antigravity CLI nos asisten generando estructuras completas, tests automatizados, documentación o reparando bugs en lote.

Por ejemplo, haciendo pruebas para crear una aplicación en Flutter destinada a practicar inglés con preguntas de verdadero o falso, utilicé la CLI para acelerar el desarrollo:

• Le pedí al proyecto inicial en Flutter que agregara páginas usando Go Router, y luego el módulo de preguntas con su respectivo modelo de datos. Generó casi todo el esquema y ahorró muchísimo trabajo.
• Detalle a tener en cuenta: Al igual que ocurría en los flujos con Gemini CLI, las IA a veces tienden a inventar campos redundantes en los modelos o instalar paquetes innecesarios (como Provider en fases tempranas) debido al sesgo de sus datos de entrenamiento. Tuvé que corregir manualmente un par de importaciones y nombres de estructuras.

Mi recomendación: Trabaja siempre con pequeñas iteraciones. No es buena idea pedirle a la IA algo masivo como “Créame una aplicación tipo Duolingo desde cero” y esperar un resultado perfecto. El prompt es el nuevo código: avanza paso a paso, revisa el código generado y mantén bases sólidas de programación para guiar el flujo.

Diferencias Principales

• Editor/Agent: Extensión visual e interactiva dentro de VS Code. Ideal para corregir, depurar y refinar líneas de código en tiempo real mientras escribes.
• Antigravity CLI (Gemini CLI): Herramienta global de terminal. Ideal para generar proyectos completos, módulos CRUD, automatizaciones de archivos o tareas amplias fuera del editor de texto.

Configura tu primer MCP MySQL en Antigravity CLI

Instalar y configurar MCPs (Model Context Protocols) localmente puede parecer intimidante al principio, pero transforma por completo el uso de la IA. Aquí te enseño cómo conectar Antigravity CLI a una base de datos MySQL local para interactuar con tus datos en lenguaje natural.

1. Qué son los MCPs y por qué instalarlos en local

Los MCPs son "puentes" que permiten a los modelos de lenguaje interactuar de forma segura con herramientas y fuentes de datos externas. Al ejecutar un MCP de manera local, garantizas el control absoluto y la privacidad de tus datos sensibles, permitiendo que la CLI consulte bases de datos locales sin exponerlas a la nube.

Las extensiones oficiales se pueden explorar desde los directorios de compatibilidad, como la sección de extensiones de Gemini CLI: https://geminicli.com/extensions/.

Precaución de seguridad crítica: Las IA con MCP local tienen acceso real a tu sistema de archivos y bases de datos. No instales extensiones de repositorios desconocidos. Revisa siempre la actividad en GitHub y los permisos que solicitan para evitar inyecciones de prompts maliciosas.

El asistente Antigravity CLI y los MCPs

Antigravity CLI es la interfaz de línea de comandos que permite instalar y gestionar estas extensiones. Gracias a los MCPs, Gemini puede conectarse a bases de datos, APIs o incluso a tu propio sistema local.

Diferencias entre MCP local y en la nube

Un MCP local se ejecuta en tu propio entorno. Esto significa mayor control y privacidad, ideal para desarrolladores que trabajan con datos sensibles o que quieren experimentar sin depender de un servidor remoto.

Cuándo conviene instalar MCPs en tu entorno

Si trabajas con datos internos, automatizas procesos o quieres desarrollar tus propios MCPs, hacerlo localmente te ahorrará tiempo y dolores de cabeza.

2. Instalación paso a paso del MCP MySQL

Para este ejemplo utilizaremos el repositorio del MCP de MySQL adaptado al entorno local:

Importante: Asegúrate de cerrar o detener Antigravity CLI en tu terminal antes de ejecutar el comando de instalación:

$ antigravity extensions install https://github.com/gemini-cli-extensions/mysql

Una vez instalado, inicia la CLI ejecutable y verifica el estado de las herramientas escribiendo:

$ /mcp

Si el sistema devuelve MySQL (disconnected), significa que la extensión se registró correctamente pero está a la espera de las credenciales de conexión.

3. Configuración del archivo .env

Crea un archivo .env en la raíz de tu espacio de trabajo para definir las variables de conexión a tu base de datos:

MYSQL_PATH="C:\Users\andre\AppData\Local\com.tinyapp.DBngin\Binaries\mysql\8.4.2\bin\mysql.exe"
MYSQL_HOST="127.0.0.1"
MYSQL_PORT="3306"
MYSQL_USER="root"
MYSQL_PASSWORD=""
MYSQL_DATABASE="ld"

Nota de experiencia: Si notas que la CLI no procesa el archivo de forma automática en la primera ejecución, indícaselo directamente en el prompt interactivo: "Lee el archivo .env para conectarte". Una vez hecho esto, el sistema mapeará las variables y recordará la configuración de forma persistente para las próximas sesiones.

4. Creación de contenido automatizado con datos reales

Una vez conectado, puedes interactuar con tu base de datos utilizando lenguaje natural puro:

• "Muéstrame todas las tablas."
• "Tráeme los registros de la tabla posts cuya categoría ID sea 34."
• "Analiza esta estructura y optimiza los índices."

El verdadero potencial de este flujo es la productividad estratégica, como la **creación de artículos pilares** para blogs técnicos de forma automatizada. Un artículo pilar actúa como un índice maestro que organiza el contenido de una categoría (como Laravel, CSS o JavaScript).

Hacer esto a mano cuando tienes más de 300 posts es increíblemente tedioso. Al conectar Antigravity CLI con el MCP MySQL, la IA analiza directamente la tabla de posts reales en tu base de datos, extrae los enlaces correspondientes, los clasifica por niveles de dificultad y genera el esqueleto del artículo estructurado con sentido pedagógico en segundos.

Aquí viene la parte más delicada: la configuración.

Crear y estructurar el archivo .env

Crea un archivo .env en la raíz de tu proyecto con las variables necesarias:

.env

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=tu_usuario
MYSQL_PASSWORD=tu_password
MYSQL_DATABASE=tu_base

Por ejemplo, en mi caso de que tengo instalado MySQL en una ruta diferente:

.env

MYSQL_PATH="C:\Users\andre\AppData\Local\com.tinyapp.DBngin\Binaries\mysql\8.4.2\bin\mysql.exe"
MYSQL_HOST="127.0.0.1"
MYSQL_PORT="3306"
MYSQL_USER="root"
MYSQL_PASSWORD=""
MYSQL_DATABASE="ld"

 “Gemini no lee el .env”

En mi caso, Gemini simplemente ignoraba el .env al inicio.

Tuve que decirle directamente, así que le dije que leyera el archivo:

“Lee el archivo .env para conectarte.”
Y respondió: “Perfecto, ya lo leí, a partir de ahora lo usaré automáticamente.”

Desde entonces, nunca más tuve ese problema.

Esto es parte de la interacción que tuve con Gemini CLI:

✦ He leído el archivo .env y he cargado la siguiente configuración:
   * MYSQL_PATH: C:\Users\andre\AppData\Local\com.tinyapp.DBngin\Binaries\mysql\8.4.2\bin\mysql.exe
   * MYSQL_HOST: 127.0.0.1
   * MYSQL_PORT: 3306
   * MYSQL_USER: root
   * MYSQL_PASSWORD: (vacía)
   * MYSQL_DATABASE: ld
  A partir de ahora, utilizaré esta configuración para todas las operaciones de base de datos.

5. Primeras pruebas y prompts útiles para MCP MySQL

Una vez conectado, puedes interactuar en lenguaje natural.

Consultas básicas, por ejemplo:

• “Muéstrame todas las tablas.”
• “Tráeme los registros de la tabla posts cuya categoría ID sea 34.”
• “Analiza esta tabla y dime qué columnas podrían ser clave.”
• Ajuste de resultados y mejora del prompt

Créame un artículo pilar para mi blog

Aquí viene lo más poderoso: aprovechar esta integración para crear artículos pilares automáticamente.

Un artículo pilar es como un índice maestro que organiza estratégicamente todo tu contenido relevante.
Por ejemplo, si entro en mi blog y busco “Laravel”, se nota la estructura:

• Un artículo principal (pilar)
• Y desde ahí enlazo a otros más específicos

El problema es que hacer esto manualmente con 300+ publicaciones es una locura.

Así que aprovecho Gemini + MCP MySQL para que analice mis datos y me prepare automáticamente el esqueleto del artículo.

La primera vez, Gemini me entregó apenas 8 enlaces… demasiado pobre.
Le pedí:

• “Dame más contenido por cada enlace.”
• “No solo el título.”
• “Profundiza un poquito más.”

Y el resultado fue muchísimo más completo. Aquí entendí que el prompt es el nuevo código: cuanto mejor lo formulas, mejor el resultado.

No digo que voy a copiar y pegar sin pensar. Pero ya tengo el 70% adelantado.
Y esto no lo haré solo con Laravel, sino también con:

• CSS
• JavaScript
• CodeIgniter
• etc.

Tengo más de 300 posts sobre Laravel. Pedirle a Gemini que me los ordene manualmente sería una locura.

Gracias al MCP MySQL, Gemini analiza la tabla posts y me genera automáticamente un esquema tipo índice maestro.

Y aquí lo tengo gratis.

Aquí es donde se mezcla lo mejor de ambos mundos:

• El MCP MySQL hace la extracción exacta y confiable desde la base de datos real.
• Gemini (IA) interpreta, estructura, resume y le da sentido pedagógico y estratégico.

Y si el resultado no me gusta, simplemente le digo:

• “Amplía.”
• “Más técnico.”
• “Clasifícalos por niveles.”
• “No me sirve ese formato, cámbialo a estructura de secciones tipo guía.”
• Automatizar consultas

Con el MCP, Gemini puede ejecutar consultas SQL sin escribir ni una sola línea manualmente. Ideal para quienes prefieren concentrarse en el análisis, no en la sintaxis.

6. Resultados reales y beneficios del flujo automatizado

El resultado no es solo técnico; es una revolución en productividad.

Ahorro de tiempo

Lo que antes me tomaba días, ahora lo hago en minutos. Puedo generar estructuras, índices y esquemas de artículos enteros de forma automática.

Aplicaciones futuras

Pienso replicarlo con otras categorías de mi blog: CSS, JavaScript, CodeIgniter… y más.

Integración con mi ecosistema

Todo se conecta con mi web Academia, donde tengo libros, cursos y contenido premium.

Gracias a Gemini + MCP MySQL, puedo mantenerlo todo actualizado sin perder tiempo.

Solución de problemas comunes

Combinar la extracción de datos precisa de un entorno SQL local con las capacidades lógicas de Antigravity CLI reduce tareas de días a un par de minutos, permitiéndote escalar la optimización y el marketing de contenidos de tus plataformas educativas de manera drástica.

Preguntas frecuentes sobre Gemini CLI

• ¿Qué es Antigravity/Gemini CLI?
  • Es la interfaz de línea de comandos del asistente de inteligencia artificial Gemini, desarrollada por Google.
• ¿Cómo se instala?
  • Con sudo npm install -g @antigravity/cli tras instalar Node.js.
• ¿Funciona en todos los sistemas operativos?
  • Sí, en Windows, Mac y Linux.
• ¿Tiene versión gratuita?
  • Sí, con 60 peticiones por minuto y 1.000 por día.
• ¿Puedo usarlo sin saber programar?
  • Sí, los comandos son naturales y no requieren experiencia previa.
• ¿Qué es exactamente un MCP?
  • Un protocolo que permite a Gemini interactuar con datos o servicios externos, como bases de datos o APIs.
• ¿Cómo instalar un MCP en Antigravity?
  • Con el comando gemini extension install nombre-del-mcp, preferiblemente con Gemini detenido.
• ¿Qué hacer si Gemini no reconoce mi MCP?
  • Reinicia la CLI, verifica permisos y asegúrate de que el .env esté configurado correctamente.
• ¿Cuál es la diferencia entre MCP local y remoto?
  • El local se ejecuta en tu entorno, el remoto usa servidores externos (mayor latencia, menos control).

Conclusión

Gemini CLI es una herramienta potente, ligera y práctica para quienes quieren usar Gemini directamente desde la terminal.

En mi experiencia, su instalación es sencilla y el uso diario se vuelve adictivo: puedo lanzar proyectos, automatizar procesos y clasificar archivos sin salir de la consola.

Si estás empezando, sigue los pasos de esta guía, prueba los ejemplos y pronto estarás aprovechando el poder de la IA desde tu propia computadora.