GSP1348

Descripción general

El vibe coding es una práctica emergente de desarrollo de software que usa Inteligencia Artificial (IA) para generar código funcional a partir de instrucciones de lenguaje natural, lo que acelera el desarrollo y hace que la creación de apps sea más accesible, especialmente para quienes tienen poca experiencia en programación.

El término, acuñado por el investigador de IA Andrej Karpathy a principios del 2025, describe un flujo de trabajo en el que el rol principal cambia de escribir código línea por línea a guiar a un asistente de IA como Antigravity CLI para generar, definir mejor y depurar una aplicación a través de un proceso más conversacional. Esto te permite pensar en el panorama general o en el objetivo principal de tu app, mientras que la IA se encarga de escribir el código real.

Antigravity CLI es un agente de IA de código abierto que lleva el poder de Gemini directamente a tu terminal. El proyecto Antigravity CLI es de código abierto y puedes consultar la hoja de ruta pública para obtener más información sobre las mejoras de funcionalidad, las próximas funciones y las correcciones de errores.

Qué aprenderás

En este lab, aprenderás a realizar las siguientes tareas:

• Configura Antigravity CLI para su uso.
• Interactúa con Antigravity CLI.
• Explora las herramientas integradas de Antigravity CLI.
• Usa Antigravity CLI en modo de Shell.
• Explora cómo configurar un servidor de MCP en Antigravity CLI.
• Realiza vibe coding con Antigravity CLI.

Requisitos

Este lab se puede ejecutar por completo en Google Cloud Shell, que viene preinstalado con Antigravity CLI.

Este lab está diseñado para usuarios y desarrolladores de todos los niveles (incluidos los principiantes).

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.

Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.

Para completar este lab, necesitarás lo siguiente:

• Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.

Nota: Usa una ventana del navegador privada o de incógnito (opción recomendada) para ejecutar el lab. Así evitarás conflictos entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.

• Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).

Nota: Usa solo la cuenta de estudiante para este lab. Si usas otra cuenta de Google Cloud, es posible que se apliquen cargos a esa cuenta.

Activa Cloud Shell

Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.

1. Haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.

2. Haz clic para avanzar por las siguientes ventanas:

   • Continúa en la ventana de información de Cloud Shell.
   • Autoriza a Cloud Shell para que use tus credenciales para realizar llamadas a la API de Google Cloud.

Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu Project_ID, . El resultado contiene una línea que declara el Project_ID para esta sesión:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.

3. Puedes solicitar el nombre de la cuenta activa con este comando (opcional):

gcloud auth list

4. Haz clic en Autorizar.

Resultado:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. Puedes solicitar el ID del proyecto con este comando (opcional):

gcloud config list project

Resultado:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Nota: Para obtener toda la documentación de gcloud, en Google Cloud, consulta la guía con la descripción general de gcloud CLI.

Tarea 1: Configura Antigravity CLI según tus necesidades

Habilita Cloud Logging para Antigravity CLI

Para admitir la puntuación de algunas de las tareas de este lab, debes habilitar Cloud Logging en Antigravity CLI.

• En Cloud Shell, ejecuta los siguientes comandos para configurar Cloud Logging para Antigravity CLI:

mkdir -p ~/.antigravity cat < ~/.antigravity/settings.json { "project": "{{{ project_0.project_id }}}", "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://{{{ project_0.startup_script.external_ip }}}:4318", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } } EOF

Es posible que notes que el archivo de muestra AGENTS.md (or GEMINI.md) proporciona algunas instrucciones generales, además de instrucciones muy específicas para el estilo de programación, la administración de dependencias y mucho más. De manera similar, podrías escribir tus propios lineamientos basados en tu lenguaje de programación, framework, estilo de programación y otras preferencias específicas del proyecto.

El archivo AGENTS.md (or GEMINI.md) es la clave para que Antigravity CLI siga tus preferencias. Para obtener más información, puedes consultar la serie Practical Antigravity CLI, que profundiza en cómo puedes generar automáticamente un archivo de este tipo para tu proyecto, personalizar la instrucción del sistema y mucho más.

Configura los parámetros específicos del proyecto

