glazepkg

GlazePKG (gpk)

One command for every package manager you have.

gpk is yay for your whole machine — install, search, upgrade, and roll back across 46 package managers (plus the apps you installed by hand) with one familiar syntax. Plus a gorgeous TUI to see it all. Zero config, one binary, macOS · Linux · Windows.

---

One syntax, every manager

You already juggle brew, pip, cargo, npm, apt, pacman, the AUR — each with its own flags, its own search, its own "what's even installed?". Move to a new machine and you relearn all of it.

gpk gives you one. The pacman/yay muscle memory you already have, pointed at all 43:

gpk ffmpeg          # search every manager, pick a source, install — like yay
gpk -S ripgrep      # install (gpk finds whether it's in pacman, brew, cargo…)
gpk -Syu            # update everything, everywhere, in one go
gpk -R nodejs       # remove

Not sure which manager has it? gpk searches them all and shows you — name, version, description. Typo it? It suggests the fix. Want the dashboard instead? Just run gpk.

What you get

yay for all 46	pacman/yay short flags (-S -Ss -Si -Syu -R -Q) and plain words, across every manager
Find it anywhere	one search across all managers in parallel — versions, descriptions, "did you mean" on typos
Eye candy	themed ::/✓/✗ runs and a true-color TUI worth screenshotting
Versions, handled	pin [email protected], pick interactively, downgrade to roll back, compared across formats
AUR without a helper	searches the AUR and builds with makepkg — showing you the PKGBUILD first
Stay in control	hold packages, history + undo, autoremove orphans, clean caches
Backup & migrate	export your whole setup to JSON, import it on the next machine
The dashboard	run bare gpk for a searchable, snapshotable, diffable TUI
Scriptable	--json everywhere + stable exit codes — drop it behind a GUI or CI
Instant	scans once, caches for 10 days, opens in milliseconds

Install

Homebrew (macOS / Linux)

brew install gpk

Arch Linux (AUR)

yay -S gpk-bin

Nix (any Linux, macOS)

nix run github:neur0map/glazepkg          # try it without installing
nix profile install github:neur0map/glazepkg

Go

go install github.com/neur0map/glazepkg/cmd/gpk@latest

Pre-built binaries

Grab a binary from releases for macOS (ARM/Intel), Linux (x64/ARM), or Windows (x64/ARM).

Keeping it up to date

gpk update replaces the binary in place, and is meant for the pre-built downloads above. If a package manager installed gpk, that manager owns the file and gpk will point you at it instead of fighting it:

Installed with	Upgrade with
Homebrew	brew upgrade gpk
AUR	yay -S gpk-bin
Nix	nix profile upgrade gpk
Scoop / Chocolatey	scoop update gpk / choco upgrade gpk
a release download, go install	gpk update

It's a false alarm. The Windows build isn't signed yet, and antivirus tools often flag fresh, unsigned programs made with Go — the exact same code on macOS and Linux is fine. There's nothing harmful in it (why this happens).

Ways around it:

• Skip the download and warning entirely — install with Go:

  go install github.com/neur0map/glazepkg/cmd/gpk@latest
  

• Confirm the file is the real one. Every release ships a checksums.txt. In PowerShell:

  Get-FileHash .\gpk-windows-amd64.exe -Algorithm SHA256
  

  Check the result matches the line for that file in checksums.txt.

• Let it run. After checking the file: right-click it → Properties → tick Unblock → OK (or run Unblock-File .\gpk-windows-amd64.exe). If you get a blue "Windows protected your PC" box, click More info → Run anyway.

• On a work computer? You might not see a "Run anyway" button — that's your IT department blocking unsigned apps, and we can't change that from our side. Ask them to allow it, or use the Go install above.

git clone https://github.com/neur0map/glazepkg.git
cd glazepkg && go build ./cmd/gpk

If gpk is not found after installing via go install, add Go's bin directory to your PATH:

export PATH="$PATH:$HOME/go/bin"

Quick Start

gpk              Launch TUI
gpk update       Self-update to latest release
gpk version      Show current version
gpk --help       Show keybind reference

Just run gpk — navigate with j/k, switch managers with Tab, search with /, press s to snapshot, d to diff, e to export. Press ? for the full keybind reference.

Command line

gpk isn't only the dashboard. Every action has a typed command, and the pacman/yay short flags work too, so you can drive it from the shell without opening the TUI.

