NAME

kiss — package manager

SYNOPSIS

kiss [a|b|c|d|H|i|l|p|r|s|u|U|v] [pkg...]

DESCRIPTION

kiss is a tiny, self-contained package manager written in POSIX-compliant shell script. It is written with portability in mind.

Running kiss without any arguments prints help output. Every action can be written as the full name or aliased by the first letter:

a|alternatives: List and swap package alternatives
b|build: Build packages
c|checksum: Generate checksums
d|download: Download sources
H|help-ext: List all installed extensions (see Extensions).
i|install: Install packages
l|list: List installed packages
p|preferred: List the owners of all files with alternatives
r|remove: Remove packages
s|search: Search for packages
u|update: Update the repositories
U|upgrade: Update the system
v|version: Print package manager version

Extensions

Anything in the user's $PATH which matches the glob ‘kiss-*’ will be directly usable via the package manager. The shortest available alias may also be used for each extension. The second line in the script acts as a one-line doc string. The default extensions are:

chroot: Enter a kiss chroot
depends: Display a package's dependencies
fork: Copy a package's repository files into the current directory
help: Read KISS documentation
link: Link a repository file to another repository
maintainer: Find the maintainer of a package
manifest: Display all files owned by a package
new: Create a boilerplate package
orphans: List orphaned packages
outdated: Check repository for outdated packages
owns: Check which package owns a file
revdepends: Display packages which depend on package
size: Show the size on disk for a package

ENVIRONMENT

KISS_CHK: The utility to use for SHA256 checksums.
Valid: openssl, sha256, sha256sum, shasum, digest. Default is the first available in that order.
KISS_CHOICE: Set to ‘0’ to disable the alternatives system and error on any detected file conflicts.
KISS_COLOR: Set to ‘0’ to disable colorful output; otherwise colors are disabled when the utput is not a terminal.
KISS_COMPRESS: Compression method to use for built package tarballs.
Valid: gz (default), bz2, lzma, lz, xz, zst.
KISS_DEBUG: Set to ‘1’ to avoid deleting temporary directories after building packages, for debugging.
KISS_ELF: Which readelf command to use.
Valid: readelf (default), *-readelf, ldd.
KISS_FORCE: Set to ‘1’ to bypass dependency checks and force building/installation/removal of packages.
KISS_GET: Which utility to use when downloading sources.
Valid: aria2c, axel, curl, wget, wget2. Default is the first available in that order.
KISS_HOOK: A colon-separated list of absolute paths to executable files which are run as hooks.
KISS_KEEPLOG: Set to ‘1’ to keep build logs for successful builds as well as failing ones.
KISS_PATH: A colon-separated list of paths to repositories, directories which contain packages. Repositories earlier in the list have a higher priority in the case of a package being found in multiple repos.
KISS_PID: Used to determine the exact name of temporary directories, can be specified for debugging.
KISS_PROMPT: Set to ‘0’ to say “yes” and skip all prompts from the package manager.
KISS_ROOT: Where installed packages will go. Can be used to install packages to somewhere other than /.
KISS_STRIP: Set to ‘0’ to disable stripping package binaries and libraries globally.
KISS_SU: Privilege escalation utility to use.
Valid: ssu, sudo, doas, su, or any other tool compatible with sudo-like arguments.
KISS_TMPDIR: Temporary directory used for builds. Can be set to a tmpfs (often /tmp for example) so that builds happen in memory and are faster.

FILES

kiss does not use any configuration files. Files used in packages are documented in kiss(5).

EXIT STATUS

The kiss utility exits 0 on success, and >0 if an error occurs.

AUTHORS

kiss was created by Dylan Araps and the community.