SHELLY(1)

    Auto-generated by shelly utility --docs (shelly -Td).

Overview
Shelly — a native, unified package manager for Arch Linux repository packages, the AUR, Flatpaks, and AppImages. A bare value searches standard repositories and the AUR, then prompts for a package to install.

Commands
Command | Description
shelly search | Search ALPM repositories, the AUR, or cached Flatpak AppStream catalogs.
shelly install | Install packages or applications from ALPM repositories, the AUR, AppImages, Flatpak remotes, or local Flatpak files, and repair installed Flatpaks.
shelly upgrade | Upgrade standard, AUR, AppImage, or Flatpak packages, including all supported backends together.
shelly downgrade | Select and install an older version of a standard package.
shelly mark | Manage IgnorePkg and HoldPkg package marks, or change an installed package's explicit/dependency reason.
shelly news | Read Arch Linux news and track viewed entries.
shelly list-updates | List available updates for standard, AUR, AppImage, or Flatpak packages.
shelly list | List installed standard packages, AppImages, AUR packages, or Flatpak applications.
shelly backup | Back up explicitly installed packages as type-grouped TOML.
shelly utility | Repair Shelly directory ownership, manage pacfiles, or generate CLI documentation and shell completions.
shelly purify | Remove corrupted or orphaned ALPM packages, optionally clean the package cache, or remove unused Flatpak dependencies.
shelly remove | Remove standard or local packages, AUR packages, AppImages, or Flatpak applications.
shelly sync | Synchronize ALPM package databases, AppImage metadata, or cached Flatpak AppStream metadata.
shelly update | Update selected standard, AUR, or Flatpak packages.
shelly config | Read and modify Shelly configuration.
shelly keyring | Initialize, inspect, refresh, populate, receive, or locally sign keys in the pacman keyring.
shelly run | Launch or stop a Flatpak or AppImage application.

Shortcodes
Shortcode | Command
-Ss | shelly search standard
-Sa | shelly search aur
-Sf | shelly search flatpak
-Is | shelly install standard
-Ii | shelly install appimage
-Ia | shelly install aur
-If | shelly install flatpak
-Us | shelly upgrade standard
-Ux | shelly upgrade all
-Ui | shelly upgrade appimage
-Ua | shelly upgrade aur
-Uf | shelly upgrade flatpak
-D | shelly downgrade
-Mg | shelly mark ignore
-Mo | shelly mark hold
-Me | shelly mark explicit
-Md | shelly mark dependency
-N | shelly news
-Px | shelly list-updates all
-Ps | shelly list-updates standard
-Pi | shelly list-updates appimage
-Pa | shelly list-updates aur
-Pf | shelly list-updates flatpak
-Ls | shelly list standard
-Li | shelly list appimage
-La | shelly list aur
-Lf | shelly list flatpak
-B | shelly backup
-T | shelly utility
-Tr | shelly utility repository
-Zs | shelly purify standard
-Zf | shelly purify flatpak
-Rs | shelly remove standard
-Ri | shelly remove appimage
-Ra | shelly remove aur
-Rf | shelly remove flatpak
-Ys | shelly sync
-Yi | shelly sync appimage
-Yf | shelly sync flatpak
-Es | shelly update standard
-Ea | shelly update aur
-Ef | shelly update flatpak
-C | shelly config
-Cg | shelly config get
-Cs | shelly config set
-Cr | shelly config reset
-Cp | shelly config parallel
-Ki | shelly keyring init
-Kl | shelly keyring list
-Kr | shelly keyring refresh
-Ks | shelly keyring lsign
-Kp | shelly keyring populate
-Kv | shelly keyring recv
-Xf | shelly run flatpak
-Xi | shelly run appimage

Global Options
Option | Type | Description
--no-confirm, -n | bool | Use safe automatic answers instead of prompting
--ui-mode, -U | bool | Emit framed output for the Shelly UI
--json, -j | bool | Output structured JSON where the command supports it

