CLI
Um comando e o seu agente tem backend
Rode na pasta do seu app. Ele faz login (ou cria a sua conta) no navegador, cria ou escolhe um projeto, vincula a pasta, escreve o seu .env e conecta o seu agente com skills e MCP. A partir daí, você pede o app ao seu agente.
npx rapibase@latest init1 projeto grátis para sempre · sem cartão · Pro US$ 20/projeto/mês
O que o init faz
- Faz login no navegador. O terminal mostra um código; você confere se o navegador mostra o mesmo e aprova. Ainda não tem conta? Você cria ali mesmo.
- Cria o seu projeto ou deixa você escolher um. O plano grátis inclui um projeto, sem cartão.
- Vincula a pasta em
.rapibase/project.json. Ele não guarda segredos, então vai para o repositório. Num monorepo, cada app pode ter o seu. - Escreve o seu .env com as chaves do projeto. Nunca as mostra.
- Conecta o seu agente: instala as skills do Rapibase e o MCP no Claude Code, Cursor, OpenCode, Codex e Hermes, ou em qualquer agente que leia
AGENTS.md.
Cada passo pode ser pulado (--no-env, --no-skill, --no-mcp) e rodar de novo é seguro.
Depois, no mesmo terminal
rapibase deploy ./dist | Publica o seu frontend no domínio do projeto. rapibase deploys activate volta para uma versão anterior. |
rapibase status | O que está rodando e onde. |
rapibase env pull | Escreve as chaves no .env de novo, sem mostrá-las. |
rapibase sql 'select …' | Roda SQL no Postgres do projeto. |
rapibase tables | As suas tabelas: linhas, colunas, tipos e chaves. |
rapibase api get … --anon | Testa o que um visitante vê (ou um usuário, com --jwt): o RLS se aplica. |
rapibase functions deploy | Sobe as suas functions em TypeScript (endpoints, tarefas agendadas e workers) e as recarrega na hora. |
rapibase logs --follow | Os logs do projeto, ao vivo. |
rapibase skill update | Atualiza as skills do seu agente. skill uninstall e mcp remove as removem. |
rapibase <comando> --help mostra as opções e os exemplos de cada um, em português, inglês ou espanhol. Para não digitar npx, instale com npm i -g rapibase.
Feito para agentes
--jsonimprime um único objeto: os dados, ou um erro com umcodee um código de saída que diz ao seu agente o que fazer. O progresso vai para o stderr.- Sem terminal, nada fica esperando: se falta uma escolha, ele falha e lista as opções.
- Dentro de um agente, o
loginimprime o link e o código e termina. O seu agente roda de novo depois que você aprova. - O seu agente nunca mexe em chaves:
sql,api,functionserlspassam pelo Rapibase, e a chave secreta do projeto nunca sai do servidor. - As skills do Rapibase dizem ao seu agente para publicar só quando você pedir.
- Se o seu agente já tinha um MCP antigo do Rapibase para esse projeto, o init o substitui (pergunta antes), assim ele não vê as mesmas ferramentas duas vezes.
Vários projetos
Não existe um "projeto atual" global: cada comando age sobre o projeto vinculado à pasta mais próxima e o nomeia antes de mudar qualquer coisa. --project <slug> ou RAPIBASE_PROJECT o substituem.
No CI
Crie um token de deploy no console (ele publica o site e os serviços, nada mais) e adicione este passo ao seu workflow:
- run: npx rapibase@latest deploy ./dist
env:
RAPIBASE_DEPLOY_TOKEN: ${{ secrets.RAPIBASE_DEPLOY_TOKEN }}
RAPIBASE_PROJECT: ${{ vars.RAPIBASE_PROJECT }} # o id numérico do projetoPara outros passos (functions deploy, sql…) use um token de servidor em RAPIBASE_TOKEN. rapibase --help lista todas as variáveis que o CLI lê.
Código aberto
O CLI tem licença MIT e roda no Windows, macOS e Linux (x64 e arm64). Os pacotes do npm são publicados pelo GitHub Actions com provenance. O código e a referência completa: github.com/rapibase/cli.
Coloque seu app no ar hoje
Crie um projeto grátis, conecte seu agente e peça o app. Ele configura o banco de dados, o login e a hospedagem. Sem cartão.