systemd units: what failed, why, and every action previewed
A terminal UI for systemd. It opens on what failed — failed units sort first, always — and puts the journal that explains why one key away. Timers show what is scheduled and when it last fired; the boot view shows what made the last boot slow.
The unit list merges list-units --all with list-unit-files, so a unit that is installed but has never started is visible too. Every read works as an ordinary user, so the tool opens instantly and without a password; only an action escalates, and only behind a confirm dialog showing the exact systemctl command line.
Run tui-systemd --demo for a sample machine with a couple of interesting failures. Nothing touches your system.
| Key | Action |
|---|---|
| j / enter | Journal for the selected unit |
| f | In the journal: follow, re-reading every 2s |
| s / x | Start / stop the selected unit |
| r / l | Restart / reload the selected unit |
| e / D | Enable / disable the selected unit |
| m / M | Mask / unmask the selected unit |
| d | Reload the systemd manager (daemon-reload) |
| tab | Cycle the state filter: all, failed, active, inactive |
| / | Filter by name, description or state |
| t | Timers |
| b | Boot times, slowest first |
| ? | Help |
| q | Quit |
Press ? inside the tool for the full help screen, which is generated from the same action table as the key map.
This tool is a face on the program below, so its version matters.Tested is not a claim: a version lands there only after the tool's own suite passed against it on a real machine in the lab, and the run is kept as evidence in the repository. At startup the tool probes the backend once and says what it found in its header — a version nobody has run against is shown as(untested) in the warning colour, one older than the minimum as (below minimum) in the error colour. Neither stops it: the backend still refuses what it cannot do, in its own words.
systemctl230systemctl --versiontimerssince 250boot-blamesince 230systemd <250list-timers has no JSON output, so the timers view is not offered: the text table cannot be parsed without mangling its timestamps
systemd <245list-units --plain is absent on some builds, so the unit list falls back to the decorated output
Once per machine, then every tool in the family is one pacman away.
$ curl -fsSL https://pkgs.tui.tools/install.sh | shA family whose whole promise is preview before you run is not going to insist you pipe a script into a shell. These are the commands that script runs.
$ curl -fsSL -o /tmp/tui-tools.asc https://pkgs.tui.tools/pubkey.asc
sudo pacman-key --add /tmp/tui-tools.asc
sudo pacman-key --lsign-key \
"$(gpg --show-keys --with-colons /tmp/tui-tools.asc | awk -F: '/^fpr:/{print $10; exit}')"
printf '[tui-tools]\nServer = https://pkgs.tui.tools/arch/$arch\n' \
| sudo tee -a /etc/pacman.conf
sudo pacman -Sy$ sudo pacman -S tui-systemdUpgrades then arrive with the rest of your system updates.
$ paru -S tui-systemd-binThe -bin package installs the released static binary.
Once per machine, then every tool in the family is one apt away.
$ curl -fsSL https://pkgs.tui.tools/install.sh | shA family whose whole promise is preview before you run is not going to insist you pipe a script into a shell. These are the commands that script runs.
$ sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://pkgs.tui.tools/pubkey.asc \
| sudo gpg --dearmor -o /etc/apt/keyrings/tui-tools.gpg
echo "deb [signed-by=/etc/apt/keyrings/tui-tools.gpg] https://pkgs.tui.tools/deb stable main" \
| sudo tee /etc/apt/sources.list.d/tui-tools.list
sudo apt update$ sudo apt install tui-systemdUpgrades then arrive with the rest of your system updates.
Once per machine, then every tool in the family is one dnf away.
$ curl -fsSL https://pkgs.tui.tools/install.sh | shA family whose whole promise is preview before you run is not going to insist you pipe a script into a shell. These are the commands that script runs.
$ sudo rpm --import https://pkgs.tui.tools/pubkey.asc
sudo curl -fsSL -o /etc/yum.repos.d/tui-tools.repo https://pkgs.tui.tools/rpm/tui-tools.repo
sudo dnf makecache$ sudo dnf install tui-systemdUpgrades then arrive with the rest of your system updates.
Needs the tui-tools repository, a one-time setup you do once per machine.
$ sudo zypper install tui-systemdThe rpm repository is shared with dnf; zypper support is not tested yet.
$ curl -fsSL https://github.com/tui-tools/tui-systemd/releases/download/v0.1.0/tui-systemd_0.1.0_linux_amd64.tar.gz | tar -xz tui-systemd
sudo install -m0755 tui-systemd /usr/local/bin/tui-systemd$ curl -fsSL https://github.com/tui-tools/tui-systemd/releases/download/v0.1.0/tui-systemd_0.1.0_linux_arm64.tar.gz | tar -xz tui-systemd
sudo install -m0755 tui-systemd /usr/local/bin/tui-systemdOne static binary. Verify it against checksums.txt from the same release.
$ git clone https://github.com/tui-tools/tui-systemd
cd tui-systemd && make build
sudo install -m0755 bin/tui-systemd /usr/local/bin/tui-systemdNeeds Go 1.26 or newer.
Every change is shown as an exact command line and confirmed before it runs. The dialog and the runner receive the same value, so the preview cannot drift from what executes.
Only actions escalate: start, stop, restart, reload, enable, disable, mask, unmask and daemon-reload. Every read — the unit list, the journal, timers and boot times — works as an ordinary user. Escalation goes through sudo -n, which never prompts.
Nothing keeps running after you quit, and nothing is installed to run later. The system is the source of truth; the tool re-reads it after every change.
The tool opens no network connection of its own. No telemetry, no update check, no phone home.
Released statically linked, with no runtime dependencies to install.
Releases carry SHA-256 checksums but no signature. Verify the checksum, and read this as the open item it is.
Report a security issue privately, through GitHub's private vulnerability reporting on the repository's Security tab. The family-wide policy, and what counts as in scope, is on the security page.
| File | Size | SHA-256 |
|---|---|---|
| checksums.txt | 206 B | — |
| tui-systemd_0.1.0_linux_amd64.tar.gz | 1.5 MB | c498230411f645e523e558acfc3d3eeb6bd49c083d9c6a842e3fb1a2e78a0228 |
| tui-systemd_0.1.0_linux_arm64.tar.gz | 1.4 MB | a1146e20a40bc1c15c0a460e628926a8af91b8bca773bdb1cbf091094aec86bd |
Every release ships a checksums.txt. Download it next to the archive and run sha256sum -c checksums.txt --ignore-missing. See verifying a download.
## Changelog * 442fa7abb0c573356df05ae4c54e973473a7ad2f Add tui-systemd v0.1, a TUI for systemd units