Tools & Commands
Abora Commands
The abora CLI is the top-level Abora tool dispatcher. It routes subcommands to the appropriate scripts in /etc/abora/.
Quick reference
abora doctorFull system health checkabora welcomeShow first-boot welcome and quick actionsabora recoveryOpen recovery TUI menuabora support-reportGenerate diagnostics tarballabora hardware-testRun hardware readiness checksabora check-fullCollect full ANIX/TinyPM/desktop/Nix diagnosticsabora desktopView or switch the current desktop environmentabora config get/setRead or write abora-local.nix settingsabora appsInstall Flatpak app bundles from the catalogabora updateAlias for sudo nixos updateabora repair --mangoRepair flake purity issues in MangoWM configabora fallbackRoll back to a specific release tagCommand details
abora doctorFull system health check. Validates flake.nix, abora-local.nix, all scripts, bootloader theme, Plymouth, Flatpak, update channel, desktop profile, and runs anix doctor.
abora doctorabora recoveryOpens a TUI recovery menu with: rollback, support report, Flathub repair, force rebuild, ANIX doctor, Abora doctor.
abora recoveryabora support-reportCollects system info, generation list, ANIX config, desktop profile, journal logs, Flatpak remotes, and hardware summary into a tarball at /tmp/abora-report-*.tar.gz.
abora support-report
# Then attach the .tar.gz to your GitHub issueabora hardware-testChecks CPU, RAM, disk, GPU, network interface, and audio. Useful before and after installation to verify hardware is detected.
abora hardware-testabora desktopView or switch the current desktop environment. Reads from abora-local.nix and can trigger a nixos-rebuild.
abora desktop # show current desktop
abora desktop set gnome # switch to GNOMEabora configRead or write values in abora-local.nix. The user and disk keys are read-only (set by the installer and never changed at runtime).
abora config get hostname
abora config set hostname mycomputer
abora config set timezone Europe/Berlin
abora config set desktop kde
abora config set wallpaper NightTime-MNT.pngRead-only keys: user.name, user.hashedPassword, disk.
abora appsInstall Flatpak app bundles from the Abora catalog (57 apps across 7 bundles). Connects to Flathub.
abora apps # interactive bundle selector
abora apps install creator # install a specific bundleabora check-fullDeep diagnostics: ANIX state, TinyPM state, desktop profile, GPU driver, Nix logs, Flatpak, and journal. Outputs to terminal and /tmp/abora-check-full.log.
abora check-fullabora repairRepairs known config issues. Currently handles MangoWM flake purity issues where /nix/store paths leak into installed config.
abora repair --mangoabora fallbackRoll back the system to a specific Abora release tag. Downloads and applies the older release files.
abora fallback --release v3.10System update commands
Several commands alias to nixos update which runs abora-update.sh. They all accept the same subcommands.
sudo nixos updateStandard system update (recommended)sudo updateAliassudo upgradeAliasabora updateAliasnixos channel showShow current update channelnixos channel listList available channels (stable, demo, unstable)nixos channel set stableSwitch update channelsudo nixos rollbackRoll back to previous generation via updaterPackage commands
grab and tinypm are TinyPM commands. On Abora, grab prefers Nix packages, then falls back to Flatpak.
grab firefox # install via best available source
grab -f firefox # install specifically via Flatpak
search firefox # search across all package sources
term firefox # remove a package
supdate # upgrade all installed packages