Skip to main content

Install

Install with a package manager, or with the one-line installer. The installer detects your OS and architecture, downloads the matching release binary, verifies its SHA-256 checksum, and places it in a user-owned directory on your PATH: no sudo.
Once the CLI is installed, log in to Plivo, set up autocompletion, or install the agent skill if an AI coding agent will be driving the CLI. Installer options
  • PLIVO_CLI_VERSION: install a specific release tag instead of the latest (for example v0.2.0).
  • PLIVO_INSTALL_DIR: install into a specific directory instead of the first user-owned directory on PATH.
Verifying a release Release binaries for macOS, Linux and Windows (amd64 and arm64), the SHA256SUMS file and its signature are published on the GitHub releases page. The checksums are signed with cosign in keyless mode, and install.sh, install.ps1 and plivo upgrade all verify that signature when cosign is present on the machine. To check by hand:
Verified OK means the checksums genuinely came from Plivo. Pin both the identity and the issuer: without them any valid Sigstore signature would pass.

Upgrade

Keep your Plivo CLI up to date to get new commands, fixes, and security updates. Command: plivo upgrade plivo upgrade fetches the latest release, verifies the downloaded binary against the release’s SHA256SUMS (and, when cosign is installed, the signature on those checksums), then atomically replaces the running executable. It honours -o json, printing a single summary on stdout with progress on stderr. If the running binary lives inside a Homebrew prefix, upgrade refuses and points you at brew upgrade plivo so the two do not fight over the same file. Flags
  • --check: report whether a newer release exists without installing it.
  • --version <tag>: install a specific release tag instead of the latest.
  • --force: reinstall even if you are already on the target release.
Examples
The CLI also prints a one-line hint on stderr when a newer version is available (at most once every 24 hours, only when attached to a terminal). Set PLIVO_NO_UPDATE_CHECK=1 to silence it.

Shell autocompletion

Generate a completion script for your shell so that commands, subcommands, and flags tab-complete. Command: plivo completion <shell> Examples
Run plivo completion <shell> --help for shell-specific installation notes.