Relevo

Claude Code y Gemini trabajando como un equipo, con tus propias suscripciones.

Relevo es un plugin gratuito para Claude Code. Hace que Claude trabaje en equipo con Gemini, a través de la Antigravity CLI oficial de Google:

• Se reparten el trabajo. Gemini hace lo pesado (leer el código, programar, pasar tests, investigar) y Claude decide y revisa.

• Se revisan mutuamente. Nada de lo que hace Gemini llega a tu proyecto sin que Claude lo apruebe.

• Recuerdan. Tablero y memoria del equipo en tu proyecto y, si usas Obsidian, un diario de cada sesión en tu bóveda.

Por qué: la cuota de Claude se acaba rápido. Con Relevo el trabajo pesado corre a cargo de tu suscripción de Google.

Español · English

Instalación

Necesitas:

• Claude Code (la app de escritorio de Claude o la terminal) con tu cuenta Claude Pro o Max.

• Una cuenta de Google con AI Pro o Ultra.

No hace falta ninguna API key ni pegar contraseñas: Relevo usa tus sesiones oficiales.

Paso 1 · Ejecuta el instalador

1. Pulsa la tecla Windows, escribe PowerShell y ábrelo.

2. Copia esta línea, pégala en PowerShell y pulsa Enter:

irm https://raw.githubusercontent.com/Piratapacorro/relevo/main/install.ps1 | iex

1. Abre la app Terminal.

2. Copia esta línea, pégala y pulsa Enter:

curl -fsSL https://raw.githubusercontent.com/Piratapacorro/relevo/main/install.sh | bash

Si tu Linux responde curl: orden no encontrada, usa esta otra línea:

wget -qO- https://raw.githubusercontent.com/Piratapacorro/relevo/main/install.sh | bash

Si tampoco tienes wget, instala curl primero con sudo apt install curl.

El instalador revisa tu equipo y te pregunta antes de instalar nada:

Paso 2 · Inicia sesión (solo la primera vez)

En Google (Gemini). Si en el paso 5/5 el instalador te lo pide:

1. Se abrirá tu navegador: entra con tu cuenta de Google AI Pro/Ultra y acepta.

2. Vuelve a la ventana del instalador.

3. Cuando veas el chat de agy, escribe /exit y pulsa Enter.

Si ya usas la app de Antigravity con esa cuenta, este paso normalmente no hace falta.

En Claude, solo si el instalador acaba de instalarte Claude Code: abre una terminal nueva, escribe claude y entra con tu cuenta Claude Pro o Max.

Paso 3 · Empieza a usarlo

1. Cierra y vuelve a abrir la app de Claude (o Claude Code en la terminal). Al arrancar, descarga Relevo.

2. Abre una sesión en la carpeta de tu proyecto y escribe:

/relevo:iniciar

Claude comprueba que todo está conectado, te explica el aviso sobre las condiciones de Google (solo la primera vez), prepara el proyecto y te pregunta por tu bóveda de Obsidian si la usas.

3. Pide trabajo al equipo:

/relevo:equipo añade un formulario de contacto con validación y tests

Dentro de Claude Code en la terminal:

/plugin marketplace add Piratapacorro/relevo
/plugin install relevo@relevo

En la app de escritorio no existe /plugin.

A mano:

1. Instala la Antigravity CLI siguiendo su guía oficial y ejecuta agy una vez para iniciar sesión.

2. Añade esto a ~/.claude/settings.json:

{
  "extraKnownMarketplaces": { "relevo": { "source": { "source": "github", "repo": "Piratapacorro/relevo" } } },
  "enabledPlugins": { "relevo@relevo": true }
}

Relevo necesita Node.js 18+ y git.

Related MCP server: HiveClaude

Comandos

Cómo trabajan

• Copia aislada. Gemini trabaja en una copia de tu proyecto, fuera de tu carpeta. Nada llega a tu código hasta que Claude lo revisa y lo aprueba.

• Todo se puede deshacer, también en proyectos sin git: Relevo nunca crea un .git en tu carpeta.

• Informes cortos. Gemini devuelve un resumen compacto, así Claude gasta pocos tokens. El detalle queda en .relevo/jobs/.

• Windows, macOS y Linux, sin WSL y sin dependencias.

Memoria compartida

Relevo busca en tu bóveda una carpeta con el nombre del proyecto; si no la encuentra, usa la raíz. Para fijarla a mano, crea .relevo/config.json con {"vaultFolder": "MiProyecto"}.

Permisos y seguridad

• Permisos completo (por defecto): Gemini puede ejecutar comandos (tests, builds) dentro de su copia aislada. Úsalo en proyectos en los que confíes.

• Permisos solo-archivos: Gemini solo lee y edita archivos, y los comandos los ejecuta Claude (gasta más cuota de Claude).

• Límite de seguridad: 40 llamadas a Gemini por sesión y un tiempo máximo por tarea.

• Cuota de Google agotada: Relevo lo detecta enseguida, prueba con un modelo Flash y te avisa si tampoco queda.

Estos ajustes se cambian en ~/.claude/settings.json, dentro de pluginConfigs. La bóveda de Obsidian basta con decírsela a Claude.

⚠️ Aviso sobre las condiciones de uso

• Anthropic: usar Claude Code con tu propia suscripción está permitido. Relevo no usa el Agent SDK ni claude -p.

• Google: las condiciones de Antigravity prohíben usar el servicio «con productos que no son de Google», y su FAQ menciona Claude Code.

  • Relevo solo usa el programa oficial agy con tu propia sesión, pero Google no ha aclarado si eso está permitido.

  • En 2026 suspendió cuentas que reutilizaban el login de Antigravity en otras apps, algo que Relevo no hace.

  • Aun así, existe riesgo y lo asumes tú.

• Alternativa sin ese riesgo: configura agy con una API key de Google AI Studio ("modelProvider": "gemini" en ~/.gemini/antigravity-cli/settings.json y la variable GEMINI_API_KEY).

Relevo no está afiliado a Anthropic ni a Google. Claude, Gemini y Antigravity son marcas de sus propietarios.

Solución de problemas

Desinstalar

En ~/.claude/settings.json, borra "relevo@relevo" de enabledPlugins y "relevo" de extraKnownMarketplaces. En la terminal también puedes usar claude plugin uninstall relevo@relevo.

Desarrollo

npm test                                  # tests con un agy simulado (no gasta cuota)
node test/live.mjs <proyecto-de-prueba>   # prueba real contra agy (gasta un poco de cuota de Gemini)
claude --plugin-dir .                     # cargar el plugin sin instalarlo

Licencia

MIT