helixforge 1.0.5

Build, configure and optimise a Linux machine from a terminal menu: installs, dotfiles, updates, backups and health checks, every change planned and confirmed first.
helixforge-1.0.5 is not a library.

HelixForge sets up and looks after a Linux machine from one menu in the terminal: applications, dotfiles and shell configuration, system tweaks, updates, backups and health checks. Every change is planned first, shown to you with its risk, run only after you confirm it, verified afterwards and recorded in a history. It is written in Rust and works the same way on Arch, Debian, Ubuntu, Fedora and openSUSE.

Highlights

  • A catalog of 248 entries for applications, development tools, gaming, desktop and shell configuration, maintenance and security, in searchable groups, with ready-made profiles that set up a whole workstation.
  • Knows your machine. Each entry shows whether it is installed, from where (pacman, apt, dnf, zypper, the AUR, Flatpak) and at which version, whether an update is waiting, and whether Nix or Home Manager provides it.
  • Plans before it acts. Queue what you want; the Install Plan shows the steps in order, what they need, the risk and whether they ask for your password, and checks for conflicts, missing repositories, wrong hardware and disk space before anything runs.
  • Verified runs. Installs and removals are checked against the package manager afterwards; a failing source falls back to the next (the AUR, then Flathub); every run, its output and its result are kept in History.
  • One place for updates from every package tool on the machine, delegated to those tools.
  • Helix Doctor checks the network, services, graphics drivers, package databases, permissions, boot images, GRUB, the EFI partition and disk space, with repairs that run after their own confirmation.
  • Backups and snapshots: configuration backups can be restored from one screen, and a Snapper or Timeshift snapshot is taken before system changes.
  • Scriptable: everything is also a command, with --dry-run and stable --json output.

Install

Download the package for your distribution from the latest release, then:

System Command
Arch, Garuda, CachyOS, EndeavourOS, Manjaro sudo pacman -U helixforge-*-x86_64.pkg.tar.zst
Debian, Ubuntu, Mint, Pop!_OS sudo apt install ./helixforge_*_amd64.deb
Fedora sudo dnf install ./helixforge-*.x86_64.rpm
openSUSE sudo zypper install --allow-unsigned-rpm ./helixforge-*.x86_64.rpm
Any distribution, with Rust cargo install --locked helixforge

The packages add shell completions, manual pages and a menu entry. Every release file has a SHA-256 sum and a signed build provenance attestation; INSTALL.md shows how to check them, and how to build from source.

To try it without installing anything, run the latest release straight from GitHub, as your normal user:

curl -fsSL https://raw.githubusercontent.com/Commanderx-code/Helix-Forge/main/start.sh | sh

It needs Linux on x86_64 with glibc 2.35 or newer.

Quick start

Run helixforge as your normal user; entries that need root ask for your password when they run.

Key Does
Tab / Shift-Tab, j / k Move between screens, or within a list
Enter Open a group, run an entry, or run the Install Plan
Space Add the entry to the Install Plan
/ Search every area
d / p Describe the entry / show exactly what it runs
u / U Update the entry / every entry with an update
* Pin to Favourites
t Change the theme
? Every key

From the command line:

helixforge search editor             # find entries
helixforge status                    # what is installed, updated or managed
helixforge run git ripgrep --dry-run # the plan, nothing changed
helixforge updates --online          # what every package tool has waiting
helixforge doctor                    # the health checks
helixforge report                    # what a bug report needs

Documentation
User guide The screens and the common jobs, step by step
Reference Everything the menu and the commands do, in detail
Catalog and plans How entries are written, and how a run is planned and checked
JSON output The --json shapes, for scripts and other programs
Installing Packages, Cargo, checking downloads, building from source
Stability What stays the same across 1.x
Security How HelixForge runs things safely, and how to report a vulnerability
Reporting problems Testing safely and writing a useful report
Changelog What each release brought
Roadmap What is done and what comes next

Supported systems

Every change is tested in containers of Arch, Debian, Ubuntu 22.04 and 24.04, Fedora and openSUSE Tumbleweed, with real package installs and removals and HelixForge's own packages installed and removed. Derivatives of those use the same package managers. Flatpak, the AUR (through paru or yay), Nix and Home Manager are supported where they are installed.

Contributing

Bug reports and ideas are welcome through the issue forms. To change the code or the catalog, see CONTRIBUTING.md; everyone taking part follows the code of conduct.

Licence

MIT; see LICENSE. The general catalog started as Linutil's, also MIT; see THIRD_PARTY_NOTICES.md. HelixForge replaces Commander Toolbox, now archived.