gpk firefox               # search and pick something to install (like yay)
gpk -S ffmpeg             # install
gpk -S ffmpeg --aur       # install, scoped to one manager
gpk install [email protected]  # install a specific version (or --pick-version to choose)
gpk versions black        # list installable versions, newest first
gpk -Ss ripgrep           # search every manager at once
gpk -Syu                  # update everything
gpk -R foo                # remove  (-Rns to take orphaned deps too)
gpk downgrade foo         # roll back to an earlier version
gpk -Sc                   # clear cached downloads
gpk autoremove            # remove dependencies nothing needs
gpk hold linux            # pin a package so upgrades skip it
gpk undo                  # reverse the last thing gpk did
gpk managers              # which managers are detected, with package counts
gpk theme dracula         # switch the color theme (shared with the TUI)
gpk export -o pkgs.json   # back up everything installed
gpk import pkgs.json      # restore it on another machine (skips installed)
gpk -Qi foo               # info    ·  gpk -Q lists everything installed
gpk why openssl           # what depends on it (is it safe to remove?)
gpk snapshot              # record what's installed right now
gpk snapshot diff 2 1     # what changed between two snapshots (or `diff` vs live)
gpk -Qu --notify          # check for updates and raise a desktop notification

When a package exists in more than one manager, gpk lists them with versions and lets you choose. Mistype a name and it suggests the closest match. Scope any command with --aur, --brew, -m pacman,aur, or leave it off and let gpk find it — or set a standing preference in the config so it never has to ask:

# ~/.config/glazepkg/config.toml
[install]
prefer = ["aur", "brew"]

[search]
bottom_up = true   # best match printed last, right above your prompt

[managers]
skip = ["pnpm"]    # leave these alone; see "One manager keeps failing" below

Miss yay's bottom-up search order? Pass --bottomup to search (or -Ss), or set bottom_up = true as above to make it the default — --topdown flips any single run back. Result numbers don't move: 1 is always the best match, so the interactive --install picker means the same thing in either order.

One manager keeps failing

A manager whose CLI is misconfigured fails on every run, which makes gpk upgrade exit non-zero forever even when everything else worked. Take it out of the rotation:

gpk managers skip pnpm      # or: gpk managers unskip pnpm

Skipped managers are left out of every command, still listed by gpk managers so nothing disappears quietly, and still reachable when you name one directly with --manager pnpm. The failure summary prints the exact command, so you never have to look it up.

Plain words	Short flags
gpk install foo	gpk -S foo
gpk remove foo	gpk -R foo
gpk upgrade	gpk -Syu
gpk search foo	gpk -Ss foo
gpk list	gpk -Q

Output is colored to match your theme on a terminal and falls back to plain text when piped. Run gpk --help for the full command and flag reference.

Shell completion

Tab-completes subcommands, manager names, and your installed packages (for remove, upgrade, info, downgrade, hold).

gpk completion bash > /etc/bash_completion.d/gpk      # bash
gpk completion zsh  > ~/.zfunc/_gpk                    # zsh (ensure ~/.zfunc is on $fpath)
gpk completion fish > ~/.config/fish/completions/gpk.fish

Scripting & backends

Every read command takes --json (a stable {gpk_version, schema, data} envelope), and install/remove/upgrade/downgrade accept --json to print the resolved plan — manager, version, and the exact command — without running anything. Exit codes are stable (0 ok, 1 error, 2 "no", 3 ambiguous), so gpk drops cleanly behind a GUI or script.

Snapshots on a schedule

gpk snapshot writes to the same store the TUI's s uses, so a systemd timer, launchd agent or cron entry can take periodic snapshots and you can diff any two of them later to find what changed inside a time window.

gpk snapshot --keep 30          # take one, keep only the newest 30
gpk snapshot list               # newest first, numbered
gpk snapshot diff 5 2           # compare two saved snapshots
gpk snapshot diff 5             # compare one against the system right now
gpk snapshot diff --json        # newest snapshot vs live, as JSON

Pair it with gpk outdated --notify to get a desktop notification when updates land — osascript on macOS, notify-send on Linux, a toast on Windows. gpk still runs and exits; nothing stays resident.

Key	Action
j/k, ↑/↓	Navigate
g / G	Jump to top / bottom
Ctrl+d / Ctrl+u	Half-page down / up
PgDn / PgUp	Page down / up
Tab / Shift+Tab	Cycle manager tabs
f	Cycle size filter
/	Fuzzy search
Enter	Package details
u (detail)	Upgrade package
x (detail)	Remove package
d (detail)	View dependencies
Enter (deps screen)	Open the selected dependency's details
h (detail)	Package help/usage
m (detail)	Open man page
o (detail)	Open package page in browser
e (detail)	Edit description
i	Search + install packages
m	Toggle multi-select mode
Space (multi-select)	Toggle package selection
s	Save snapshot
d	Diff against last snapshot
e	Export (JSON or text)
r	Force rescan
U	System update for the active manager tab
Q	View / cancel the operation queue
?	Help overlay
q	Quit

Upgrade (u in detail view)

Open a package with Enter, then press u. A confirmation modal shows the exact command. Privileged managers (apt, pacman, dnf, snap, apk, xbps) include a password field for sudo. The upgrade runs in the background while you keep using the TUI.

Remove (x in detail view)

Open a package with Enter, then press x. Managers that support it (apt, pacman, dnf, xbps) offer two modes: remove package only, or remove package with orphaned dependencies. If the package is required by other packages, a warning is shown before proceeding.

Search + Install (i)