Command Reference

  shelly search
Search ALPM repositories, the AUR, or cached Flatpak AppStream catalogs.

Subcommands:
Command | Description
shelly search standard | Search ALPM repository and installed packages, or Shelly-managed local binary packages. With a package and no source modifier, show exact package details.
shelly search aur | Search the AUR RPC, fetch exact package PKGBUILDs, append high-confidence standard repository matches, or show complete metadata for one AUR package.
shelly search flatpak | Search cached AppStream catalogs from every configured system and user Flatpak remote, with local pagination and remote-reference sizes and permissions.

  shelly search standard
Search ALPM repository and installed packages, or Shelly-managed local binary packages. With a package and no source modifier, show exact package details.

Usage:
    shelly search standard [<package>] [options]

Arguments:
Argument | Arity | Description
<package> | 0..1 | Package name or search term; without a source modifier, an exact name opens package details

Options:
Option | Type | Description
--repos, -r | bool | List repositories parsed from pacman.conf and ignore other search modifiers
--available, -v | bool | Search packages from the configured ALPM synchronization databases
--installed, -i | bool | Search packages from the local ALPM database
--local, -l | bool | Search Shelly-managed binary packages installed under /opt/shelly
--limit, -t <limit> | int | Maximum number of search results to return per page
--page, -p <page> | int | Page number for paginated results
--show-hidden, -w | bool | Include packages hidden by pacman IgnorePkg configuration
--detail, --info, -d | bool | Show complete metadata for one exact ALPM package name
--group, -g | bool | List package groups or restrict available packages to the requested group
--explicit, -e | bool | Shows only explicitly installed pacakges
--depends, -D | bool | Shows only dependency packages

  shelly search aur
Search the AUR RPC, fetch exact package PKGBUILDs, append high-confidence standard repository matches, or show complete metadata for one AUR package.

Usage:
    shelly search aur <query>... [options]

Arguments:
Argument | Arity | Description
<query> | 1..* | Search words joined for an AUR RPC query, or exact AUR package names when --pkgbuild or --detail is passed

Options:
Option | Type | Description
--standard, -s | bool | Append high-confidence standard ALPM repository matches to the AUR results
--pkgbuild, -p | bool | Fetch and display the PKGBUILD for each exact AUR package name
--detail, --info, -d | bool | Show complete metadata for one exact AUR package name

  shelly search flatpak
Search cached AppStream catalogs from every configured system and user Flatpak remote, with local pagination and remote-reference sizes and permissions.

Usage:
    shelly search flatpak <query> [options]

Arguments:
Argument | Arity | Description
<query> | 1..1 | Application name or ID matched against the configured remotes' local AppStream catalogs

Options:
Option | Type | Description
--limit, -t <limit> | int | Maximum number of search results to return per page
--page, -p <page> | int | Page number for paginated results

  shelly install
Install packages or applications from ALPM repositories, the AUR, AppImages, Flatpak remotes, or local Flatpak files, and repair installed Flatpaks.

Subcommands:
Command | Description
shelly install standard | Install ALPM repository packages, local Arch or Shelly binary archives, and package archives downloaded from HTTP(S) URLs.
shelly install appimage | Install a local AppImage into the configured AppImage directory and update Shelly's AppImage metadata database.
shelly install aur | Fetch, review, build, and install one or more AUR packages, install one package's build dependencies, or install one package at an exact Git commit.
shelly install flatpak | Install a Flatpak application, runtime, .flatpakref file, or bundle, or repair an installed Flatpak while preserving its configuration.

  shelly install standard
Install ALPM repository packages, local Arch or Shelly binary archives, and package archives downloaded from HTTP(S) URLs.

