The CLI reference lists the commands by task. This page is generated from the development branch's help; run packslip install --help for the options your installed version supports.

packslip install

Install a verified release and export its declared commands

Find the release a project's name leads to, and verify its release bundle and the artifact for this host. Unpack the archive into an installation tree and export the commands the release declares.

A github.com project must be signed from its repository. A keyless domain project's first install trusts the signer that its release list and release bundle declare, fetched over HTTPS from that host. A key-signed domain project needs --pubkey on its first install. Later installs hold the project to what was accepted, and a keyless domain project to the repository that signed it. A changed signer or signing repository, keyless signing replaced by a key, disabled workflow pinning, a repackager's bundle after the vendor's, or dropped provenance needs --accept-trust-change, and a github.com name that now resolves to a different repository ID is refused. --pin, --issuer, --identity, and --identity-prefix narrow what the project's name requires and never replace it. gitlab.com projects are refused.

The command runs no downloaded code, installs no dependencies, and edits no shell configuration. There is no uninstall, upgrade, or list. It prints the installed version and tree, Signer fingerprint: ps1_... for a github.com project, and each command. It warns when the project's release list withdraws the release it last installed. See https://packslip.dev/docs/bootstrap/

Arguments

Flags

Examples

Install the latest release of hk

packslip install github.com/jdx/hk

Install hk 2.8.0 and require its signer fingerprint

packslip install github.com/jdx/hk \
        --version 2.8.0 \
        --pin ps1_snirenkjwr7m5ozgcufameodnm

Install a key-signed domain project

packslip install mytool.example.com --pubkey release.pub