hivecast (0.1.32)
Installation
registry=npm install hivecast@0.1.32"hivecast": "0.1.32"About this package
HiveCast CLI
HiveCast installs two command surfaces:
hivecast: the user-facing Host command for starting, linking, and inspecting a local Host.matrix: the package command for installing, running, publishing, and inspecting Matrix packages.
Normal users should not need release or deploy scripts.
Native Installers
Build native workstation packages from the source checkout:
cd projects/matrix-3
pnpm --filter hivecast build
pnpm --filter hivecast build:deb
pnpm --filter hivecast build:pkg # macOS only
pnpm --filter hivecast build:msi # Windows only
sudo apt install ./packages/hivecast/native-dist/hivecast_0.1.31_amd64.deb
The Ubuntu/Debian package installs NATS and Host Service as systemd services:
systemctl status hivecast-nats.service
systemctl status hivecast-host.service
The macOS package installs ai.hivecast.nats and ai.hivecast.host as
LaunchDaemons. The Windows MSI installs hivecast-nats and hivecast-host as
Windows services through WinSW.
Native packages include Node and npm, so matrix install <package> works on a
fresh machine without installing a separate Node toolchain. Docker/container
installs bind HTTP/NATS to 0.0.0.0 so published ports work; workstation
installs bind locally.
It also installs the local CLI wrappers and serves Matrix Edge at:
http://127.0.0.1:3100/apps/edge/
Local Host
hivecast install
hivecast start
hivecast status
hivecast login --device
hivecast whoami
hivecast link-status
hivecast logout
Packages
matrix install @open-matrix/matrix-edge
matrix up @open-matrix/matrix-edge --serve
matrix publish
matrix publish is the package publish command for an individual package.
hivecast install is the non-system package path after the npm package is
installed. It seeds the local Host home, installs the bundled NATS binary and
default Host packages, starts the local Host by default, and serves Matrix Edge
at the local Host URL. Use hivecast install --no-start when a pairing flow must
write HiveCast link credentials before the Host starts.
Source-Checkout Operator Commands
Release and deploy helpers are exposed through hivecast operator when working
from the source checkout:
hivecast operator registry-parity
hivecast operator registry-audit
hivecast operator publish-bootstrap --plan
hivecast operator verify-machine
hivecast operator publish-hivecast-release --dry-run
hivecast operator deploy-release --dry-run
hivecast operator public-install-smoke
hivecast operator verify-public-product
hivecast operator refresh-host-package <package-dir> --home <matrix-home> --up --serve
hivecast operator refresh-edge-preview
hivecast operator smoke-edge-preview
These commands wrap the repo scripts used for bootstrap publishing, registry parity, public install smoke, and package-boundary deploy refreshes. They are operator tools, not the framework user's normal workflow.
Dependencies
Dependencies
| ID | Version |
|---|---|
| nats | ^2.29.3 |
| nkeys.js | ^1.1.0 |
Development Dependencies
| ID | Version |
|---|---|
| esbuild | ^0.25.0 |