rapibase

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 init

1 projeto grátis para sempre · sem cartão · Pro US$ 20/projeto/mês

O que o init faz

  1. 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.
  2. Cria o seu projeto ou deixa você escolher um. O plano grátis inclui um projeto, sem cartão.
  3. 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.
  4. Escreve o seu .env com as chaves do projeto. Nunca as mostra.
  5. 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 ./distPublica o seu frontend no domínio do projeto. rapibase deploys activate volta para uma versão anterior.
rapibase statusO que está rodando e onde.
rapibase env pullEscreve as chaves no .env de novo, sem mostrá-las.
rapibase sql 'select …'Roda SQL no Postgres do projeto.
rapibase tablesAs suas tabelas: linhas, colunas, tipos e chaves.
rapibase api get … --anonTesta o que um visitante vê (ou um usuário, com --jwt): o RLS se aplica.
rapibase functions deploySobe as suas functions em TypeScript (endpoints, tarefas agendadas e workers) e as recarrega na hora.
rapibase logs --followOs logs do projeto, ao vivo.
rapibase skill updateAtualiza 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

  • --json imprime um único objeto: os dados, ou um erro com um code e 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 login imprime 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, functions e rls passam 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 projeto

Para 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.