honeycombDocs
Start here / HONEYCOMB

Install the CLI

Native binaries, Cargo installation, shell setup, and background updates.

macOS and Linux#

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/teamofsilicons/silicon-honeycomb/main/install.sh)"

Requires Bash, curl, tar, and either sha256sum or shasum. Prebuilt binaries support x86_64 and aarch64 on macOS and Linux. The installer checks the archive checksum, requires exactly one regular honeycomb executable, and activates the replacement atomically.

The default binary lives in ~/.honeycomb/dir/system/bin. Bash, Zsh (including ZDOTDIR), and supported POSIX shell startup files receive an idempotent PATH entry. A child installer cannot change the parent terminal's environment: start a new terminal or run the printed activation command.

Cargo and Windows#

Install Rust and its platform build prerequisites, then run:

cargo install silicon-honeycomb-cli --version '=0.1.0' --locked
honeycomb --version
honeycomb service install

The command is honeycomb; the crate is silicon-honeycomb-cli. Cargo places the binary in its configured bin directory, usually ~/.cargo/bin; make sure that directory is on PATH. Cargo installation supports Windows, Linux, and macOS. Native release downloads also include Windows x86_64 and aarch64.

Release archives and checksums are available for all six required targets. The Bash installer itself is for macOS/Linux.

Choose a version or installation home#

HONEYCOMB_VERSION=0.1.0 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/teamofsilicons/silicon-honeycomb/main/install.sh)"
Variable Effect
SILICON_HOME Base directory; Honeycomb data lives under .honeycomb/dir inside it.
HONEYCOMB_VERSION Select a GitHub release version without the v prefix.
HONEYCOMB_NO_MODIFY_PATH=1 Leave shell startup files alone.
HONEYCOMB_NO_SERVICE=1 Skip automatic registration of the background update worker.
HONEYCOMB_SOURCE_DIR Explicit local checkout for a Cargo source installation.
HONEYCOMB_RELEASE_BASE Advanced override for the release source; HTTPS is required outside explicit loopback testing.

Update Honeycomb itself#

honeycomb self-update
honeycomb config set auto_update false
honeycomb daemon --once

The per-user worker checks hourly and honors auto_update. It uses launchd on macOS, systemd user services on Linux, and the platform task mechanism on Windows. Self-update verifies vendor release integrity. Application updates use honeycomb update APP_ID separately.

Build from source#

git clone https://github.com/teamofsilicons/silicon-honeycomb.git
cd silicon-honeycomb
cargo install --path crates/cli --locked

The workspace currently requires Rust 1.98 or newer. Troubleshooting covers PATH and network errors.