Antes de comenzar a usar Antigravity CLI, debes crear una carpeta para usarla como carpeta principal de todos los proyectos que crees en ella. Este es un punto de partida para que Antigravity CLI funcione, aunque puede hacer referencia a otras carpetas en tu sistema, según sea necesario.

1. Ejecuta los siguientes comandos en Cloud Shell para crear una carpeta de muestra, antigravity-projects, y navegar a ella:

export GOOGLE_CLOUD_PROJECT="{{{ project_0.project_id }}}" mkdir antigravity-projects cd antigravity-projects

2. Ahora, ejecuta el siguiente comando para crear un subdirectorio .gemini que contenga un archivo de configuración settings.json:

mkdir -p ~/.antigravity echo '{ "project": "{{{ project_0.project_id }}}", "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://{{{ project_0.startup_script.external_ip }}}:4318/v1/logs", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } }' > ~/.antigravity/settings.json

En Cloud Shell, Antigravity CLI está preinstalada.

3. Para comenzar a interactuar con Antigravity CLI, cambia a la pestaña ✦ Antigravity CLI en la terminal de Cloud Shell.

Cuando uses Antigravity CLI por primera vez, es posible que te pida que elijas un método de autenticación.

4. Si se te solicita que selecciones un modo de autenticación, presiona 2 para elegir 2. Usa las credenciales de usuario de Cloud Shell. Si no se te solicita autenticación, no hay problema. Puedes ignorar este paso y continuar con el lab.

Una vez que te autentiques correctamente, Antigravity CLI estará lista y esperará tu comando. A continuación, se muestra una captura de pantalla de muestra:

Por ahora, puedes salir de Antigravity CLI, ya que empezarás a trabajar con el modelo de forma más detallada en la tarea que sigue.

5. Presiona CTRL+D o CTRL+C dos veces, o ejecuta el comando /quit para salir de Antigravity CLI.

Tarea 2: Interactúa con Antigravity CLI

En esta tarea, comenzarás a usar Antigravity CLI. Para que la funcionalidad de puntuación de este lab sea estable, primero instalarás una versión específica de Antigravity CLI. Luego, como quieres empezar a trabajar en la carpeta específica del proyecto que creaste para este propósito, iniciarás una nueva sesión de Gemini.

1. En Cloud Shell, ejecuta el siguiente comando para instalar la versión pertinente de Antigravity CLI de forma global: npm install -g @google/antigravity-cli@0.6.1

Nota: Puedes probar otros modelos usando el comando /model en Antigravity CLI.

Mientras se ejecuta Antigravity CLI, puedes verificar el modelo que se está ejecutando en la parte inferior derecha de la terminal de Antigravity CLI, como en la siguiente captura de pantalla:

Usa el modo no interactivo

Una opción interesante es ejecutar Antigravity CLI en modo no interactivo. Esto significa que le proporcionas directamente la instrucción y responde a ella sin que se abra la terminal interactiva de Antigravity CLI. Esto es muy útil si planeas usar Antigravity CLI de forma automatizada como parte de una secuencia de comandos o cualquier otro proceso de automatización.

1. Cierra la sesión (presiona CTRL+D o CTRL+C dos veces o ejecuta la instrucción /quit).

2. En Cloud Shell, ejecuta el siguiente comando con el parámetro -p:

gemini -p “¿Cuál es el comando de gcloud para implementar en Cloud Run?”

Ten en cuenta que, en el modo no interactivo, no hay posibilidad de continuar la conversación con preguntas de seguimiento. Este modo tampoco te permite autorizar herramientas (incluido WriteFile) ni ejecutar comandos de Shell.

Haz clic en Revisar mi progreso para verificar el objetivo. Usa el modo no interactivo de Gemini

Tarea 4: Usa Antigravity CLI en modo de Shell

También es posible trabajar directamente con Shell desde Antigravity CLI.

1. Vuelve a iniciar Antigravity CLI con el siguiente comando:

gemini

2. Presiona ! en el cuadro de instrucción. Esto alterna a un modo de Shell.

En el modo de Shell, verás ! al principio de la instrucción, como se muestra a continuación:

Cuando estás en el modo de Shell, puedes usar directamente comandos estándar como pwd, cat y ls, por ejemplo.