Usage:
    shelly install standard [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | One or more repository names, repository-qualified names, local archive paths, or HTTP(S) package URLs

Options:
Option | Type | Description
--build-deps, -b | bool | Install build dependencies for the requested packages
--make-deps, -m | bool | Install make dependencies for the requested packages
--no-deps, -d | bool | Pass the ALPM nodeps transaction flag when installing repository packages
--upgrade, -u | bool | After confirmation, synchronize and upgrade the standard system before installing the requested repository packages

  shelly install appimage
Install a local AppImage into the configured AppImage directory and update Shelly's AppImage metadata database.

Usage:
    shelly install appimage <location> [options]

Arguments:
Argument | Arity | Description
<location> | 1..1 | Path to an existing file whose extension is .AppImage

Options:
Option | Type | Description
--install-path <install-path> | string | Directory to install the AppImage into; overrides the configured AppImageInstallPath

  shelly install aur
Fetch, review, build, and install one or more AUR packages, install one package's build dependencies, or install one package at an exact Git commit.

Usage:
    shelly install aur [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | AUR package names; dependency-only mode accepts one package, while --version requires exactly one package followed by its Git commit

Options:
Option | Type | Description
--build-deps, -b | bool | Install build dependencies for the requested packages
--make-deps, -m | bool | Install make dependencies for the requested packages
--chroot, -c | bool | Build packages in a clean chroot with makechrootpkg
--check | bool | Enable the PKGBUILD check() function during package builds
--version, -v | bool | Install exactly one AUR package from the following Git commit operand

  shelly install flatpak
Install a Flatpak application, runtime, .flatpakref file, or bundle, or repair an installed Flatpak while preserving its configuration.

Usage:
    shelly install flatpak <package> [options]

Arguments:
Argument | Arity | Description
<package> | 1..1 | Application/runtime ID, friendly AppStream name, installed target with --repair, .flatpakref path with --ref-file, or bundle path with --bundle

Options:
Option | Type | Description
--user | bool | Install into the invoking user's Flatpak installation instead of the system installation
--remote, -r <remote> | string | Install from this remote instead of resolving a remote from cached AppStream metadata
--branch, -b <branch> | string | Install this branch; defaults to the branch the remote publishes for the package
--runtime | bool | Build a runtime ref instead of an application ref
--ref-file, -e | bool | Treat the package operand as a local .flatpakref file
--bundle, -u | bool | Treat the package operand as a local Flatpak bundle
--repair, -f | bool | Reinstall the installed Flatpak and its dependencies while preserving application configuration

  shelly upgrade
Upgrade standard, AUR, AppImage, or Flatpak packages, including all supported backends together.

Subcommands:
Command | Description
shelly upgrade standard | Synchronize ALPM repositories, show the available repository package upgrades, perform a full system upgrade, and report required restarts.
shelly upgrade all | Build and confirm an invoking-user upgrade plan, then upgrade every enabled package backend in one coordinated action, continuing through independent backend failures and returning failure if any selected backend fails.
shelly upgrade appimage | Check every configured AppImage update source and replace each AppImage for which a newer version is available.
shelly upgrade aur | Find installed foreign packages with newer AUR or VCS revisions, then build and install all available upgrades.
shelly upgrade flatpak | Upgrade every application and runtime with an available update in the system and user Flatpak installations.

  shelly upgrade standard
Synchronize ALPM repositories, show the available repository package upgrades, perform a full system upgrade, and report required restarts.

Usage:
    shelly upgrade standard [options]

Options:
Option | Type | Description
--all, -a | bool | Upgrade standard, AUR, Flatpak, and AppImage backends

  shelly upgrade all
Build and confirm an invoking-user upgrade plan, then upgrade every enabled package backend in one coordinated action, continuing through independent backend failures and returning failure if any selected backend fails.

Usage:
    shelly upgrade all [options]

Options:
Option | Type | Description
--no-repo | bool | Skip the standard ALPM backend
--no-aur | bool | Skip the AUR backend
--no-flatpak | bool | Skip the Flatpak backend
--no-appimage | bool | Skip the AppImage backend
--no-devel | bool | Skip -git aur

  shelly upgrade appimage
Check every configured AppImage update source and replace each AppImage for which a newer version is available.

Usage:
    shelly upgrade appimage

  shelly upgrade aur
Find installed foreign packages with newer AUR or VCS revisions, then build and install all available upgrades.

Usage:
    shelly upgrade aur [options]

Options:
Option | Type | Description
--check | bool | Run each PKGBUILD check() function during AUR upgrade builds
--singlepane | bool | Use the shared pacman-style linear output (already the native Zig non-UI output mode)
--no-devel | bool | Skip checking -git packages

  shelly upgrade flatpak
Upgrade every application and runtime with an available update in the system and user Flatpak installations.

Usage:
    shelly upgrade flatpak

  shelly downgrade
Select and install an older version of a standard package.

Usage:
    shelly downgrade [<package>] [options]

Arguments:
Argument | Arity | Description
<package> | 0..1 | Installed ALPM package to downgrade

Options:
Option | Type | Description
--oldest, -o | bool | Select the oldest available version instead of prompting or selecting the newest version
--ignore, -i | bool | Add the package to IgnorePkg after a successful downgrade
--list-options, -l | bool | List cached and archived versions without installing one
--target, -t <target> | string | Install an exact version-release or package filename

  shelly mark
Manage IgnorePkg and HoldPkg package marks, or change an installed package's explicit/dependency reason.

Subcommands:
Command | Description
shelly mark ignore | List or modify packages excluded from ALPM upgrades through IgnorePkg.
shelly mark hold | List or modify packages protected from removal through HoldPkg.
shelly mark explicit | Mark an installed ALPM package as explicitly installed.
shelly mark dependency | Mark an installed ALPM package as installed as a dependency.

  shelly mark ignore
List or modify packages excluded from ALPM upgrades through IgnorePkg.

Usage:
    shelly mark ignore [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | Package names to add to or remove from IgnorePkg

Options:
Option | Type | Description
--list, -l | bool | List packages in IgnorePkg
--add, -a | bool | Add packages to IgnorePkg
--remove, -r | bool | Remove packages from IgnorePkg
--clear, -c | bool | Clear IgnorePkg

  shelly mark hold
List or modify packages protected from removal through HoldPkg.

Usage:
    shelly mark hold [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | Package names to add to or remove from HoldPkg

Options:
Option | Type | Description
--list, -l | bool | List packages in HoldPkg
--add, -a | bool | Add packages to HoldPkg
--remove, -r | bool | Remove packages from HoldPkg
--clear, -c | bool | Clear HoldPkg except for Shelly's protected entry

  shelly mark explicit
Mark an installed ALPM package as explicitly installed.

Usage:
    shelly mark explicit <package>

Arguments:
Argument | Arity | Description
<package> | 1..1 | Installed package whose reason should be changed

  shelly mark dependency
Mark an installed ALPM package as installed as a dependency.

Usage:
    shelly mark dependency <package>

Arguments:
Argument | Arity | Description
<package> | 1..1 | Installed package whose reason should be changed

  shelly news
Read Arch Linux news and track viewed entries.

Usage:
    shelly news [options]

Options:
Option | Type | Description
--all, -a | bool | Show previously viewed news as well as unread entries

  shelly list-updates
List available updates for standard, AUR, AppImage, or Flatpak packages.

Subcommands:
Command | Description
shelly list-updates all | Query available updates from every supported package backend, continuing through independent backend failures.
shelly list-updates standard | List available standard repository package updates.
shelly list-updates appimage | List installed AppImages with available updates.
shelly list-updates aur | List installed AUR packages with available updates.
shelly list-updates flatpak | List Flatpak applications and runtimes with available updates.

  shelly list-updates all
Query available updates from every supported package backend, continuing through independent backend failures.

Usage:
    shelly list-updates all [options]

Options:
Option | Type | Description
--show-hidden | bool | Include hidden packages
--no-devel | bool | Does not check for -git builds

  shelly list-updates standard
List available standard repository package updates.

Usage:
    shelly list-updates standard

  shelly list-updates appimage
List installed AppImages with available updates.

Usage:
    shelly list-updates appimage

  shelly list-updates aur
List installed AUR packages with available updates.

Usage:
    shelly list-updates aur [options]

Options:
Option | Type | Description
--show-hidden | bool | Include hidden packages
--no-devel | bool | Does not check for -git builds

  shelly list-updates flatpak
List Flatpak applications and runtimes with available updates.

Usage:
    shelly list-updates flatpak

  shelly list
List installed standard packages, AppImages, AUR packages, or Flatpak applications.

Subcommands:
Command | Description
shelly list standard | List packages installed in the local ALPM database, with optional IgnorePkg and install-reason filters.
shelly list appimage | List installed AppImages.
shelly list aur | List installed foreign packages tracked as AUR packages.
shelly list flatpak | List installed Flatpaks, configured system and user remotes, or cached AppStream JSON for one or every remote.

  shelly list standard
List packages installed in the local ALPM database, with optional IgnorePkg and install-reason filters.

Usage:
    shelly list standard [options]

Options:
Option | Type | Description
--show-hidden, -w | bool | Include hidden packages
--explicitOnly, -e | bool | List explicitly installed packages only
--dependencyOnly, -d | bool | List dependency-installed packages only
--required-by | bool | Include packages that directly require each listed package
--optional-for | bool | Include packages that directly use each listed package optionally

  shelly list appimage
List installed AppImages.

Usage:
    shelly list appimage

  shelly list aur
List installed foreign packages tracked as AUR packages.

Usage:
    shelly list aur [options]

Options:
Option | Type | Description
--show-hidden | bool | Include hidden packages
--explicitOnly, -e | bool | List explicitly installed packages only
--dependencyOnly, -d | bool | List dependency-installed packages only
--required-by | bool | Include packages that directly require each listed package
--optional-for | bool | Include packages that directly use each listed package optionally

  shelly list flatpak
List installed Flatpaks, configured system and user remotes, or cached AppStream JSON for one or every remote.

Usage:
    shelly list flatpak [<source>] [<query>]

Arguments:
Argument | Arity | Description
<source> | 0..1 | Use remote to return cached remote AppStream applications instead of installed Flatpaks
<query> | 0..1 | Remote name, or all; omit it to list the configured system and user remotes

  shelly backup
Back up explicitly installed packages as type-grouped TOML.

Usage:
    shelly backup [options]

Options:
Option | Type | Description
--export, -e | bool | Exports a declaritive list of explicitly installed standard packages, AUR packages, and Flatpak applications
--import, -i | bool | Imports a previously exported backup and installs the latest versions of all items listed
--name, -a <name> | string | File name without the .toml extension
--directory, -d <directory> | string | Directory in which to write/read the backup

  shelly utility
Repair Shelly directory ownership, manage pacfiles, or generate CLI documentation and shell completions.

Subcommands:
Command | Description
shelly utility repository | Add, remove, or list pacman.conf ALPM repositories; optionally locally sign a key and refresh databases.

Usage:
    shelly utility [options]

Options:
Option | Type | Description
--fix-permissions, -f | bool | Restore the invoking user's ownership of Shelly's configuration, cache, and data directories
--repair-db, -r | bool | Remove a stale database lock
--docs, -d | bool | Write Markdown CLI reference documentation to standard output
--completions, -c <completions> | string | Write a Bash, Fish, or Zsh completion script to standard output Choices: bash, fish, zsh.
--pacfiles, -p | bool | Run the pacdiff-compatible pacnew, pacorig, and pacsave maintenance workflow
--find, -F | bool | Recursively find pacfiles instead of reading the pacman database
--locate, -l | bool | Find pacfiles with locate instead of reading the pacman database
--pacmandb, -P | bool | Search backup paths from the local pacman database (default)
--backup, -b | bool | Save the old original as .bak before overwriting
--cachedir, -C <cachedir> | string | Package cache directory for three-way base archives; repeat to add directories
--output, -o | bool | Print discovered pacfile paths without modifying them
--sudo, -s | bool | Explicitly request elevation; interactive pacfile maintenance elevates automatically
--threeway, -3 | bool | Use a cached older package as the third input when viewing differences
--nocolor | bool | Disable colored pacfile status output
--search-path <search-path> | string | Path to scan with --find; repeat to add paths
--diff-program <diff-program> | string | Diff command, overriding DIFFPROG
--merge-program <merge-program> | string | Merge command, overriding MERGEPROG

  shelly utility repository
Add, remove, or list pacman.conf ALPM repositories; optionally locally sign a key and refresh databases.

Usage:
    shelly utility repository [<name>] [<url>] [options]

Arguments:
Argument | Arity | Description
<name> | 0..1 | Repository (database) name, e.g. my-repo
<url> | 0..1 | Server URL; required for --add, e.g. 'https://my-repo.ee/$arch/$repo', ignored for --remove/--list

Options:
Option | Type | Description
--add, -a | bool | Add the named repository (requires name and url)
--remove, -x | bool | Remove the named repository
--list, -l | bool | List configured repositories
--no-sync, -n | bool | Skip the final database refresh
--lsign-key, -s <lsign-key> | string | Key to locally sign with pacman-key before adding

  shelly purify
Remove corrupted or orphaned ALPM packages, optionally clean the package cache, or remove unused Flatpak dependencies.

Subcommands:
Command | Description
shelly purify standard | Plan corrupted archives, optional orphan cleanup, and optional cache retention cleanup; show the targets, then confirm before changing ALPM or cache state.
shelly purify flatpak | Plan unused dependency cleanup across system and user Flatpak installations, then show and confirm the targets.

  shelly purify standard
Plan corrupted archives, optional orphan cleanup, and optional cache retention cleanup; show the targets, then confirm before changing ALPM or cache state.

Usage:
    shelly purify standard [options]

Options:
Option | Type | Description
--dry-run, -d | bool | Show the cleanup plan without changing packages
--orphans, -o | bool | Include orphaned packages
--cache, -c <cache> | uint | Remove older cached package versions while retaining this many versions

  shelly purify flatpak
Plan unused dependency cleanup across system and user Flatpak installations, then show and confirm the targets.

Usage:
    shelly purify flatpak

  shelly remove
Remove standard or local packages, AUR packages, AppImages, or Flatpak applications.

Subcommands:
Command | Description
shelly remove standard | Remove installed ALPM packages or Shelly-managed local binaries, with optional dependency and configuration cleanup.
shelly remove appimage | Remove an installed AppImage and optionally delete its associated configuration.
shelly remove aur | Remove installed AUR packages and optionally remove dependent or optional packages through ALPM.
shelly remove flatpak | Remove an installed Flatpak application or runtime, with optional unused dependency and configuration cleanup.

  shelly remove standard
Remove installed ALPM packages or Shelly-managed local binaries, with optional dependency and configuration cleanup.

Usage:
    shelly remove standard [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | Packages to remove

Options:
Option | Type | Description
--cascade, -c | bool | Remove dependencies that are no longer needed
--no-cascade | bool | Keep dependencies that become unneeded after removal
--opt-deps, -o | bool | Remove unused optional dependencies installed with the packages
--ripple, -i | bool | Remove packages that depend on the removed packages
--remove-config | bool | Remove configuration associated with the removed package
--local, -l | bool | Remove Shelly-managed local binaries
--force, -f | bool | Force local binary removal

  shelly remove appimage
Remove an installed AppImage and optionally delete its associated configuration.

Usage:
    shelly remove appimage <appimage> [options]

Arguments:
Argument | Arity | Description
<appimage> | 1..1 | Installed AppImage to remove

Options:
Option | Type | Description
--remove-config | bool | Remove configuration associated with the removed package

  shelly remove aur
Remove installed AUR packages and optionally remove dependent or optional packages through ALPM.

Usage:
    shelly remove aur [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | Packages to remove

Options:
Option | Type | Description
--cascade, -c | bool | Remove dependencies that are no longer needed
--opt-deps, -o | bool | Remove unused optional dependencies installed with the packages
--ripple, -i | bool | Remove packages that depend on the removed packages

  shelly remove flatpak
Remove an installed Flatpak application or runtime, with optional unused dependency and configuration cleanup.

Usage:
    shelly remove flatpak <package> [options]

Arguments:
Argument | Arity | Description
<package> | 1..1 | Installed Flatpak application or runtime ID

Options:
Option | Type | Description
--remove-unused, -r | bool | Remove newly unused Flatpak dependencies
--remove-config | bool | Remove configuration associated with the removed package

  shelly sync
Synchronize ALPM package databases, AppImage metadata, or cached Flatpak AppStream metadata.

Subcommands:
Command | Description
shelly sync appimage | Synchronize extracted AppImage metadata, or configure an installed AppImage's update source with the appimage/url/type overload.
shelly sync flatpak | Update cached AppStream metadata, or add and remove configured system or user Flatpak remotes.

Usage:
    shelly sync [options]

Options:
Option | Type | Description
--force, -f | bool | Force every configured ALPM package database to refresh

  shelly sync appimage
Synchronize extracted AppImage metadata, or configure an installed AppImage's update source with the appimage/url/type overload.

Usage:
    shelly sync appimage [<appimage>] [<url>] [<type>] [options]

Arguments:
Argument | Arity | Description
<appimage> | 0..1 | Optional case-insensitive AppImage name query
<url> | 0..1 | Update URL or owner/repository value when configuring updates
<type> | 0..1 | Update source type when configuring updates

Options:
Option | Type | Description
--prerelease, -p | bool | Allow prerelease versions for the configured update source

  shelly sync flatpak
Update cached AppStream metadata, or add and remove configured system or user Flatpak remotes.

Usage:
    shelly sync flatpak [<mode>] [<operation>] [<name>] [options]

Arguments:
Argument | Arity | Description
<mode> | 0..1 | Use remote to configure Flatpak remotes; omit to update AppStream metadata
<operation> | 0..1 | Add or remove a configured remote
<name> | 0..1 | Flatpak remote name, such as flathub

Options:
Option | Type | Description
--remote-url, -u <remote-url> | string | Remote URL or .flatpakrepo URL; required for remote add
--system, -s | bool | Use system scope; defaults to true
--gpg-verify, -g | bool | Enable GPG verification when adding; defaults to true

  shelly update
Update selected standard, AUR, or Flatpak packages.

Subcommands:
Command | Description
shelly update standard | Update only the named installed ALPM packages after an explicit partial-upgrade warning and confirmation.
shelly update aur | Fetch, review, rebuild, and reinstall only the named AUR packages.
shelly update flatpak | Update one installed Flatpak application or runtime in its existing user or system installation.

  shelly update standard
Update only the named installed ALPM packages after an explicit partial-upgrade warning and confirmation.

Usage:
    shelly update standard [<packages>...]

Arguments:
Argument | Arity | Description
<packages> | 0..* | One or more installed repository package names to update; partial upgrades are unsupported by Arch Linux and require confirmation

  shelly update aur
Fetch, review, rebuild, and reinstall only the named AUR packages.

Usage:
    shelly update aur [<packages>...] [options]

Arguments:
Argument | Arity | Description
<packages> | 0..* | One or more AUR package names to rebuild and reinstall

Options:
Option | Type | Description
--check | bool | Run each PKGBUILD check() function during the rebuild

  shelly update flatpak
Update one installed Flatpak application or runtime in its existing user or system installation.

Usage:
    shelly update flatpak <package>

Arguments:
Argument | Arity | Description
<package> | 1..1 | Installed Flatpak application/runtime ID or unambiguous friendly name

  shelly config
Read and modify Shelly configuration.

Subcommands:
Command | Description
shelly config get | Read a Shelly configuration value.
shelly config set | Set a Shelly configuration value.
shelly config reset | Reset Shelly configuration to native defaults.
shelly config parallel | Set Shelly's parallel download count.

Usage:
    shelly config

  shelly config get
Read a Shelly configuration value.

Usage:
    shelly config get <key>

Arguments:
Argument | Arity | Description
<key> | 1..1 | Configuration property name

  shelly config set
Set a Shelly configuration value.

Usage:
    shelly config set <key> <value>

Arguments:
Argument | Arity | Description
<key> | 1..1 | Configuration property name
<value> | 1..1 | New configuration value

  shelly config reset
Reset Shelly configuration to native defaults.

Usage:
    shelly config reset

  shelly config parallel
Set Shelly's parallel download count.

Usage:
    shelly config parallel <downloadCount>

Arguments:
Argument | Arity | Description
<downloadCount> | 1..1 | Maximum number of parallel downloads

  shelly keyring
Initialize, inspect, refresh, populate, receive, or locally sign keys in the pacman keyring.

Subcommands:
Command | Description
shelly keyring init | Initialize the pacman keyring.
shelly keyring list | List keys in the pacman keyring.
shelly keyring refresh | Refresh pacman keyring keys from the configured keyserver.
shelly keyring lsign | Locally sign one or more keys in the pacman keyring.
shelly keyring populate | Populate the pacman keyring with default or named distribution keys.
shelly keyring recv | Receive one or more keys from the configured or requested keyserver.

  shelly keyring init
Initialize the pacman keyring.

Usage:
    shelly keyring init

  shelly keyring list
List keys in the pacman keyring.

Usage:
    shelly keyring list

  shelly keyring refresh
Refresh pacman keyring keys from the configured keyserver.

Usage:
    shelly keyring refresh

  shelly keyring lsign
Locally sign one or more keys in the pacman keyring.

Usage:
    shelly keyring lsign <keys>...

Arguments:
Argument | Arity | Description
<keys> | 1..* | One or more key identifiers

  shelly keyring populate
Populate the pacman keyring with default or named distribution keys.

Usage:
    shelly keyring populate [<keys>...]

Arguments:
Argument | Arity | Description
<keys> | 0..* | Distribution keyring names; omit to populate the defaults

  shelly keyring recv
Receive one or more keys from the configured or requested keyserver.

Usage:
    shelly keyring recv <keys>... [options]

Arguments:
Argument | Arity | Description
<keys> | 1..* | One or more key identifiers

Options:
Option | Type | Description
--keyserver <keyserver> | string | Keyserver from which to receive keys

  shelly run
Launch or stop a Flatpak or AppImage application.

Subcommands:
Command | Description
shelly run flatpak | Launch an installed Flatpak application, stop it with --kill, or list running instances with run flatpak list.
shelly run appimage | Launch an installed AppImage, or stop it with --kill.

  shelly run flatpak
Launch an installed Flatpak application, stop it with --kill, or list running instances with run flatpak list.

Usage:
    shelly run flatpak [<package>] [options]

Arguments:
Argument | Arity | Description
<package> | 0..1 | Flatpak application ID or friendly name; use list to show running applications

Options:
Option | Type | Description
--kill, -k | bool | Stop the selected application instead of launching it
--list, -l | bool | List running Flatpak applications and process identifiers

  shelly run appimage
Launch an installed AppImage, or stop it with --kill.

Usage:
    shelly run appimage <package> [options]

Arguments:
Argument | Arity | Description
<package> | 1..1 | Installed AppImage name or path

Options:
Option | Type | Description
--kill, -k | bool | Stop the selected application instead of launching it

AUTHORS
Seafoam Labs.