MANUAL DE INSTALACIÓN

Antigravity Brain

Guía paso a paso para instalar y configurar tu Torre de Control AI en macOS.

v2.0.0 · macOS arm64 (Apple Silicon)
01 — REQUISITOS

Antes de empezar

Verifica que tu equipo cumple estos requisitos mínimos:

🍎

macOS

macOS 13 Ventura o superior

Procesador

Apple Silicon (M1/M2/M3/M4)

💾

Espacio

~200MB libres en disco

🧠

Antigravity

Extensión Antigravity (Gemini CLI) instalada

ℹ️

¿Necesitas Antigravity instalado?

Sí. La app lee los datos directamente de ~/.gemini/antigravity/. Si no tienes Antigravity, la app abrirá pero no tendrá datos que mostrar. Instala la extensión primero y trabaja con ella para generar sesiones y artefactos.

02 — INSTALACIÓN

Instalar antigravitybrain.dmg

1

Abrir el DMG

Haz doble click en antigravitybrain.dmg. Se montará una imagen de disco virtual con la app dentro.

2

Arrastrar a Aplicaciones

Arrastra el icono de Antigravity Brain a la carpeta Aplicaciones que aparece al lado. Esto copia la app a tu Mac.

3

Primer arranque (Gatekeeper)

Al abrir la app por primera vez, macOS mostrará un aviso de seguridad porque es una app sin firmar. Sigue estos pasos:

TERMINAL
# Opción A: Desde Ajustes del Sistema
Ajustes del Sistema → Privacidad y Seguridad → "Abrir de todas formas"

# Opción B: Con Terminal (más rápido)
sudo xattr -rd com.apple.quarantine /Applications/Antigravity\ Brain.app
⚠️

¿Por qué aparece el aviso?

La app no está firmada con un certificado de Apple Developer ($99/año). Es completamente segura — el código fuente es 100% auditable. Este paso solo es necesario la primera vez.

4

¡Listo!

La app detectará automáticamente tu directorio ~/.gemini/antigravity/ y cargará todas tus sesiones, artefactos y Knowledge Items.

Modo Autopilot activo

Al arrancar, se activa automáticamente el modo Autopilot que cada 30 segundos escanea sesiones, limpia archivos basura, verifica integridad y sincroniza Knowledge Items.

03 — CONFIGURACIÓN INICIAL

Primeros pasos tras instalar

A

Añadir tus servidores

Ve a la pestaña Servidores y pulsa "+ Añadir". Introduce el nombre, IP, usuario SSH y ruta de la key. El panel podrá comprobar en vivo el estado de RAM, disco, Docker y PM2.

EJEMPLO
# Datos de un servidor típico:
Nombre: Mi VPS Producción
IP: 123.456.789.0
SSH User: root
SSH Key: ~/.ssh/id_ed25519
B

Añadir tus API keys

Ve a la pestaña APIs y pulsa "+ Añadir API". Introduce el nombre del servicio, tipo, key y saldo estimado. Las keys se guardan localmente en tu Mac, nunca salen a internet.

C

Explorar tus datos

Las pestañas Sesiones, Artefactos y Knowledge Items se rellenan automáticamente leyendo tu directorio de Antigravity. No necesitas configurar nada — solo trabaja con Antigravity y el panel se actualiza solo.

04 — LAS 9 PESTAÑAS

Qué hace cada pestaña

Sesiones

Todas tus conversaciones AI en tiempo real con estado de salud y tokens.

Prompts

10 plantillas de producción auto-rellenadas con tu infra real.

Artefactos

Bóveda de documentos, imágenes y código generados por la IA.

Reparar

Limpieza de .resolved, verificación de integridad y reparación auto.

APIs

Gestión de API keys con tracking de costes y alertas de renovación.

Servidores

SSH live check a tus VPS: RAM, disco, Docker, PM2 en un click.

Knowledge

Base de conocimiento local auto-sincronizada entre sesiones.

Info

Rutas, versiones, salud del sistema y métricas del entorno.

Dashboard

KPIs en tiempo real con estética cyberpunk y animaciones.

05 — ESTRUCTURA DE DATOS

Dónde vive todo

La app lee y escribe exclusivamente en este directorio:

