Primeiros passos

A CLI do Buildprint permite que agentes de IA inspecionem e alterem aplicativos Bubble a partir de um ambiente de programação.

npm install -g buildprint

Como os agentes usam a CLI

A CLI conecta um agente a um aplicativo Bubble e fornece as ferramentas necessárias para trabalhar com ele.

Um agente pode:

• encontrar o aplicativo Bubble e a branch que deve usar;

• clonar a branch em um workspace local;

• ler e editar o aplicativo como BubbleScript;

• verificar as alterações antes de gravá-las; e

• aplicar as alterações verificadas ao Bubble.

A CLI está instalada em todos os ambientes de execução do Buildprint Agent. Ela também pode ser instalada em outro ambiente de agente.

Acesso e permissões

A CLI só pode acessar os projetos e executar as ações permitidas pela autenticação utilizada.

Para autenticar a CLI do Buildprint, use buildprint link para iniciar o fluxo do OAuth e conectar-se ao Buildprint. Você será redirecionado para buildprint.ai e poderá confirmar as permissões que deseja conceder.

Como alternativa, vincule-a a um token de acesso pessoal criado em Integrações → Tokens de acesso:

buildprint link <token>

Escolha um aplicativo e uma branch

O agente identifica o projeto e a branch exatos do Bubble antes de cloná-los.

Por exemplo, ele pode listar os projetos e branches disponíveis para nosso aplicativo de exemplo:

buildprint project list
buildprint branch list acme-app

O Bubble normalmente usa test como sua principal branch de desenvolvimento. Um agente também pode trabalhar em uma branch de recurso existente quando tiver acesso a ela.

Clone o aplicativo Bubble

A clonagem cria um workspace local do BubbleScript para uma branch do Bubble.

buildprint project clone acme-app --branch test

O agente pode pesquisar e ler o workspace como se fosse uma base de código. A clonagem é somente leitura e não altera o aplicativo Bubble.

Altere o aplicativo

O agente edita os arquivos BubbleScript no workspace clonado.

Ele pode alterar partes compatíveis do aplicativo, como páginas, elementos reutilizáveis, comportamento responsivo, workflows, tipos de dados e conjuntos de opções. As edições locais não afetam o Bubble até serem aplicadas.

Verifique a alteração

buildprint check valida o BubbleScript e mostra as alterações no Bubble que serão produzidas.

buildprint check

A verificação informa sintaxe inválida, referências ausentes, valores incorretos e alterações incompatíveis. A verificação não grava nada no Bubble.

Aplique a alteração

buildprint apply compila o BubbleScript verificado em JSON do Bubble e envia as alterações para a branch selecionada.

buildprint apply

A aplicação é interrompida se o código-fonte local ou a branch do Bubble tiverem sido alterados desde a verificação. Após uma aplicação bem-sucedida, as alterações ficam visíveis no editor do Bubble.

Sincronize as alterações do editor

buildprint sync atualiza o workspace local quando alguém altera a mesma branch no Bubble.

buildprint sync

O estado mais recente do Bubble é convertido novamente em BubbleScript e mesclado com o trabalho local do agente. O agente resolve todos os conflitos e verifica o resultado novamente antes de aplicá-lo.

Use ferramentas de execução

A CLI também fornece aos agentes ferramentas para o aplicativo Bubble em execução.

• buildprint data lê ou altera registros do banco de dados.

• buildprint logs investiga eventos de execução.

• buildprint login inicia uma sessão do navegador no modo de execução.

• buildprint screenshot captura o aplicativo em execução.

• buildprint file funciona com o gerenciador de arquivos do Bubble.

Essas ações são independentes das alterações no código-fonte BubbleScript.