Getting Started
Installation
Install Ghostable CLI 3.x on macOS, Linux, or Windows, then verify which binary your project is using.
macOS
The Homebrew cask installs the signed and notarized macOS release:
$ brew tap ghostable-dev/ghostable
$ brew install --cask ghostable
The global binary is available as ghostable from any project directory.
npm projects
Install the CLI as a project dependency when you want every developer and CI job to use the version declared by the repository:
$ npm install @ghostable/cli
npm places the binary at node_modules/.bin/ghostable. npm scripts resolve that binary automatically; outside a script, use npx ghostable or invoke the binary directly.
Linux and Windows
Ghostable publishes release archives for macOS, Linux, and Windows on both amd64 and arm64. Download the archive matching your operating system and architecture from the latest GitHub release, extract the binary, and place it on PATH.
On Linux and other Unix systems, make the extracted file executable before moving it to a directory on PATH. On Windows, place ghostable.exe in a directory included in the user or system PATH.
Verify the installation
$ ghostable --version
$ ghostable --help
3.x.x
If multiple copies are installed, confirm the executable resolved by your shell with which ghostable on macOS/Linux or where ghostable on Windows. A project-local npm installation may intentionally differ from a global installation.
Updating
$ # Homebrew
$ brew upgrade --cask ghostable
$ # npm
$ npm install @ghostable/cli@latest
Commit npm lockfile changes so the team and CI resolve the same CLI release.