Install

Homebrew

With Homebrew installed, use the personal tap:

brew install bswan0002/tap/bitshelf && bs completion install

The executable is bs. The formula includes a man page, bash/zsh/fish completions, and release documentation. Running bs needs neither Rust nor Node.js. See GitHub Releases for available versions.

bs completion install previews changes and asks before editing your shell startup file; start a new shell afterward. See Shell completion for shell overrides, dry runs, and uninstalling.

Create your store:

bs init --store ~/bitshelf

To upgrade, back up your store, read the changelog, then run:

brew update
brew upgrade bitshelf

Update your agent's skill alongside the executable; see release matching.

Agent skill

Install the skill separately for your agents. With Node.js and npm installed, run:

npx skills add bswan0002/bitshelf --skill bitshelf --global

Choose your agents when prompted. --global makes the skill available across repositories. See using agents and matching releases for installing the skill from a specific release tag. The skill installer does not install the bs executable.

From source

For development or when a downloaded macOS binary is blocked, install rustup and build a reviewed release tag. The checkout selects the pinned toolchain; see platforms for the minimum source toolchain.

git clone --branch v0.1.0 https://github.com/bswan0002/bitshelf.git
cd bitshelf
cargo install --path . --locked
bs completion install        # optional; previews changes and asks first

Use the skill and docs from that same checkout. To upgrade a source installation, check out the intended release tag and rerun cargo install --path . --locked.

Release archives

Download the archive for your platform from GitHub Releases, verify it against SHA256SUMS (sha256sum on Linux, shasum -a 256 on macOS), extract it, and copy bs onto your PATH. Archives also contain the man page, completions, matching Markdown docs and skill, third-party notices, dependency inventory and BUILD-INFO.json. To update, replace them with a verified newer release; there's no self-update.

Targets:

• macOS Apple Silicon (aarch64-apple-darwin)
• macOS Intel (x86_64-apple-darwin)
• Linux x86-64 (x86_64-unknown-linux-gnu, built and tested by the release workflow on Ubuntu 22.04; glibc 2.35 baseline; see platform support for which platforms have executed evidence)

Initial 0.1.x macOS archives are not Developer ID signed or notarized, so Gatekeeper may block browser downloads. Windows and Linux ARM are deferred.

Exact tooling, runtime minimums, per-platform evidence gates and BUILD-INFO.json are described in platform support.

The first-release signing/provenance policy explicitly defers Developer ID signing, notarization and independent attestations. A local ad-hoc Mach-O signature is not trusted publisher identity; Gatekeeper assessment rejected the local candidate. A quarantined browser download has not been tested. Source installation from a reviewed tag is the fallback. No Gatekeeper/quarantine bypass is recommended.