Primeiros passos

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

Como os agentes usam a CLI

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

Um agente pode:

• localizar o app Bubble e a branch que deve usar;

• clonar a branch em um workspace local;

• ler e editar o app como BubbleScript;

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

• aplicar as alterações verificadas ao Bubble.

A CLI está instalada em todo runtime 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 as ações permitidos pela autenticação.

Os runtimes do Buildprint Agent recebem acesso com escopo automaticamente. O acesso segue os projetos, as branches e as permissões de Plan ou Build selecionadas para a conversa.

Para outro ambiente de agente, instale a CLI e vincule-a a um token criado em Integrações → Tokens de acesso:

npm install -g buildprint
buildprint link <token>

Escolher um app 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 as branches disponíveis para nosso app 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.

Clonar o app Bubble

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

buildprint project clone acme-app --branch test

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

Alterar o app

O agente edita os arquivos BubbleScript no workspace clonado.

Ele pode alterar partes compatíveis do app, 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.

Verificar a alteração

buildprint check valida o BubbleScript e mostra as alterações no Bubble que ele produzirá.

buildprint check

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

Aplicar 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 a fonte local ou a branch do Bubble tiver sido alterada desde a verificação. Após uma aplicação bem-sucedida, as alterações ficam visíveis no editor do Bubble.

Sincronizar 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 os conflitos e verifica o resultado novamente antes de aplicá-lo.

Usar ferramentas do runtime

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

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

• buildprint logs investiga eventos do runtime.

• buildprint login inicia a sessão de um navegador no modo de execução.

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

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

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