Ahora, intentemos imprimir el contenido de un archivo con el comando cat.

3. Envía la siguiente instrucción a Antigravity CLI: cat finance-news-today.txt

Resultado de ejemplo:

4. Presiona ! de nuevo o presiona la tecla ESC para salir del modo de Shell.

Haz clic en Revisar mi progreso para verificar el objetivo. Usa Antigravity CLI en modo de Shell

Tarea 5: Configura un servidor de Protocolo de contexto del modelo (MCP)

Un servidor de MCP es una aplicación que expone herramientas y recursos a Antigravity CLI a través del Protocolo de contexto del modelo, lo que le permite interactuar con sistemas externos y fuentes de datos. Los servidores de MCP actúan como un puente entre el modelo de Gemini y tu entorno local o servicios como las APIs.

Un servidor de MCP permite que Antigravity CLI descubra y ejecute herramientas, lo que extiende sus capacidades para realizar acciones más allá de sus funciones integradas, como interactuar con bases de datos, APIs, secuencias de comandos personalizadas o flujos de trabajo especializados.

Antigravity CLI admite la configuración de servidores de MCP para descubrir y usar herramientas personalizadas.

1. Si ya lanzaste Antigravity CLI, puedes consultar los servidores de MCP configurados con el comando /mcp de la siguiente manera:

Si no configuraste ningún servidor de MCP, se inicia la documentación del servidor de MCP de Antigravity CLI.

Puedes configurar servidores de MCP a nivel global en el archivo ~/.antigravity/settings.json o en el directorio raíz de tu proyecto.

Si Antigravity CLI está en ejecución, puedes salir de la sesión presionando CTRL+D o CTRL+C dos veces.

2. Desde la terminal de Cloud Shell, haz clic en Abrir editor en la barra de herramientas para iniciar el editor de Cloud Shell.
3. Como el directorio de configuración ~/.antigravity está oculto de forma predeterminada, selecciona View > Toggle hidden files para mostrar archivos y directorios ocultos.
4. En el editor de Cloud Shell, busca y abre el archivo ~/.antigravity/settings.json en la carpeta específica de tu proyecto, antigravity-projects.

En el archivo ~/.antigravity/settings.json, debes configurar el bloque de configuración mcpServers. Tiene la siguiente sintaxis:

"mcpServers": { "server_name_1": {}, "server_name_2": {}, "server_name_n": {} }

Configurarás este archivo para admitir un servidor de MCP en la próxima tarea.

Cada configuración de servidor admite las siguientes propiedades, según la documentación de referencia:

Obligatorio (una de las siguientes opciones)

• command (string): ruta de acceso al ejecutable para el transporte de Stdio
• url (string): URL del extremo de SSE (p. ej., "http://localhost:8080/sse")
• httpUrl (string): URL del extremo de transmisión de HTTP

Opcional

• args (string[]): argumentos de la línea de comandos para el transporte de Stdio
• headers (object): encabezados HTTP personalizados cuando se usa url o httpUrl
• env (object): variables de entorno para el proceso del servidor. Los valores pueden hacer referencia a variables de entorno con la sintaxis $$VAR_NAME o $${VAR_NAME}
• cwd (string): directorio de trabajo para el transporte de Stdio
• timeout (number): tiempo de espera de la solicitud en milisegundos (predeterminado: 600,000 ms = 10 minutos)
• trust (boolean): cuando es verdadero, omite todas las confirmaciones de llamadas a herramientas para este servidor (predeterminado: falso)
• includeTools (string[]): lista de nombres de herramientas para incluir de este servidor de MCP. Cuando se especifica, solo las herramientas que se enumeran aquí estarán disponibles en este servidor (comportamiento de lista de entidades permitidas). Si no se especifica, todas las herramientas del servidor se habilitan de forma predeterminada.
• excludeTools (string[]): lista de nombres de herramientas para excluir de este servidor de MCP. Las herramientas que se enumeran aquí no estarán disponibles para el modelo, incluso si el servidor las expone. Nota: excludeTools tiene prioridad sobre includeTools. Si una herramienta está en ambas listas, se excluirá.

