@glasshome/widget-cli

CLI for creating and managing GlassHome widgets.

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

Command	Description
create	Create a new widget project (default when no project found)
add	Add a new widget to an existing project
build	Build 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
upgrade	Upgrade @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