FILESYSTEM
~/.gemini/antigravity/
├── brain/ ← Conversaciones y artefactos
├── knowledge/ ← Knowledge Items
├── conversations/ ← Sesiones de Antigravity
├── implicit/ ← Conversaciones implícitas
├── servers.json ← Tus servidores (se crea al añadir)
└── apis.json ← Tus API keys (se crea al añadir)
🔒

100% Local

La app no envía NINGÚN dato a internet. Todo se lee y escribe en tu disco local. Tus API keys, servidores y sesiones nunca salen de tu Mac.

06 — PREGUNTAS FRECUENTES

FAQ

¿Funciona en Intel Mac?

Esta build es solo para Apple Silicon (M1/M2/M3/M4). Si tienes Intel, contáctame y te genero un build compatible.

¿Necesito tener Antigravity corriendo en ese momento?

No. La app lee los archivos del disco. Puedes tener Antigravity cerrado. Pero si está corriendo, verás los datos actualizarse en tiempo real.

¿Puedo desinstalar fácilmente?

Sí. Arrastra la app desde Aplicaciones a la papelera. Tus datos de Antigravity NO se tocan — están en ~/.gemini/antigravity/ y son independientes.

¿La app modifica mis datos de Antigravity?

Solo en dos casos: cuando pulsas "Limpiar .resolved" (borra archivos de reparación) y cuando el Autopilot genera Knowledge Items. Nunca borra sesiones ni artefactos.

¿Es gratis?

Sí, 100% gratuita. Proyecto sin ánimo de lucro. Comparte libremente.

¿El código fuente está disponible?

Si quieres auditar el código, contáctame. Es 100% transparente — puedes verificar que no hay telemetría, tracking ni envío de datos.

07 — SOLUCIÓN DE PROBLEMAS

Si algo no funciona

🔧

"app dañada y no puede abrirse"

Ejecuta en Terminal: sudo xattr -rd com.apple.quarantine /Applications/Antigravity\ Brain.app

🔧

La app abre pero no muestra sesiones

Verifica que tienes el directorio: ls ~/.gemini/antigravity/brain/ — si está vacío, trabaja primero con Antigravity para generar datos.

🔧

Los servidores no conectan por SSH

Verifica que la ruta de la SSH key es correcta y que tienes permisos: chmod 600 ~/.ssh/tu_key

08 — PROMPT DE CONFIGURACIÓN

Pega esto en Antigravity para terminar de configurar

Abre una conversación con Antigravity y pega este prompt. Él detectará tu instalación de Antigravity Brain y te ayudará a configurar tus servidores, APIs y Knowledge Items automáticamente.

📋 PROMPT LISTO PARA COPIAR
Acabo de instalar Antigravity Brain (Torre de Control) — la app de escritorio que lee mis datos de ~/.gemini/antigravity/ y me da un panel con sesiones, artefactos, Knowledge Items, servidores y APIs. Necesito que me ayudes a configurarla completamente: 1. **Servidores**: Tengo estos VPS que quiero monitorizar desde la app. Para cada uno necesito registrar: nombre, IP, usuario SSH, ruta de SSH key, y los proyectos que corren en él. Genera el archivo ~/.gemini/antigravity/servers.json con el formato correcto. Pregúntame los datos de cada servidor. 2. **APIs**: Tengo estas API keys que uso en mis proyectos. Para cada una necesito registrar: nombre del servicio, tipo, key, saldo estimado, y proyectos asociados. Genera el archivo ~/.gemini/antigravity/apis.json con el formato correcto. Pregúntame los datos de cada API. 3. **Knowledge Items**: Escanea mis proyectos actuales y genera KIs iniciales en ~/.gemini/antigravity/knowledge/ para que la app tenga contexto desde el primer momento. Cada KI debe tener un metadata.json con summary y un artifacts/ con context.md. 4. **Verificación**: Una vez creados los archivos, abre Antigravity Brain y confirma que los paneles de Servidores, APIs y Knowledge Items muestran los datos correctamente. Dame los pasos uno a uno. Empieza preguntándome cuántos servidores tengo y sus datos.
💡

¿Qué hace este prompt?

Le pide a Antigravity que cree los archivos de configuración (servers.json, apis.json y Knowledge Items) en tu disco. La app los leerá automáticamente y empezarás a ver tus servidores, APIs y conocimiento en el panel.