v4.1.0Home

Flatpak control plane

Dedicated Flatpak command plane with typed errors, a default-remote convention, and per-remote install.

Surface

bash
fur flatpak install <ref> [--remote <name>]
fur flatpak remove  <ref>
fur flatpak search  <query> [--remote <name>]
fur flatpak list
fur flatpak info    <name>
fur flatpak remote list
fur flatpak remote add    <name> <url> [--user] [--no-gpg-verify]
fur flatpak remote remove <name> [--user]
fur flatpak remote set-default <name>

Default remote

--remote is optional. When omitted, fur uses (in order):

  1. The FOXORA_FLATPAK_REMOTE environment variable.
  2. The persisted default remote in your user config.
  3. The first remote that has the requested ref.
bash
fur flatpak remote set-default flathub
fur flatpak install org.mozilla.firefox --json

Typed errors

Errors are classified into actionable categories so automation can branch on them: not-found, permission, already-installed, remote-unreachable.

bash
fur flatpak install org.mozilla.firefox --remote flathub --json \
  | jq -e '.action == "flatpak-install" and .ok == true'

Remediation runbook

See the Flatpak remediation runbook for the standard remote-list / set-default / retry flow.