gritpack app

Install, list, upgrade and locate applications installed for your user

Generated from gritpack app --helpGritpack 1.2.63
gritpack app [OPTIONS] <COMMAND>

Commands

install
Install a command-line application for your user
list
List the applications installed for your user
upgrade
Upgrade installed applications to their newest versions
which
Show which installed application provides a command
uninstall
Remove an installed application

Options

-h, --helpPrint help

Examples

$ gritpack app list
$ gritpack app upgrade
$ gritpack app which gritpack

gritpack app install

Install a command-line application for your user

gritpack app install [OPTIONS] <PACKAGE> [VERSION]

Arguments

<PACKAGE>Name of the application package to install
[VERSION]Version or version requirement; the newest version when omitted

Options

--dialect <DIALECT>Language and version, such as c/c23, when several would match
--encoding <ENCODING>Source text encoding the package must have
--target <TARGET>Target platform; this machine's when omitted
--home <HOME>Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help (see a summary with '-h')

Hub connection

--hub <HUB>The hub, as host[:port] or https://host[:port]Environment: GRITPACK_SERVER
--cert <CERT>Client certificate for the hubEnvironment: GRITPACK_CERT
--key <KEY>Private key for the client certificateEnvironment: GRITPACK_KEY
--ca <CA>Certificate authority used to authenticate the hubEnvironment: GRITPACK_CA
--profile <PROFILE>Login profile to use; cannot be combined with --hub, --cert, --key or --caEnvironment: GRITPACK_PROFILE
--config <CONFIG>Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml
--credentials-dir <CREDENTIALS_DIR>With --hub alone: directory searched for your login; exactly one may be unexpiredEnvironment: GRITPACK_CREDENTIALS_DIR · Default: ~/.frogfish/gritpack/credentials
--cache-dir <CACHE_DIR>Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache
--jobs <JOBS>How many package downloads to run at once (1-64)Environment: GRITPACK_JOBS · Default: 4

Use one hub only

--from <HUB>Use only this hub, instead of the hubs your logins configure
--from-cert <FROM_CERT>Client certificate for the --from hub
--from-key <FROM_KEY>Private key for the --from client certificate
--from-ca <FROM_CA>Certificate authority used to authenticate the --from hub

gritpack app list

List the applications installed for your user

gritpack app list [OPTIONS]

Options

--home <HOME>Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help

gritpack app upgrade

Upgrade installed applications to their newest versions

gritpack app upgrade [OPTIONS] [PACKAGES]...

Arguments

[PACKAGES]...Installed applications to upgrade; every installed application when omitted

Options

--checkOnly report which applications have a newer version; install nothing
--home <HOME>Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help (see a summary with '-h')

Hub connection

--hub <HUB>The hub, as host[:port] or https://host[:port]Environment: GRITPACK_SERVER
--cert <CERT>Client certificate for the hubEnvironment: GRITPACK_CERT
--key <KEY>Private key for the client certificateEnvironment: GRITPACK_KEY
--ca <CA>Certificate authority used to authenticate the hubEnvironment: GRITPACK_CA
--profile <PROFILE>Login profile to use; cannot be combined with --hub, --cert, --key or --caEnvironment: GRITPACK_PROFILE
--config <CONFIG>Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml
--credentials-dir <CREDENTIALS_DIR>With --hub alone: directory searched for your login; exactly one may be unexpiredEnvironment: GRITPACK_CREDENTIALS_DIR · Default: ~/.frogfish/gritpack/credentials
--cache-dir <CACHE_DIR>Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache
--jobs <JOBS>How many package downloads to run at once (1-64)Environment: GRITPACK_JOBS · Default: 4

gritpack app which

Show which installed application provides a command

gritpack app which [OPTIONS] <COMMAND>

Arguments

<COMMAND>Name of the command to look up

Options

--home <HOME>Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help

gritpack app uninstall

Remove an installed application

gritpack app uninstall [OPTIONS] <PACKAGE>

Arguments

<PACKAGE>Name of the application package to remove

Options

--home <HOME>Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help