2026-11-12 · 4 min de leitura
Do zero ao app publicado com o seu agente de código
npx rapibase@latest init
Rodado na pasta do seu app, esse comando deixa tudo pronto para trabalhar com o seu agente de código: faz login ou cria a sua conta, cria um projeto grátis, escreve o .env e instala os skills e o MCP da Rapibase no Claude Code, Cursor, OpenCode, Codex, Hermes ou em qualquer agente que leia o AGENTS.md. Depois você pede o app ao agente e publica quando decidir.
O que você precisa
- Node.js, para rodar o
npx. - O seu agente de código.
- Uma pasta para o app: vazia ou com o código que você já tem.
Você não precisa ter uma conta antes: ela é criada no primeiro passo. O plano grátis inclui um projeto e não pede cartão.
1. Entre pelo navegador
Abra um terminal na pasta do app e rode o comando. O navegador abre e o terminal mostra um código. Confira se o navegador mostra o mesmo código, entre ou crie a sua conta e aprove. Você não digita email nem senha no terminal. Se o navegador não abrir, o terminal mostra o link.
2. Crie o projeto
O init pergunta qual projeto usar. A primeira opção é criar um novo no plano grátis: escolha um nome e esse nome vira o seu endereço, meu-app.rapibase.com. O projeto já vem com o seu próprio banco Postgres, login de usuários, armazenamento de arquivos, funções TypeScript e hospedagem. Se você já usou o seu projeto grátis, o init oferece os que você já tem.
3. O que fica na sua pasta
O init detecta o seu agente (ou pergunta qual você usa) e deixa isto:
.rapibase/project.json, que liga a pasta ao projeto. Não tem segredos: você pode commitar..env, com a URL e as chaves do projeto. O init coloca o arquivo no.gitignoree nunca mostra os valores na tela.- Os skills da Rapibase, onde o seu agente os lê. Eles ensinam o banco de dados, o login, as funções, os deploys e os logs.
- O MCP da Rapibase, registrado no seu agente sem nenhuma chave: o agente faz login com OAuth na primeira vez que usa.
Se o MCP for novo, reinicie o agente para ele carregar; o init mostra como fazer no seu. No Claude Code, claude --continue retoma a conversa.
Se preferir que o seu agente rode
Você também pode pedir ao agente, com as suas palavras:
Conecte esta pasta à Rapibase com npx rapibase@latest init --name meu-app e me passe o link para aprovar.
A partir de um agente, o CLI não fica esperando: imprime o link e o código e termina com login_pending. Você abre o link, confere o código, aprova e avisa o agente, que roda o mesmo comando de novo e continua de onde parou. --name é o nome do projeto grátis que ele vai criar; para usar um que você já tem, troque por --project e o nome desse projeto. No final, faça o que o CLI indicar para carregar o MCP (quase sempre, reiniciar o agente).
4. Peça o app
Com a pasta pronta, peça o que você quer construir. Por exemplo:
Faça um app de tarefas com a Rapibase: cadastro e login com email, cada usuário vê só as próprias tarefas. Teste localmente. Ainda não publique nada.
O agente já sabe usar a Rapibase: cria as tabelas, ativa a segurança por linha para que o próprio banco decida quem vê o quê e escreve o código usando a API. Se o app precisa de lógica no servidor (mandar um email, receber o aviso de um pagamento, chamar outra API), peça uma função TypeScript: ela roda dentro do mesmo projeto. Quando o agente consulta o banco ou a API pelo CLI, a chave secreta não sai do servidor.
Teste com duas contas: o que uma salva, a outra não pode ver.
5. Publique quando você decidir
Quando estiver satisfeito, peça ao agente "faça o build e publique na Rapibase", ou publique você mesmo:
npx rapibase@latest deploy ./dist
./dist é a pasta do build no Vite; se você não passar nenhuma, o CLI procura a do seu framework. O app fica em meu-app.rapibase.com, no mesmo domínio da API, então não tem CORS. Se for usar o CLI com frequência, instale com npm i -g rapibase e digite só rapibase, como no resto deste guia.
Cada deploy é uma versão: rapibase deploys lista as versões e rapibase deploys activate volta para uma anterior. O agente só publica quando você pede, porque os skills dizem isso a ele; se algum dia fizer isso por conta própria, diga para não fazer.
No dia a dia
rapibase status: as URLs, o plano e o uso do projeto.rapibase logs --follow: os logs do app, ao vivo.rapibase sql "select count(*) from tarefas": SQL direto no seu Postgres.rapibase env pull: escreve o.envde novo. Em outro computador, depois de clonar o repo, roderapibase logine depois este.rapibase open: abre o console do projeto.
Os comandos, o modo para agentes e o uso no CI estão resumidos na página do CLI. rapibase --help lista todos os comandos, e cada um tem o seu --help com exemplos. O código do CLI é aberto e está em github.com/rapibase/cli.
Teste com seu agente
Crie um projeto grátis, conecte o seu agente (Claude Code, Cursor, OpenCode ou Claude.ai) e peça o seu app. Sem cartão.
Começar grátis