Nota: Antes de continuar, es importante destacar que debes tener cuidado cuando te conectes o integres con servidores de MCP de terceros. Para proteger tu información y la integridad del sistema, se recomienda que solo te integres con servidores de MCP de fuentes confiables y minuciosamente evaluadas.

Configurar un servidor MCP de Git local

El servidor oficial de Git del Protocolo de Contexto de Modelo (MCP) (git-mcp-server) permite que Antigravity CLI lea, inspeccione y realice operaciones de control de versiones de Git directamente en repositorios locales.

En esta sección, configurarás un repositorio de Git local y el servidor MCP de Git en el archivo de configuración de Antigravity CLI.

1. En la terminal integrada del Editor de Cloud Shell, ejecuta los siguientes comandos para crear e inicializar un repositorio de Git de muestra:

mkdir -p ~/event-talks-app cd ~/event-talks-app git init git config user.name "Student" git config user.email "student@qwiklabs.net" echo "# Event Talks App" > README.md git add README.md git commit -m "Initial commit"

2. Ejecuta los siguientes comandos en tu terminal para crear mcp_config.json con la configuración del servidor MCP de git:

mkdir -p ~/.antigravity ~/.gemini cat < ~/.antigravity/mcp_config.json { "mcpServers": { "git": { "command": "npx", "args": [ "-y", "git-mcp-server", "$HOME/event-talks-app" ], "trust": true } } } EOF cp ~/.antigravity/mcp_config.json ~/.gemini/mcp_config.json jq -s '.[0] * .[1]' ~/.antigravity/settings.json ~/.antigravity/mcp_config.json > temp.json && mv temp.json ~/.antigravity/settings.json cp ~/.antigravity/settings.json ~/.gemini/settings.json

3. Ejecuta el siguiente comando para iniciar Antigravity CLI:

agy

4. Para verificar que el servidor MCP de Git esté cargado y sus herramientas estén activas, ingresa el comando /mcp:

/mcp

La salida del comando /mcp muestra el servidor MCP de git activo junto con las herramientas disponibles como git_status, git_log, git_add y git_commit.

Nota: Cuando Antigravity CLI te pida permiso, presiona ENTER para seleccionar Permitir una vez (o Permitir siempre).

5. Solicita a Antigravity CLI que inspeccione el estado del repositorio:

Check the git status of the repository at /home/student/event-talks-app using the git MCP server tools.

Haz clic en Revisar mi progreso. Verificar el repositorio local con herramientas de MCP de Git

6. Ahora solicita a Antigravity CLI que agregue un nuevo archivo y realice el commit en Git:

Create a new file named talks.json in /home/student/event-talks-app with sample event schedule data, add it to git, and commit the changes with the message "Add talks schedule".

Haz clic en Revisar mi progreso. Crear commit con herramientas de MCP de Git

Ahora que el servidor de MCP de GitHub está configurado, puedes enviar tus consultas en lenguaje natural de la siguiente manera para trabajar con uno de tus proyectos de GitHub:

• ¿Puedes describir el <repo-name>?
• Clona el <repo-name> en mi máquina local.
• Describe @<file-name> o @<directory-name>/
• ¿Cuáles son los diferentes componentes de este repositorio?
• Ya hice los cambios necesarios. ¿Puedes enviar los cambios a GitHub y usar las herramientas del servidor de MCP de GitHub para hacerlo?

Más servidores de MCP

Aquí tienes una lista adicional de servidores de MCP que podrían interesarte:

• Servidor de MCP de Firebase
• Servicios de medios de IA generativa de Google (Imagen, Veo, Lyria)
• Caja de herramientas de MCP para bases de datos (trabaja con Firestore, BigQuery y bases de datos de Google Cloud)
• Servidor MCP de Google Workspace (trabaja con Documentos, Hojas de cálculo, Calendario y Gmail)

Las instrucciones para configurar estos servidores de MCP se publican en esta entrada de blog.

Tarea 6: Realiza vibe coding con Antigravity CLI

En esta tarea, usarás Antigravity CLI para crear un sitio web con vibe coding. Le pides a Antigravity CLI que genere la estructura del sitio web y la configure.

