Docs/CLI/Installation

Installation

Four supported install paths. All yield the same binary and the same signed provenance.

Homebrew (macOS / Linux)

bash
brew install wordcab/tap/wordcab
wordcab --version

npm (any platform with Node 18+)

bash
npm install -g @wordcab/cli
wordcab --version

Static binary

Download the release that matches your platform from github.com/wordcab/cli/releases. Binaries are Cosign-signed; the public key is published on the repo.

bash
# Linux x86_64 example
curl -L -o wordcab \\
  https://github.com/wordcab/cli/releases/latest/download/wordcab-linux-amd64
chmod +x wordcab
sudo mv wordcab /usr/local/bin/

# Verify signature
cosign verify-blob \\
  --key https://github.com/wordcab/cli/releases/latest/download/cosign.pub \\
  --signature wordcab.sig \\
  wordcab

Docker / CI image

bash
docker run --rm -it \\
  -e WORDCAB_API_KEY \\
  -v $PWD:/work \\
  ghcr.io/wordcab/cli:latest \\
  transcribe /work/call.wav --model qwen3-asr

Airgapped install

The signed binary, SHA sums, and Cosign signature are bundled with every Wordcab offline bundle. Extract and place on PATH; no internet connectivity is required.

bash
tar xzf wordcab-offline-v1.8.0.tar.gz
sudo install -m 0755 wordcab /usr/local/bin/wordcab
wordcab --version

Shell completion

bash
# bash
wordcab completion bash > /etc/bash_completion.d/wordcab

# zsh
wordcab completion zsh > "${fpath[1]}/_wordcab"

# fish
wordcab completion fish > ~/.config/fish/completions/wordcab.fish

Upgrade

bash
brew upgrade wordcab/tap/wordcab   # brew
npm install -g @wordcab/cli@latest # npm
wordcab self-update                # static binary: replaces itself, verifying the signature