fpf-cli 1.0.0

package/fpf

@@ -0,0 +1,962 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_NAME="fpf"
+TMP_ROOT="${TMPDIR:-/tmp}/fpf"
+HELP_FILE="${TMP_ROOT}/help"
+KBINDS_FILE="${TMP_ROOT}/keybinds"
+
+ACTION="search"
+MANAGER_OVERRIDE=""
+declare -a QUERY_PARTS=()
+
+log() {
+    printf "%s\n" "$*" >&2
+}
+
+die() {
+    log "Error: $*"
+    exit 1
+}
+
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+ensure_tmp_root() {
+    mkdir -p "${TMP_ROOT}"
+}
+
+run_as_root() {
+    if [[ "${EUID}" -eq 0 ]]; then
+        "$@"
+        return
+    fi
+
+    if command_exists sudo; then
+        sudo "$@"
+        return
+    fi
+
+    die "Root privileges are required for: $*"
+}
+
+manager_list() {
+    printf "%s\n" "apt dnf pacman zypper emerge brew snap flatpak npm bun"
+}
+
+manager_supported() {
+    local manager="$1"
+    case "${manager}" in
+        apt|dnf|pacman|zypper|emerge|brew|snap|flatpak|npm|bun)
+            return 0
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+manager_command_ready() {
+    local manager="$1"
+    case "${manager}" in
+        apt)
+            command_exists apt-cache && command_exists apt-get && command_exists dpkg-query
+            ;;
+        dnf)
+            command_exists dnf
+            ;;
+        pacman)
+            command_exists pacman
+            ;;
+        zypper)
+            command_exists zypper
+            ;;
+        emerge)
+            command_exists emerge
+            ;;
+        brew)
+            command_exists brew
+            ;;
+        snap)
+            command_exists snap
+            ;;
+        flatpak)
+            command_exists flatpak
+            ;;
+        npm)
+            command_exists npm
+            ;;
+        bun)
+            command_exists bun
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+normalize_manager() {
+    printf "%s" "$1" | tr '[:upper:]' '[:lower:]'
+}
+
+os_release_field() {
+    local file_path="$1"
+    local field_name="$2"
+
+    awk -v key="${field_name}" '
+        index($0, key "=") == 1 {
+            value = substr($0, index($0, "=") + 1)
+            gsub(/^[[:space:]]+|[[:space:]]+$/, "", value)
+            if (value ~ /^".*"$/ || value ~ /^\047.*\047$/) {
+                value = substr(value, 2, length(value) - 2)
+            }
+            print tolower(value)
+            exit
+        }
+    ' "${file_path}"
+}
+
+manager_label() {
+    local manager="$1"
+    case "${manager}" in
+        apt) printf "APT" ;;
+        dnf) printf "DNF" ;;
+        pacman) printf "Pacman" ;;
+        zypper) printf "Zypper" ;;
+        emerge) printf "Portage (emerge)" ;;
+        brew) printf "Homebrew" ;;
+        snap) printf "Snap" ;;
+        flatpak) printf "Flatpak" ;;
+        npm) printf "npm" ;;
+        bun) printf "bun" ;;
+        *) printf "%s" "${manager}" ;;
+    esac
+}
+
+detect_default_manager() {
+    local os
+    os="$(uname -s)"
+
+    if [[ "${os}" == "Darwin" ]]; then
+        if command_exists brew; then
+            printf "brew"
+            return
+        fi
+    fi
+
+    if [[ "${os}" == "Linux" ]]; then
+        local distro_id=""
+        local distro_like=""
+        local os_release_file="${FPF_OS_RELEASE_FILE:-}"
+
+        if [[ -n "${os_release_file}" && ! -r "${os_release_file}" ]]; then
+            die "FPF_OS_RELEASE_FILE is set but not readable: ${os_release_file}"
+        fi
+
+        if [[ -z "${os_release_file}" && -r /etc/os-release ]]; then
+            os_release_file="/etc/os-release"
+        elif [[ -z "${os_release_file}" && -r /usr/lib/os-release ]]; then
+            os_release_file="/usr/lib/os-release"
+        fi
+
+        if [[ -n "${os_release_file}" ]]; then
+            distro_id="$(os_release_field "${os_release_file}" "ID")"
+            distro_like="$(os_release_field "${os_release_file}" "ID_LIKE")"
+        fi
+
+        case "${distro_id} ${distro_like}" in
+            *arch*|*manjaro*)
+                if command_exists pacman; then printf "pacman"; return; fi
+                ;;
+            *ubuntu*|*debian*|*linuxmint*|*pop*|*elementary*)
+                if command_exists apt-get; then printf "apt"; return; fi
+                ;;
+            *fedora*|*rhel*|*centos*|*rocky*|*alma*)
+                if command_exists dnf; then printf "dnf"; return; fi
+                ;;
+            *opensuse*|*suse*|*sles*)
+                if command_exists zypper; then printf "zypper"; return; fi
+                ;;
+            *gentoo*)
+                if command_exists emerge; then printf "emerge"; return; fi
+                ;;
+        esac
+
+        if command_exists apt-get; then printf "apt"; return; fi
+        if command_exists dnf; then printf "dnf"; return; fi
+        if command_exists pacman; then printf "pacman"; return; fi
+        if command_exists zypper; then printf "zypper"; return; fi
+        if command_exists emerge; then printf "emerge"; return; fi
+        if command_exists snap; then printf "snap"; return; fi
+        if command_exists flatpak; then printf "flatpak"; return; fi
+        if command_exists npm; then printf "npm"; return; fi
+        if command_exists bun; then printf "bun"; return; fi
+    fi
+
+    if command_exists brew; then printf "brew"; return; fi
+    if command_exists npm; then printf "npm"; return; fi
+    if command_exists bun; then printf "bun"; return; fi
+
+    die "Unable to auto-detect a supported package manager. Use --manager."
+}
+
+build_help_file() {
+    local default_manager="$1"
+
+    cat >"${HELP_FILE}" <<EOF
+${SCRIPT_NAME} - ultimate fuzzy package finder
+
+Syntax:
+  ${SCRIPT_NAME} [manager option] [action option] [query]
+  ${SCRIPT_NAME} -m|--manager <name> [action option] [query]
+
+Default behavior:
+  Fuzzy-search available packages and install selected items.
+
+Detected default manager:
+  $(manager_label "${default_manager}") (${default_manager})
+
+Action options:
+  -l, --list-installed   Fuzzy-search installed packages and show details
+  -R, --remove           Fuzzy-search installed packages and remove selected
+  -U, --update           Run manager update/upgrade flow
+  -h, --help             Show this help
+
+Manager options (one or two-letter style):
+  -ap, --apt             Use APT
+  -dn, --dnf             Use DNF
+  -pm, --pacman          Use Pacman
+  -zy, --zypper          Use Zypper
+  -em, --emerge          Use Portage (emerge)
+  -br, --brew            Use Homebrew
+  -sn, --snap            Use Snap
+  -fp, --flatpak         Use Flatpak
+  -np, --npm             Use npm (global packages)
+  -bn, --bun             Use bun (global packages)
+  -ad, --auto            Force auto-detection mode
+
+Examples:
+  ${SCRIPT_NAME} docker
+  ${SCRIPT_NAME} -dn nginx
+  ${SCRIPT_NAME} -ap -l openssl
+  ${SCRIPT_NAME} -br -R wget
+  ${SCRIPT_NAME} -sn firefox
+  ${SCRIPT_NAME} -fp org.gimp.GIMP
+  ${SCRIPT_NAME} -np eslint
+  ${SCRIPT_NAME} -m apt ripgrep
+
+Supported managers:
+  $(manager_list)
+EOF
+}
+
+build_keybind_file() {
+    cat >"${KBINDS_FILE}" <<'EOF'
+Keybinds:
+
+  ctrl-h  Show help in preview pane
+  ctrl-k  Show keybinds in preview pane
+  ctrl-/  Toggle preview pane
+  ctrl-n  Move to next selected package
+  ctrl-b  Move to previous selected package
+EOF
+}
+
+print_help() {
+    cat "${HELP_FILE}"
+}
+
+parse_args() {
+    while (($#)); do
+        case "$1" in
+            -h|--help)
+                ACTION="help"
+                ;;
+            -l|--list-installed)
+                ACTION="list"
+                ;;
+            -R|--remove)
+                ACTION="remove"
+                ;;
+            -U|--update)
+                ACTION="update"
+                ;;
+            -ap|--apt)
+                MANAGER_OVERRIDE="apt"
+                ;;
+            -dn|--dnf)
+                MANAGER_OVERRIDE="dnf"
+                ;;
+            -pm|--pacman)
+                MANAGER_OVERRIDE="pacman"
+                ;;
+            -zy|--zypper)
+                MANAGER_OVERRIDE="zypper"
+                ;;
+            -em|--emerge)
+                MANAGER_OVERRIDE="emerge"
+                ;;
+            -br|--brew)
+                MANAGER_OVERRIDE="brew"
+                ;;
+            -sn|--snap)
+                MANAGER_OVERRIDE="snap"
+                ;;
+            -fp|--flatpak)
+                MANAGER_OVERRIDE="flatpak"
+                ;;
+            -np|--npm)
+                MANAGER_OVERRIDE="npm"
+                ;;
+            -bn|--bun)
+                MANAGER_OVERRIDE="bun"
+                ;;
+            -ad|--auto)
+                MANAGER_OVERRIDE=""
+                ;;
+            -m|--manager)
+                shift
+                [[ $# -gt 0 ]] || die "Missing value for --manager"
+                MANAGER_OVERRIDE="$(normalize_manager "$1")"
+                ;;
+            --)
+                shift
+                while (($#)); do
+                    QUERY_PARTS+=("$1")
+                    shift
+                done
+                break
+                ;;
+            -*)
+                die "Invalid option: $1"
+                ;;
+            *)
+                QUERY_PARTS+=("$1")
+                ;;
+        esac
+        shift
+    done
+}
+
+join_query() {
+    local query=""
+    local part
+
+    if (( ${#QUERY_PARTS[@]} == 0 )); then
+        printf ""
+        return
+    fi
+
+    for part in "${QUERY_PARTS[@]}"; do
+        if [[ -z "${query}" ]]; then
+            query="${part}"
+        else
+            query+=" ${part}"
+        fi
+    done
+    printf "%s" "${query}"
+}
+
+manager_search_entries() {
+    local manager="$1"
+    local query="$2"
+    local effective_query="${query}"
+
+    if [[ -z "${effective_query}" ]]; then
+        case "${manager}" in
+            apt|dnf|pacman|zypper|emerge|snap|flatpak|npm|bun)
+                effective_query="a"
+                ;;
+            brew)
+                effective_query=""
+                ;;
+        esac
+    fi
+
+    case "${manager}" in
+        apt)
+            apt-cache search -- "${effective_query}" 2>/dev/null |
+                awk -F' - ' '{ name=$1; desc=$2; gsub(/^[[:space:]]+|[[:space:]]+$/, "", name); if (desc == "") desc="-"; print name "\t" desc }'
+            ;;
+        dnf)
+            local pattern="*"
+            if [[ -n "${effective_query}" ]]; then
+                pattern="*${effective_query}*"
+            fi
+            dnf -q list available "${pattern}" 2>/dev/null |
+                awk 'NR > 1 && $1 !~ /^(Available|Last|Installed)/ { name=$1; sub(/\.[^.]+$/, "", name); print name "\t" $2 }'
+            ;;
+        pacman)
+            pacman -Ss -- "${effective_query}" 2>/dev/null |
+                awk '
+                    NR % 2 == 1 {
+                        split($1, parts, "/")
+                        pkg = parts[2]
+                        next
+                    }
+                    NR % 2 == 0 {
+                        line = $0
+                        sub(/^[[:space:]]+/, "", line)
+                        if (pkg != "") print pkg "\t" line
+                    }
+                '
+            ;;
+        zypper)
+            zypper --non-interactive --quiet search --details --type package "${effective_query}" 2>/dev/null |
+                awk -F'|' '
+                    /^[[:space:]]*[ivp ][[:space:]]*\|/ {
+                        name=$3
+                        ver=$5
+                        repo=$7
+                        gsub(/^[[:space:]]+|[[:space:]]+$/, "", name)
+                        gsub(/^[[:space:]]+|[[:space:]]+$/, "", ver)
+                        gsub(/^[[:space:]]+|[[:space:]]+$/, "", repo)
+                        if (name != "") print name "\tversion " ver " from " repo
+                    }
+                '
+            ;;
+        emerge)
+            emerge --searchdesc --color=n "${effective_query}" 2>/dev/null |
+                awk '
+                    /^\*  / {
+                        atom=$2
+                        desc="-"
+                        next
+                    }
+                    /^[[:space:]]+Description:/ {
+                        line=$0
+                        sub(/^[[:space:]]+Description:[[:space:]]*/, "", line)
+                        desc=line
+                        if (atom != "") print atom "\t" desc
+                        atom=""
+                    }
+                '
+            ;;
+        brew)
+            brew search "${effective_query}" 2>/dev/null |
+                awk 'NF > 0 { print $1 "\t-" }'
+            ;;
+        snap)
+            snap find "${effective_query}" 2>/dev/null |
+                awk '
+                    NR == 1 { next }
+                    NF > 0 {
+                        name=$1
+                        $1=""
+                        sub(/^[[:space:]]+/, "", $0)
+                        if ($0 == "") $0 = "-"
+                        print name "\t" $0
+                    }
+                '
+            ;;
+        flatpak)
+            if [[ -z "${effective_query}" ]]; then
+                {
+                    flatpak remote-ls --app --columns=application,description flathub 2>/dev/null ||
+                    flatpak remote-ls --app --columns=application,description 2>/dev/null
+                } |
+                    awk 'NR > 1 { name=$1; $1=""; sub(/^[[:space:]]+/, "", $0); if ($0 == "") $0="-"; print name "\t" $0 }'
+            else
+                {
+                    flatpak search --columns=application,description "${effective_query}" 2>/dev/null ||
+                    flatpak search "${effective_query}" 2>/dev/null
+                } |
+                    awk 'NR > 1 { name=$1; $1=""; sub(/^[[:space:]]+/, "", $0); if ($0 == "") $0="-"; print name "\t" $0 }'
+            fi
+            ;;
+        npm)
+            npm search "${effective_query}" --searchlimit=500 --parseable 2>/dev/null |
+                awk -F'\t' 'NF >= 2 { print $1 "\t" $2 }'
+            ;;
+        bun)
+            {
+                if bun search "${effective_query}" >/dev/null 2>&1; then
+                    bun search "${effective_query}" 2>/dev/null |
+                        awk 'NR > 1 && NF > 0 { name=$1; $1=""; sub(/^[[:space:]]+/, "", $0); if ($0 == "") $0="-"; print name "\t" $0 }'
+                fi
+                if command_exists npm; then
+                    npm search "${effective_query}" --searchlimit=500 --parseable 2>/dev/null |
+                        awk -F'\t' 'NF >= 2 { print $1 "\t" $2 }'
+                fi
+            } || true
+            ;;
+    esac | awk -F'\t' 'NF >= 1 { if ($2 == "") $2 = "-"; print $1 "\t" $2 }' | sort -u || true
+}
+
+manager_installed_entries() {
+    local manager="$1"
+
+    case "${manager}" in
+        apt)
+            dpkg-query -W -f='${binary:Package}\t${Version}\n' 2>/dev/null
+            ;;
+        dnf)
+            dnf -q list installed 2>/dev/null |
+                awk 'NR > 1 && $1 !~ /^(Installed|Last)/ { name=$1; sub(/\.[^.]+$/, "", name); print name "\t" $2 }'
+            ;;
+        pacman)
+            pacman -Q 2>/dev/null |
+                awk '{ print $1 "\t" $2 }'
+            ;;
+        zypper)
+            zypper --non-interactive --quiet search --installed-only --details --type package 2>/dev/null |
+                awk -F'|' '
+                    /^[[:space:]]*i[[:space:]]*\|/ {
+                        name=$3
+                        ver=$5
+                        gsub(/^[[:space:]]+|[[:space:]]+$/, "", name)
+                        gsub(/^[[:space:]]+|[[:space:]]+$/, "", ver)
+                        if (name != "") print name "\t" ver
+                    }
+                '
+            ;;
+        emerge)
+            if command_exists qlist; then
+                qlist -ICv 2>/dev/null |
+                    awk '{ print $1 "\tinstalled" }'
+            else
+                local pkg_dir
+                for pkg_dir in /var/db/pkg/*/*; do
+                    [[ -d "${pkg_dir}" ]] || continue
+                    printf "%s\tinstalled\n" "$(basename "${pkg_dir}")"
+                done
+            fi
+            ;;
+        brew)
+            brew list --versions 2>/dev/null |
+                awk '{ name=$1; $1=""; sub(/^[[:space:]]+/, "", $0); if ($0 == "") $0="installed"; print name "\t" $0 }'
+            ;;
+        snap)
+            snap list 2>/dev/null |
+                awk 'NR > 1 { print $1 "\t" $2 }'
+            ;;
+        flatpak)
+            flatpak list --app --columns=application,version 2>/dev/null |
+                awk 'NR > 1 { print $1 "\t" $2 }'
+            ;;
+        npm)
+            npm ls -g --depth=0 --parseable 2>/dev/null |
+                awk -F'/' 'NR > 1 { print $NF "\tglobal" }'
+            ;;
+        bun)
+            {
+                if bun pm ls --global >/dev/null 2>&1; then
+                    bun pm ls --global 2>/dev/null |
+                        awk 'NR > 1 && NF > 0 { print $1 "\tglobal" }'
+                elif bun pm ls >/dev/null 2>&1; then
+                    bun pm ls 2>/dev/null |
+                        awk 'NR > 1 && NF > 0 { print $1 "\tglobal" }'
+                fi
+                if command_exists npm; then
+                    npm ls -g --depth=0 --parseable 2>/dev/null |
+                        awk -F'/' 'NR > 1 { print $NF "\tglobal" }'
+                fi
+            } || true
+            ;;
+    esac | sort -u || true
+}
+
+manager_installed_names() {
+    local manager="$1"
+    manager_installed_entries "${manager}" | awk -F'\t' 'NF > 0 { print $1 }'
+}
+
+mark_installed_packages() {
+    local manager="$1"
+    local source_file="$2"
+    local output_file="$3"
+    local installed_file
+
+    installed_file="$(mktemp "${TMP_ROOT}/installed.XXXXXX")"
+    manager_installed_names "${manager}" >"${installed_file}" 2>/dev/null || true
+
+    awk -F'\t' '
+        FILENAME == ARGV[1] {
+            if ($1 != "") {
+                installed[$1] = 1
+            }
+            next
+        }
+        {
+            mark = (installed[$1] ? "* " : "  ")
+            desc = $2
+            if (desc == "") desc = "-"
+            print $1 "\t" mark desc
+        }
+    ' "${installed_file}" "${source_file}" >"${output_file}"
+
+    rm -f "${installed_file}"
+}
+
+manager_preview_command() {
+    local manager="$1"
+
+    case "${manager}" in
+        apt)
+            printf '%s' 'pkg={1}; apt-cache show "$pkg" 2>/dev/null; printf "\n"; dpkg -L "$pkg" 2>/dev/null'
+            ;;
+        dnf)
+            printf '%s' 'pkg={1}; dnf info "$pkg" 2>/dev/null; printf "\n"; rpm -ql "$pkg" 2>/dev/null'
+            ;;
+        pacman)
+            printf '%s' 'pkg={1}; pacman -Si "$pkg" 2>/dev/null; printf "\n"; pacman -Fl "$pkg" 2>/dev/null | awk "{print \$2}"'
+            ;;
+        zypper)
+            printf '%s' 'pkg={1}; zypper --non-interactive info "$pkg" 2>/dev/null'
+            ;;
+        emerge)
+            printf '%s' 'pkg={1}; emerge --search --color=n "$pkg" 2>/dev/null'
+            ;;
+        brew)
+            printf '%s' 'pkg={1}; brew info "$pkg" 2>/dev/null'
+            ;;
+        snap)
+            printf '%s' 'pkg={1}; snap info "$pkg" 2>/dev/null'
+            ;;
+        flatpak)
+            printf '%s' 'pkg={1}; flatpak info "$pkg" 2>/dev/null || flatpak remote-info flathub "$pkg" 2>/dev/null'
+            ;;
+        npm)
+            printf '%s' 'pkg={1}; npm view "$pkg" 2>/dev/null'
+            ;;
+        bun)
+            printf '%s' 'pkg={1}; bun info "$pkg" 2>/dev/null || npm view "$pkg" 2>/dev/null'
+            ;;
+    esac
+}
+
+manager_install() {
+    local manager="$1"
+    shift
+
+    case "${manager}" in
+        apt)
+            run_as_root apt-get install -y "$@"
+            ;;
+        dnf)
+            run_as_root dnf install -y "$@"
+            ;;
+        pacman)
+            run_as_root pacman -S --needed "$@"
+            ;;
+        zypper)
+            run_as_root zypper --non-interactive install --auto-agree-with-licenses "$@"
+            ;;
+        emerge)
+            run_as_root emerge --ask=n --verbose "$@"
+            ;;
+        brew)
+            brew install "$@"
+            ;;
+        snap)
+            local pkg
+            for pkg in "$@"; do
+                run_as_root snap install "${pkg}" 2>/dev/null || run_as_root snap install --classic "${pkg}"
+            done
+            ;;
+        flatpak)
+            local pkg
+            for pkg in "$@"; do
+                flatpak install -y --user flathub "${pkg}" 2>/dev/null || flatpak install -y --user "${pkg}"
+            done
+            ;;
+        npm)
+            npm install -g "$@"
+            ;;
+        bun)
+            bun add -g "$@"
+            ;;
+    esac
+}
+
+manager_remove() {
+    local manager="$1"
+    shift
+
+    case "${manager}" in
+        apt)
+            run_as_root apt-get remove -y "$@"
+            ;;
+        dnf)
+            run_as_root dnf remove -y "$@"
+            ;;
+        pacman)
+            run_as_root pacman -Rsn "$@"
+            ;;
+        zypper)
+            run_as_root zypper --non-interactive remove "$@"
+            ;;
+        emerge)
+            run_as_root emerge --ask=n --deselect "$@"
+            run_as_root emerge --ask=n --depclean "$@"
+            ;;
+        brew)
+            brew uninstall "$@"
+            ;;
+        snap)
+            run_as_root snap remove "$@"
+            ;;
+        flatpak)
+            flatpak uninstall -y --user "$@"
+            ;;
+        npm)
+            npm uninstall -g "$@"
+            ;;
+        bun)
+            bun remove --global "$@" 2>/dev/null || bun remove "$@"
+            ;;
+    esac
+}
+
+manager_show_info() {
+    local manager="$1"
+    local package="$2"
+
+    case "${manager}" in
+        apt)
+            cat <(apt-cache show "${package}" 2>/dev/null) <(printf "\n") <(dpkg -L "${package}" 2>/dev/null)
+            ;;
+        dnf)
+            cat <(dnf info "${package}" 2>/dev/null) <(printf "\n") <(rpm -ql "${package}" 2>/dev/null)
+            ;;
+        pacman)
+            cat <(pacman -Qi "${package}" 2>/dev/null || pacman -Si "${package}" 2>/dev/null) <(printf "\n") <(pacman -Ql "${package}" 2>/dev/null)
+            ;;
+        zypper)
+            zypper --non-interactive info "${package}" 2>/dev/null
+            ;;
+        emerge)
+            emerge --search --color=n "${package}" 2>/dev/null
+            ;;
+        brew)
+            brew info "${package}" 2>/dev/null
+            ;;
+        snap)
+            snap info "${package}" 2>/dev/null
+            ;;
+        flatpak)
+            flatpak info "${package}" 2>/dev/null || flatpak remote-info flathub "${package}" 2>/dev/null
+            ;;
+        npm)
+            npm view "${package}" 2>/dev/null
+            ;;
+        bun)
+            bun info "${package}" 2>/dev/null || npm view "${package}" 2>/dev/null
+            ;;
+    esac
+}
+
+manager_update() {
+    local manager="$1"
+
+    case "${manager}" in
+        apt)
+            run_as_root apt-get update
+            run_as_root apt-get upgrade -y
+            ;;
+        dnf)
+            run_as_root dnf upgrade -y
+            ;;
+        pacman)
+            run_as_root pacman -Syu
+            ;;
+        zypper)
+            run_as_root zypper --non-interactive refresh
+            run_as_root zypper --non-interactive update
+            ;;
+        emerge)
+            run_as_root emerge --sync
+            run_as_root emerge --ask=n --update --deep --newuse @world
+            ;;
+        brew)
+            brew update
+            brew upgrade
+            ;;
+        snap)
+            run_as_root snap refresh
+            ;;
+        flatpak)
+            flatpak update -y --user
+            ;;
+        npm)
+            npm update -g
+            ;;
+        bun)
+            bun update --global 2>/dev/null || bun update
+            ;;
+    esac
+}
+
+confirm_action() {
+    local prompt="$1"
+    local reply=""
+
+    printf "%s [y/N]: " "${prompt}" >&2
+    read -r reply || true
+
+    case "${reply}" in
+        y|Y|yes|YES)
+            return 0
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+run_fuzzy_selector() {
+    local manager="$1"
+    local query="$2"
+    local input_file="$3"
+    local header_line="$4"
+    local preview_cmd
+
+    preview_cmd="$(manager_preview_command "${manager}")"
+
+    fzf -q "${query}" -e -m \
+        --delimiter=$'\t' \
+        --with-nth=1,2 \
+        --preview="${preview_cmd}" \
+        --preview-window=55%:wrap:border-sharp \
+        --layout=reverse \
+        --marker='>>' \
+        --header="${header_line}" \
+        --info=hidden \
+        --margin="2%,1%,2%,1%" \
+        --cycle \
+        --bind=ctrl-k:preview:"cat ${KBINDS_FILE}" \
+        --bind=ctrl-h:preview:"cat ${HELP_FILE}" \
+        --bind='ctrl-/:change-preview-window(hidden|)' \
+        --bind=ctrl-n:next-selected,ctrl-b:prev-selected \
+        --bind='focus:transform-preview-label:echo package: {1}' \
+        <"${input_file}"
+}
+
+collect_selected_packages() {
+    local selected_lines="$1"
+    printf "%s\n" "${selected_lines}" | awk -F'\t' 'NF > 0 { print $1 }'
+}
+
+main() {
+    ensure_tmp_root
+
+    parse_args "$@"
+
+    local detected_manager
+    detected_manager="$(detect_default_manager)"
+
+    build_help_file "${detected_manager}"
+    build_keybind_file
+
+    if [[ "${ACTION}" == "help" ]]; then
+        print_help
+        exit 0
+    fi
+
+    local manager="${detected_manager}"
+    if [[ -n "${MANAGER_OVERRIDE}" ]]; then
+        manager="$(normalize_manager "${MANAGER_OVERRIDE}")"
+    fi
+
+    manager_supported "${manager}" || die "Unsupported manager: ${manager}"
+    manager_command_ready "${manager}" || die "Manager command(s) for '${manager}' not found on this system"
+
+    local query
+    query="$(join_query)"
+
+    if [[ "${ACTION}" == "update" ]]; then
+        log "Using manager: $(manager_label "${manager}")"
+        if confirm_action "Run update/upgrade for ${manager}?"; then
+            manager_update "${manager}"
+        else
+            log "Update canceled"
+        fi
+        exit 0
+    fi
+
+    command_exists fzf || die "fzf is required"
+
+    local source_file
+    local display_file
+    source_file="$(mktemp "${TMP_ROOT}/source.XXXXXX")"
+    display_file="$(mktemp "${TMP_ROOT}/display.XXXXXX")"
+
+    if [[ "${ACTION}" == "list" || "${ACTION}" == "remove" ]]; then
+        manager_installed_entries "${manager}" >"${source_file}"
+        cp "${source_file}" "${display_file}"
+    else
+        manager_search_entries "${manager}" "${query}" >"${source_file}"
+        mark_installed_packages "${manager}" "${source_file}" "${display_file}"
+    fi
+
+    if [[ ! -s "${display_file}" ]]; then
+        rm -f "${source_file}" "${display_file}"
+        die "No packages found for manager '${manager}' and query '${query}'"
+    fi
+
+    local header
+    case "${ACTION}" in
+        search)
+            header="Select package(s) to install with ${manager} (TAB to multi-select)"
+            ;;
+        list)
+            header="Select installed package(s) to inspect"
+            ;;
+        remove)
+            header="Select installed package(s) to remove"
+            ;;
+        *)
+            header="Select package(s)"
+            ;;
+    esac
+
+    local selected
+    selected="$(run_fuzzy_selector "${manager}" "${query}" "${display_file}" "${header}" || true)"
+
+    rm -f "${source_file}" "${display_file}"
+
+    if [[ -z "${selected}" ]]; then
+        log "No package selected"
+        exit 0
+    fi
+
+    local packages=()
+    local selected_pkg
+    while IFS= read -r selected_pkg; do
+        [[ -n "${selected_pkg}" ]] || continue
+        packages+=("${selected_pkg}")
+    done < <(collect_selected_packages "${selected}")
+
+    if [[ "${#packages[@]}" -eq 0 ]]; then
+        log "No package selected"
+        exit 0
+    fi
+
+    case "${ACTION}" in
+        search)
+            if confirm_action "Install ${#packages[@]} package(s) with ${manager}?"; then
+                manager_install "${manager}" "${packages[@]}"
+            else
+                log "Install canceled"
+            fi
+            ;;
+        remove)
+            if confirm_action "Remove ${#packages[@]} package(s) with ${manager}?"; then
+                manager_remove "${manager}" "${packages[@]}"
+            else
+                log "Remove canceled"
+            fi
+            ;;
+        list)
+            local pkg
+            for pkg in "${packages[@]}"; do
+                printf "\n=== %s (%s) ===\n" "${pkg}" "$(manager_label "${manager}")"
+                manager_show_info "${manager}" "${pkg}" || true
+            done
+            ;;
+    esac
+}
+
+main "$@"