buildprint-cli

A plugin that gives AI coding agents the workflow, safety guardrails, and command reference to effectively use the Buildprint CLI for Bubble.io app development. Works with Claude Code, OpenAI Codex CLI, and OpenCode.

What it does

When you work with Bubble.io apps via the Buildprint CLI, this plugin:

• Enforces the canonical workflow: sync → explore → fetch guidelines → edit → check → apply
• Fetches the right Buildprint guidelines before each type of edit (data types, workflows, privacy rules, etc.) using buildprint guidelines get
• Provides a cached CLI command reference so Claude doesn't call --help repeatedly
• Enforces safety guardrails: no --no-check, savepoints before structural changes, explicit confirmation before live deployments

Why

When using Buildprint on the web, the platform automatically injects rich context before every agent call — Bubble's entity model, valid action types, security patterns, workflow guardrails. On the CLI, the agent sees only JSON files. This plugin replicates that context injection experience.

Requirements

• Buildprint CLI installed and authenticated
• Claude Code, OpenAI Codex CLI, or OpenCode

Installation

Claude Code

In any Claude Code session, run:

/plugin marketplace add rafachavantes/using-buildprint-cli
/plugin install buildprint-cli@buildprint-cli
/reload-plugins

Codex CLI

codex plugin marketplace add rafachavantes/using-buildprint-cli

Then open /plugins in Codex CLI and install buildprint-cli.

OpenCode

Add the plugin to the plugin array in your opencode.json (global at ~/.config/opencode/opencode.json, or project-level):

{
  "plugin": ["buildprint-cli@git+https://github.com/rafachavantes/using-buildprint-cli"]
}

Restart OpenCode. The plugin installs through OpenCode's plugin manager (via Bun) and registers its skill directory so using-buildprint-cli is discoverable through the native skill tool — no symlinks or manual copies. See .opencode/INSTALL.md for migration, update, and troubleshooting notes.

Note: The same skill works identically on all three platforms. No configuration differences.

Setup

npm install -g buildprint
buildprint link <your-token>   # Token: Buildprint → Integrations → CLI
buildprint project list        # Verify auth

Typical session

buildprint project clone <appId> --branch test
cd my-app/test
# Claude activates the skill automatically from here

Links

• Buildprint docs
• Buildprint CLI reference
• Bubble.io