@glasshome/widget-cli

中文文档
0.21.2发布于 2026/11/16MITES Module构建来源已验证近 30 天下载 3471

CLI for creating and managing GlassHome widgets

原始使用文档
文档目录6 节
  1. Install
  2. Quick Start
  3. Commands
  4. Publishing
  5. Documentation
  6. License

@glasshome/widget-cli

CLI for creating and managing widgets for GlassHome, the local-first dashboard for Home Assistant. Scaffold, preview, and publish widgets to the GlassHome Hub; see the widget development guide for the full flow.

Install

bun add -g @glasshome/widget-cli

Quick Start

# Create a new widget project (interactive)
bunx @glasshome/widget-cli

# Or explicitly
bunx @glasshome/widget-cli create

Commands

CommandDescription
createCreate a new widget project (default when no project found)
addAdd a new widget to an existing project
buildBuild all widgets
connect <url>Connect to a running dashboard for live testing
validate [name]Validate all widgets or a specific one
publish [hub-url]Select and publish a widget to GlassHome Hub
login [hub-url]Authenticate with GlassHome Hub (required before publish)
info [name]Show widget metadata and bundle info
upgradeUpgrade @glasshome/widget-sdk to latest version

Running glasshome-widget with no command inside a widget project shows help. Outside a widget project, it starts the create wizard.

Publishing

# Login first (one-time)
glasshome-widget login

# Then publish
glasshome-widget publish

The CLI prompts you to select a widget, choose a version bump, then builds and publishes. Each widget tracks its own version in its manifest.json.

Documentation

Full docs at glasshome.app/docs

License

MIT

版本与发布记录

@glasshome/widget-cli 共发布 96 个版本,首次发布于 2026/03/23;过去 12 个月发布了 96 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.21.2latest2026/11/16今天
0.21.12026/11/16今天
0.21.02026/11/079 天前
0.20.32026/11/0610 天前
0.20.22026/11/0610 天前
0.20.12026/11/0610 天前

关于 @glasshome/widget-cli 的常见问题

@glasshome/widget-cli 是什么?

CLI for creating and managing GlassHome widgets

如何安装 @glasshome/widget-cli?

在项目目录运行 npm install @glasshome/widget-cli,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vite(^7.3.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 glasshome-widget,可以用 npx glasshome-widget 直接运行。

@glasshome/widget-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/glasshome__widget-cli 是否存在。

@glasshome/widget-cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@glasshome/widget-cli 可以商用吗?

@glasshome/widget-cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@glasshome/widget-cli 的下载量有多少?

根据 npm 官方下载统计,@glasshome/widget-cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,471 次,日均约 116 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@glasshome/widget-cli 还在维护吗?

最新版本 0.21.2 发布于 2026/11/16(今天);至今共发布 96 个版本,其中过去 12 个月发布了 96 个;首次发布于 2026/03/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。