Skip to content
@tui-tools

tui-tools

Terminal tools for Linux servers, in the visual style of Omarchy (Go, Bubble Tea)

tui-tools

Terminal tools for Linux that show you the system as it is, and preview the exact command line of every change before running it.

Each one is a single static binary. No daemon, no state of its own, nothing left running after you quit. They share a palette, a key language and one promise: the command in the confirm dialog is the command that executes.

tui-tools.github.io — every tool, with screenshots, install commands per package manager, checksums and what each one can do to your machine. It is built from each repository's own tool.json, so a new tool appears there on its first release without anyone editing a page.

The tools

ToolWhat it does
tui-firewallThe system firewall: rules, policies, logging. ufw today, firewalld planned.CIrelease
tui-systemdsystemd units: what failed, the journal that explains why, timers, boot times.CIrelease
tui-snapperbtrfs snapshots, managed by snapper: the history, what changed between any two, and undo.CIrelease
tui-networkLinks, addresses, routes and DNS: systemd-networkd and resolved, with the .network file behind each link.CIrelease
tui-secureThe machine's security posture: Secure Boot, SELinux or AppArmor, the firewall, sshd, updates and accounts, each with the command behind its verdict.CIrelease
tui-usersLocal accounts, groups, authorized keys and sudo: who exists, what each one can do, and what is worth a second look.CIrelease
tui-updatePending package updates across pacman, apt and dnf: what they restart or reboot, what is a security fix, and a snapshot before.CIrelease
tui-diskDisks, mounts and fstab crossed against each other, btrfs filesystems in full and the SMART health of every drive.CIrelease
tui-sshThe SSH server as it really is: the effective sshd_config with a verdict per setting, live sessions, failed logins and host keys.CIrelease
tui-logsThe systemd journal: every filter a journalctl argument, the command it adds up to on screen, and vacuuming previewed before it runs.CIrelease
tui-cronEvery scheduled job on one screen, systemd timers and cron together, with each schedule read back in English next to the expression.CIrelease
tui-certEvery TLS certificate on the machine, worst first: what expires when, whose key is not its key, and what a server is really serving.CIrelease
tui-containersEvery container on one screen, docker and podman together: what is wrong first, one container in full, and its log.CIrelease
tui-sambaThe Samba file server: shares worst first with the Unix permissions behind them, the accounts, and who is connected right now.CIrelease
Also here
tui-kitThe shared foundation: theme, widgets, config loader, command runner. CI
tui-templateA working skeleton for a new tool. Press Use this template.

Try one without a machine to risk

tui-firewall --demo
tui-systemd --demo
tui-snapper --demo
tui-network --demo
tui-secure --demo
tui-users --demo
tui-update --demo
tui-disk --demo
tui-ssh --demo
tui-logs --demo
tui-cron --demo
tui-cert --demo
tui-containers --demo
tui-samba --demo

--demo runs against sample data. Every key works, every command is built and previewed for real, and nothing touches your system.

The rules

They hold for every tool here.

  • Preview, then confirm. No tool changes anything without first showing the exact command line. The confirm dialog is the only path to a mutation, and the value it displays is the value that runs.
  • Read-only by default. Starting a tool only reads state.
  • No daemon, no state of its own. The system is the source of truth; the tools re-read it after every change.
  • Runs as you. Reads work unprivileged wherever the underlying tool allows it; only an action escalates, through sudo -n, which never prompts.
  • Backend behind an interface. The UI never names a binary, which is what lets tui-firewall grow a firewalld backend without touching its screens.
  • Responsive. Layouts adapt from a 40-column pane to a full screen.

Naming

Every tool is tui-<target>: the repository, the Go module, the binary and the config directory all carry that one name, with no aliases. tui-<name>-<solution> only when a target genuinely needs disambiguating.

Theme

The default palette is Tokyo Night. If you run Omarchy, the tools read your active desktop theme from ~/.config/omarchy/current/theme/colors.toml and follow it, so switching your desktop theme switches every tool. TUI_THEME overrides, and NO_COLOR drops color while keeping layout.

Unofficial. These tools follow the Omarchy visual style and read its theme files. They are not part of the Omarchy project and are not endorsed by its maintainers.

Roadmap

The list the family set out to build is complete: every tool above exists, runs and has a --demo. What comes next is depth rather than breadth — a firewalld backend for tui-firewall, so Fedora and RHEL-family machines get the same screens ufw users have today.

Which means the next tool is whichever one somebody asks for. If there is a part of a Linux machine you keep reading through four commands and a manual page, open an issue on tui-tools/.github and say so.

Status

Early, under validation. Expect rough edges, and please report them — a bug report from a real machine, with the output the tool showed, is the most useful thing anyone can send right now.

License

MIT, per repository.

Maintainer

Created and maintained by Edimar Cardoso (@edimarlnx on X, edimarlnx on GitHub). Sponsor this work: github.com/sponsors/edimarlnx

Popular repositories Loading

  1. tui-kit tui-kitPublic

    Shared foundation for the tui-tools family: Tokyo Night theme, Bubble Tea widgets, config loader and the preview-confirm-run command runner.

    Go

  2. tui-firewall tui-firewallPublic

    ufw, firewalld and nftables, with every change previewed before it runs (Linux TUI, previews every change)

    Go

  3. tui-systemd tui-systemdPublic

    systemd units: what failed, why, and every action previewed (Linux TUI, previews every change)

    Go

  4. tui-template tui-templatePublic template

    Template for a new tui-tools tool: a working Bubble Tea skeleton with the kit, config, the preview-confirm-run runner, --demo, CI and releases.

    Go

  5. .github .githubPublic

    Organization profile and shared community health files for the tui-tools family.

  6. tui-tools.github.io tui-tools.github.ioPublic

    The tui-tools family website: a marketplace of terminal tools for Linux, built from each tool's tool.json manifest.

    Astro

Repositories

Showing 10 of 25 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…