# BMCLI Offline Package

`VERSION` is the customer product version. `BUILD_INFO.json` records the
independent Bamboo build number and Git commit. Release notes are under
`share/bmcli/doc/changelist.txt`.

Installation, update, rollback, prerequisites, and uninstall procedures are in
`share/bmcli/doc/installation.md`. Use is governed by `LICENSE.txt`.

BMCLI is self-contained in this directory. It does not require a system-wide
BMAPI installation because the matching runtime library is stored in `bin/`.

## Run Without Installation

Windows PowerShell:

```powershell
.\bin\bmcli.exe doctor
```

Linux:

```sh
./bin/bmcli doctor
```

## Install For The Current User

Windows packages can be installed with the bundled installer under
`share/bmcli/packaging/install.ps1`. Linux packages provide a root-level
installer:

```sh
./install.sh
```

The default Linux locations are `~/.local/share/bmcli` and `~/.local/bin`.
Add `~/.local/bin` to `PATH` when your distribution does not do so already.
The installer also links `bmcli(1)` into `~/.local/share/man/man1`; the complete
AI-oriented reference remains `share/bmcli/doc/bmcli_reference.md`.

Linux USB access may require the optional udev rule. Review it before installing:

```sh
./install.sh --install-udev
```

Reconnect the BUSMUST device after installing the rule. The installer never
changes udev configuration unless `--install-udev` is specified.

Use `bmcli update` for stable online updates or `bmcli update
--version=X.Y.Z` to select an archived release. The bundled uninstallers are
under `share/bmcli/packaging/`.