Press i from the package list to open the search view. Type a query and results stream in from all installed managers in parallel. Results are deduplicated by name — expand a row to see all available sources and versions. Press i on a result to install it. Already-installed packages are marked.

Multi-Select (m)

Press m to enter selection mode. Use Space to toggle packages, navigate and search normally — selections persist across tabs and searches. Press u to upgrade all selected or x to remove all selected. The confirmation modal groups operations by privilege level so you only enter your password once.

All operations work on macOS, Linux, and Windows. Each manager maps to its correct native command automatically.

Manager	Platform	What it scans	Descriptions
brew	macOS/Linux	Installed formulae and casks	batch via JSON
pacman	Arch	Explicit native packages	pacman -Qi
AUR	Arch	Foreign/AUR packages	pacman -Qi
apt	Debian/Ubuntu	Installed packages	apt-cache show
dnf	Fedora/RHEL	Installed packages	dnf info
snap	Ubuntu/Linux	Snap packages	snap info
pip	Cross-platform	Top-level Python packages	pip show
pipx	Cross-platform	Isolated Python CLI tools	—
cargo	Cross-platform	Installed Rust binaries	—
go	Cross-platform	Go binaries in ~/go/bin	—
npm	Cross-platform	Global Node.js packages	npm info
pnpm	Cross-platform	Global pnpm packages	pnpm info
bun	Cross-platform	Global Bun packages	—
flatpak	Linux	Flatpak applications	flatpak info
MacPorts	macOS	Installed ports	port info
pkgsrc	NetBSD/cross-platform	Installed packages	pkg_info
opam	Cross-platform	OCaml packages	opam show
gem	Cross-platform	Ruby gems	gem info
pkg	FreeBSD	Installed packages	inline from scan
composer	Cross-platform	Global PHP packages	inline from JSON
mas	macOS	Mac App Store apps	—
apk	Alpine Linux	Installed packages	apk info
nix	NixOS/cross-platform	Nix profile, nix-env, and NixOS system packages	nix-env -qa
conda/mamba	Cross-platform	Conda environments	—
luarocks	Cross-platform	Lua rocks	luarocks show
XBPS	Void Linux	Installed packages	xbps-query
Portage	Gentoo	Installed ebuilds via qlist	emerge -s
Guix	GNU Guix	Installed packages	guix show
winget	Windows	Windows Package Manager	—
chocolatey	Windows	Chocolatey packages (v1 + v2)	—
scoop	Windows	Scoop packages	—
nuget	Cross-platform	NuGet global package cache	—
powershell	Cross-platform	PowerShell modules	via scan
maven	Cross-platform	Local Maven artifacts in ~/.m2/repository	—
windows-updates	Windows	Pending Windows system updates	—
am	Linux	AppImage apps via AM/AppMan	inline from scan
gvm	Cross-platform	Go toolchains installed via gvm	—
mise	Cross-platform	Tools managed by mise	—
quicklisp	Cross-platform	Common Lisp libraries via Quicklisp	—
softwareupdate	macOS	Pending macOS system updates	inline from scan
local	Linux	Apps installed outside any package manager — desktop entries (Zed, Discord, Termius…) and standalone binaries (Claude Code, omp…)	from .desktop / path
aqua	Cross-platform	CLI tools declared in aqua.yaml and the global aqua config	—
bin	Cross-platform	Pre-compiled binaries installed by bin from GitHub/GitLab/http	—
dotnet-tool	Cross-platform	.NET global tools (dotnet tool install -g)	—

• Managers that aren't installed are silently skipped — no errors, no config needed.
• Descriptions are fetched in the background and cached for 24 hours.
• Packages with available updates show a ↑ indicator next to their version (checked every 7 days).
• Press d in the detail view to see full dependency tree for any package.
• Press h in the detail view to see the package's --help output.
• Press e in the detail view to add custom descriptions — these persist across sessions and won't be overwritten.

GlazePKG can track how your system changes over time:

1. Snapshot (s) — saves every package name, version, and source to a timestamped JSON file
2. Diff (d) — compares your current packages against the last snapshot, showing:
   • Added packages (new installs)
   • Removed packages (uninstalls)
   • Upgraded packages (version changes)

Use this to audit what changed after a brew upgrade, track drift across machines, or catch unexpected installs.

All data lives under ~/.local/share/glazepkg/ (respects XDG_DATA_HOME):

Data	Path	Retention
Scan cache	cache/scan.json	10 days (auto-refresh)
Description cache	cache/descriptions.json	24 hours
Update cache	cache/updates.json	7 days
User notes	notes.json	Permanent
Snapshots	snapshots/*.json	Permanent
Exports	exports/*.json or *.txt	Permanent

Contributing

Want to add a package manager or fix a bug? Check out CONTRIBUTING.md. Each manager is a single Go file — easy to add.

Built With

• Bubble Tea — TUI framework
• Lip Gloss — terminal styling
• Bubbles — TUI components
• Fuzzy — fuzzy matching

Star History

License

GPL-3.0