Todas as coleções

Instalação e autenticação

A CLI do Buildprint transforma um branch do Bubble em uma árvore de sistema de arquivos fragmentada que você edita como código e depois compila essas edições de volta em alterações no Bubble. Esta página cobre a instalação da CLI, a vinculação dela à sua conta Buildprint e os logins extras necessários para clientes MCP e testes no navegador.

Todo o trabalho no Bubble deve passar pela CLI. As edições diretas no editor do Bubble ficam invisíveis até você sincronizar novamente, e serão sobrescritas pelo próximo apply.

Instale a CLI

Instale a CLI globalmente a partir do npm:

npm install -g buildprint

Você também pode executá-la sem uma instalação global:

npx buildprint --help

Confirme a instalação e verifique sua versão:

buildprint --version

A CLI vem com binários pré-compilados para macOS (arm64 e x64), Linux (arm64 e x64) e Windows (x64). É necessário Node 18 ou mais recente.

Atualize a CLI

Atualize para a versão lançada mais recente:

buildprint update

Se você já estiver na versão mais recente, update informa as versões atual e mais recente e sai sem reinstalar.

Verifique se existe uma versão mais nova sem instalá-la:

buildprint update --check

--check mostra as versões atual e mais recente e o comando de instalação. Ele sai com um status diferente de zero quando há uma atualização disponível, para que você possa usá-lo em scripts.

Você sempre pode reinstalar diretamente com o npm:

npm install -g buildprint@latest

Se o seu shell ainda executar a versão antiga após a atualização, reinicie o terminal ou execute hash -r.

Atualizações automáticas diárias

A CLI verifica o npm em busca de uma versão mais recente no máximo uma vez a cada 24 horas e a instala em segundo plano quando encontra uma. O estado é registrado em ~/.buildprint/update.json. A atualização automática nunca bloqueia nem falha o comando que você realmente executou - se a verificação ou a instalação falhar, ela informa para você executar buildprint update para ver os detalhes e continua.

Vincule a CLI ao Buildprint

Autentique a CLI vinculando-a à sua conta Buildprint com um token da CLI.

  1. No app web do Buildprint, vá para Integrations > CLI e gere um token da CLI.

  2. Vincule a CLI com esse token:

buildprint link <token>

Com sucesso, a CLI cumprimenta você pelo nome e lista os projetos no escopo do token, além da contagem de quaisquer outros projetos aos quais você pode acessar, mas que não estão no escopo.

Trate o token da CLI como uma senha. Qualquer pessoa que o tenha pode agir nos seus projetos do Buildprint. Se um token for perdido ou exposto, revogue-o na aba de integrações da CLI e gere um novo. Se um token se tornar inválido ou for revogado, buildprint link orienta você a gerar um novo em Integrations > CLI.

Comece aqui: quickstart

Depois de vincular, execute quickstart primeiro em qualquer sessão. Ele mostra o playbook do agente Buildprint - layout do workspace, os comandos que você usará e as convenções que a CLI espera - juntamente com o catálogo de diretrizes.

buildprint quickstart

O playbook é longo, então use paginação quando quiser ler tudo:

buildprint quickstart | less

quickstart também sinaliza quando sua CLI está atrás da versão mais recente do npm. Para explorar um app específico depois de cloná-lo, consulte o guia de exploring-an-app.

Instale o servidor MCP em um cliente de IA

Instale o servidor MCP do Buildprint em seus clientes de IA locais para que eles possam chamar as ferramentas do Buildprint diretamente. Isso cria um token MCP e grava a configuração do servidor em cada cliente selecionado.

buildprint mcp install --client opencode

Passe uma lista separada por vírgulas para instalar em vários clientes de uma vez, ou all para direcionar todos os clientes compatíveis:

buildprint mcp install --client cursor,codex
buildprint mcp install --client all --dry-run

Os clientes compatíveis são:

  • cursor

  • codex

  • claude-code

  • claude-desktop

  • opencode

  • all (todos os clientes acima)

Opções úteis:

  • --name <serverName> - nome para a entrada do servidor MCP. O padrão é buildprint. Apenas letras, números, sublinhados, pontos e hífens são permitidos.

  • --token <token> - use um token bearer MCP existente em vez de criar um novo.

  • --dry-run - pré-visualize os arquivos de configuração que seriam gravados sem criar um token ou tocar em qualquer arquivo.

  • --json - mostra saída legível por máquina.

Você precisa estar vinculado (buildprint link) antes de instalar o servidor MCP, pois a CLI emite o token MCP a partir da sua conta.

Faça login como um usuário Bubble para testes no navegador

Para controlar uma página do Bubble com sessão iniciada no Agent Browser, faça login como um usuário específico do app Bubble. Isso cria cookies run-as-user para o workspace do branch de destino e os instala no Agent Browser.

buildprint login [email protected]

Dentro de um workspace de branch clonado, o app e o branch são inferidos. Fora de um workspace, forneça-os explicitamente:

buildprint login [email protected] --app nqu-audit --branch test

Opções:

  • --app <app> - nome do app Bubble.

  • --branch <branch> - branch ou versão do Bubble.

  • --version <version> - alias para --branch.

  • --page <page> - página do Bubble a abrir após o login. O padrão é index.

  • --session <name> - nome da sessão do Agent Browser na qual instalar os cookies.

  • --no-browser - cria os cookies, mas não os instala no Agent Browser. A CLI mostra os comandos do Agent Browser para você executar.

  • --json - mostra a resposta como JSON no stdout.

Por exemplo, para fazer login em um branch e sessão nomeados:

buildprint login [email protected] --app nqu-audit --version test --session nqu-audit

Com sucesso, a CLI confirma que o Agent Browser está conectado, mostra a URL da página a abrir, o link de login run-as-user do Bubble e quaisquer credenciais de HTTP Basic Auth do modo de execução. Antes de controlar o navegador autenticado, revise a diretriz relevante:

buildprint guidelines get browser/agent-browser

Isso foi útil?