Nota: Incluso cuando eres muy preciso en tus instrucciones, con vibe coding el ambiente, el modelo a veces puede desviarse de lo que le indicaste que hiciera, alucinar o quedarse atascado en un bucle. Si el modelo se atasca, presiona ESC y dale instrucciones actualizadas o repite las anteriores, según sea necesario.

1. En Antigravity CLI, ejecuta la siguiente instrucción:

Generar un sitio web para un evento de 1 día lleno de charlas técnicas. Habrá 6 charlas en una sola pista de 1 hora cada una. Cada charla tiene la siguiente información: título, 1 o máximo 2 oradores, categoría (1 o máximo 3 palabras clave), duración y una descripción. El sitio web tiene una sola página en la que los usuarios pueden ver el programa de todo el día con los horarios. Habrá un descanso para almorzar de una hora y el evento comenzará a las 10:00 a.m. Mantén una transición de 10 minutos entre las charlas. Me gustaría usar Node.js en el servidor y HTML, JavaScript y CSS estándar en el frontend. Los usuarios deberían poder buscar las charlas según la categoría. Me gustaría que procedieras de la siguiente manera: 1. Planifica cómo diseñar y programar esta aplicación. 2. Si tienes alguna duda, no dudes en preguntarme. 3. Cuando esté conforme, genera el código y compila el sitio web en un único archivo HTML sin servidores. 4. Proporciona instrucciones para ejecutar y probar el sitio web (entrégame el archivo index.html con un servidor simple de Python para que pueda obtener una vista previa local).

En este punto, Antigravity CLI pasa a realizar una serie de acciones.

2. Si el modelo quiere que confirmes qué acciones debe tomar a continuación o te pregunta cómo proceder, dale la siguiente instrucción:

Crea el sitio web con datos de marcadores de posición y sigue las sugerencias de tu plan. Nota: Es posible que Antigravity CLI experimente un tiempo de espera o use un nombre de usuario incorrecto, etc. Interactúa con ella y sugiere las correcciones, según sea necesario.

Las siguientes instrucciones y respuestas son un flujo de muestra que se observó. Es posible que obtengas una respuesta completamente diferente.

Debes interactuar con Antigravity CLI según sea necesario.

A veces, Antigravity CLI puede sugerir un comando que le gustaría ejecutar. Para los fines de este lab, debes ejercer control sobre la tarea.

Si el modelo ofrece ejecutar un comando, puedes presionar ESC para salir y redirigir su enfoque con un mensaje como el siguiente:

Si sigues las instrucciones para iniciar el servidor y navegar a la página principal, obtendrás un sitio de muestra como este (deberías ver una variante de un sitio similar si usaste la misma instrucción):

Puedes seguir haciendo más cambios con la ayuda de Antigravity CLI.

• Crea el repositorio.
• Usa varios comandos de Git: init, add, commit para administrar el repositorio de Git local.
• Configura el remoto de Git y hace un envío.

Nota: Hay casos en los que Antigravity CLI puede agotar el tiempo de espera o usar un nombre de usuario incorrecto, etc. Interactúa con ella y sugiere las correcciones aplicables, según sea necesario.

Si Antigravity CLI tiene problemas con la autenticación cuando envía tus cambios, recuérdale que use las herramientas del servidor de MCP de GitHub.

Si todo va bien, deberías tener un repositorio de GitHub. A continuación, se muestra una captura de pantalla de muestra:

¡Bien hecho! Creaste un sitio web con la ayuda de Antigravity CLI y enviaste los cambios a un repositorio de GitHub que creaste.

Nota: No completaste un archivo README.md fácil de usar para el proyecto de este lab, pero se recomienda hacerlo en un entorno de producción real. Si quieres, puedes pedirle a Antigravity CLI que lo haga por ti.

Haz clic en Revisar mi progreso para verificar el objetivo.

¡Felicitaciones!

¡Felicitaciones! Exploraste correctamente Antigravity CLI y sus capacidades, y la aplicaste a un caso de uso.

Próximos pasos y más información

• Publicación del anuncio de Antigravity CLI
• Página principal del proyecto de Antigravity CLI
• Documentación de Antigravity CLI

Actualización más reciente del manual: 16 de octubre de 2025

Prueba más reciente del lab: 16 de octubre de 2025

Copyright 2026 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.