Packages

Surface

fur install <target> [--from nixpkgs|appimage|deb|flatpak|kit] [--system]
fur remove   <name>   [--system] [--purge]
fur uninstall <name>  [--system] [--purge]
fur search   <query>  [--nixpkgs] [--kits]
fur info     <name>
fur list     [--system|--all]
fur update
fur upgrade  [name]
fur gc

install

Resolves <target> against available sources in order. Use --from to pin the backend, and --system to install at system scope (writes the managed Nix module — see runbooks).

fur install hello
fur install firefox --from flatpak
fur install ./google-chrome.deb --from deb
fur install @foxora/dev-tools --from kit
sudo fur install --system curl

remove / uninstall

Removes the package using the same backend that installed it. Use --purge to drop config too. uninstall is an alias of remove for habit compatibility.

fur remove hello
fur remove firefox --purge
sudo fur remove --system curl

search

Searches across enabled sources. Narrow with --nixpkgs or --kits; default is all sources merged.

fur search ripgrep
fur search dev --kits --json

info

Prints record details for <name> — source, strategy, install time, pin, and (for kits) provenance + attestation.

fur info hello
fur info @foxora/dev-tools --json

list

Lists user-scope apps by default. Pass --system for the system-managed set, --all for both.

fur list
fur list --system
fur list --all --json | jq '.apps[].source' | sort | uniq -c

update / upgrade / gc

• update — refresh source indexes (no install).
• upgrade [name] — upgrade one package or every applicable package.
• gc — garbage-collect orphaned store paths and stale generations.

fur update
fur upgrade
fur upgrade firefox
fur gc --json