2026-11-12 · 4 min de lectura
De cero a publicado con tu agente de código
npx rapibase@latest init
Ese comando, corrido en la carpeta de tu app, deja todo listo para trabajar con tu agente de código: inicia sesión o crea tu cuenta, crea un proyecto gratis, escribe el .env e instala los skills y el MCP de Rapibase en Claude Code, Cursor, OpenCode, Codex, Hermes o cualquier agente que lea AGENTS.md. Después le pides la app al agente y la publicas cuando tú lo decides.
Qué necesitas
- Node.js, para correr
npx. - Tu agente de código.
- Una carpeta para la app: vacía o con el código que ya tienes.
No necesitas una cuenta de antes: la creas en el primer paso. El plan gratis incluye un proyecto y no pide tarjeta.
1. Entra desde el navegador
Abre una terminal en la carpeta de la app y corre el comando. Se abre tu navegador y la terminal muestra un código. Comprueba que el navegador muestre el mismo código, entra o crea tu cuenta y aprueba. En la terminal no escribes ni email ni contraseña. Si el navegador no se abre, la terminal te da el enlace.
2. Crea el proyecto
init te pregunta qué proyecto usar. La primera opción es crear uno nuevo con el plan gratis: elige un nombre y ese nombre es tu dirección, mi-app.rapibase.com. El proyecto trae su propia base de datos Postgres, login de usuarios, almacenamiento de archivos, funciones TypeScript y hosting. Si ya usaste tu proyecto gratis, init te ofrece los que ya tienes.
3. Lo que queda en tu carpeta
init detecta tu agente (o te pregunta cuál usas) y deja esto:
.rapibase/project.json, que une la carpeta con el proyecto. No tiene secretos: puedes commitearlo..env, con la URL y las claves del proyecto. init lo agrega al.gitignorey nunca muestra los valores en pantalla.- Los skills de Rapibase, donde tu agente los lee. Le enseñan a usar la base de datos, el login, las funciones, los deploys y los logs.
- El MCP de Rapibase, registrado en tu agente sin ninguna clave: el agente inicia sesión con OAuth la primera vez que lo usa.
Si el MCP es nuevo, reinicia el agente para que lo cargue; init te dice cómo en el tuyo. En Claude Code, claude --continue retoma la conversación.
Si prefieres que lo corra tu agente
También puedes pedírselo al agente, con tus palabras:
Conecta esta carpeta a Rapibase con npx rapibase@latest init --name mi-app y pásame el enlace para aprobar.
Desde un agente, el CLI no se queda esperando: imprime el enlace y el código y termina con login_pending. Abres el enlace, compruebas el código, apruebas y se lo dices al agente, que corre el mismo comando otra vez y sigue donde quedó. --name es el nombre del proyecto gratis que va a crear; para usar uno que ya tienes, cámbialo por --project y el nombre de ese proyecto. Al terminar, haz lo que indique el CLI para cargar el MCP (casi siempre, reiniciar el agente).
4. Pídele la app
Con la carpeta lista, pide lo que quieres construir. Por ejemplo:
Haz una app de tareas con Rapibase: registro y login con email, cada usuario ve solo sus tareas. Pruébala en local. Todavía no publiques nada.
El agente ya sabe usar Rapibase: crea las tablas, activa la seguridad por filas para que la propia base de datos decida quién ve qué y escribe el código contra la API. Si la app necesita lógica de servidor (mandar un email, recibir el aviso de un pago, llamar a otra API), pídele una función TypeScript: corre dentro del mismo proyecto. Cuando el agente consulta la base o la API con el CLI, la clave secreta no sale del servidor.
Pruébala con dos cuentas: lo que guarda una, la otra no tiene que verlo.
5. Publica cuando tú lo decidas
Cuando estés conforme, pídele al agente "haz el build y publícalo en Rapibase", o publícalo tú:
npx rapibase@latest deploy ./dist
./dist es la carpeta del build en Vite; si no le pasas ninguna, el CLI busca la de tu framework. La app queda en mi-app.rapibase.com, en el mismo dominio que la API, así que no hay CORS. Si vas a usar el CLI seguido, instálalo con npm i -g rapibase y escribe solo rapibase, como en el resto de esta guía.
Cada deploy es una versión: rapibase deploys las lista y rapibase deploys activate vuelve a una anterior. El agente solo publica cuando se lo pides, porque los skills se lo indican; si alguna vez lo hace por su cuenta, dile que no lo haga.
Para el día a día
rapibase status: las URLs, el plan y el uso del proyecto.rapibase logs --follow: los logs de la app, en vivo.rapibase sql "select count(*) from tareas": SQL directo contra tu Postgres.rapibase env pull: vuelve a escribir el.env. En otra computadora, después de clonar el repo, correrapibase loginy después este.rapibase open: abre la consola del proyecto.
Los comandos, el modo para agentes y el uso en CI están resumidos en la página del CLI. rapibase --help lista todos los comandos, y cada uno tiene su --help con ejemplos. El código del CLI es abierto y está en github.com/rapibase/cli.
Pruébalo con tu agente
Crea un proyecto gratis, conecta tu agente (Claude Code, Cursor, OpenCode o Claude.ai) y pídele tu app. Sin tarjeta.
Empezar gratis