Files
dbx/packages/plugin-cli

@dbx-app/plugin-cli

Precompiled dbx-plugin CLI for creating and packaging DBX plugins. Installing this package does not compile the CLI and does not require a DBX source checkout.

npm install --global @dbx-app/plugin-cli
dbx-plugin create my-plugin

Or run it without a global installation:

npx @dbx-app/plugin-cli create my-plugin

The package selects a precompiled binary for macOS, Linux, or Windows and bundles the matching Rust and Go DBX plugin SDK sources. Frontend-only plugins, including the Svelte template, require only Node.js. Rust and Go are needed only when the plugin itself has a Rust or Go backend.

dbx-plugin create my-plugin --template frontend
dbx-plugin create my-svelte-plugin --template svelte
dbx-plugin create my-rust-plugin --template rust
dbx-plugin create my-go-plugin --template go
dbx-plugin package my-plugin
dbx-plugin dev --path my-plugin --port 5190

The dev subcommand requires Node.js 22+ and runs the bundled browser development runtime, without DBX or source-tree dependencies. It supports frontend-only workbenches and Rust/Go backends, with JSONL or framed transport. Optional [dev] ui_build and ui_watch command arrays configure project builds. Development credentials are stored locally as plaintext under .dbx-dev/ (or --data-dir). Other commands retain their existing Node requirements.

中文说明

@dbx-app/plugin-cli 提供预编译的 dbx-plugin 命令。安装时不会编译 CLI,也不需要克隆 DBX 源码仓库。

npm install -g @dbx-app/plugin-cli
dbx-plugin create my-plugin

也可以直接使用:

npx @dbx-app/plugin-cli create my-plugin

npm 主包会自动选择当前操作系统对应的预编译二进制,并携带匹配版本的 Rust 和 Go 插件 SDK。纯前端插件只需要 Node.js;只有插件自身包含 Rust 或 Go 后端时才需要对应语言的编译环境。

使用 dbx-plugin dev --path my-plugin --port 5190 可在浏览器运行通用插件开发环境,无需启动 DBX。仅 dev 要求 Node.js 22+;运行时及外壳已包含在 npm 包中。开发配置和凭据以明文保存在 .dbx-dev/,不要提交或打包该目录。