SYSUP — System Update Orchestrator

SYSUP is a modular, extensible, and human‑friendly system maintenance tool for Debian‑based Linux systems.
It provides a clean command‑line interface, a lightweight interactive REPL, animated spinners, logging, verbose mode, and a structured module architecture inspired by cockpit‑style tooling.

SYSUP v1.5 introduces:

• A full logging subsystem (/var/log/sysup/sysup.log)
• Verbose mode (-v, --verbose, or verbose on)
• A system information panel
• Improved task orchestration and REPL commands

---

[00] Features

• Modular architecture — each subsystem lives in its own module.
• Interactive REPL — a cockpit‑style shell for maintenance tasks.
• Animated spinners — clean, readable progress indicators.
• Logging subsystem — timestamped logs for every operation.
• Verbose mode — show full apt output when needed.
• System info panel — OS, kernel, uptime, package stats, pending updates.
• Consistent UX — unified colors, formatting, and messaging.

---

[01] Installation

Clone the repository:

git clone https://github.com/DalIquor/sysup.git
cd sysup

Make the launcher executable:

chmod +x sysup

(Optional) Install globally:

sudo ln -s "$(pwd)/sysup" /usr/local/bin/sysup

[02] Usage

Run SYSUP directly:

./sysup

Or, if installed globally:

sysup

[03] Commands

CLI Commands

Command Description sysup update Update package lists sysup upgrade Upgrade installed packages sysup clean Remove unused packages sysup full Full maintenance run (with system info panel) sysup info Show system information panel sysup repl Start interactive SYSUP shell sysup help Show help menu

[04] Verbose Mode

Verbose mode shows full apt output instead of hiding it.

CLI:

sysup update --verbose
sysup full -v

REPL: SYSUP> verbose on SYSUP> verbose off SYSUP> verbose

[05] Logging

SYSUP logs all operations to:

/var/log/sysup/sysup.log

Each entry includes:

• Timestamp

• Task name

• Success or failure

Full command output (even when verbose mode is off)

Logging is initialized automatically at startup.

[06] System Info Panel

SYSUP can display system details:

• OS version

• Kernel version

• Uptime

• Installed package count

• Pending updates

Show it manually:

sysup info

Or automatically during:

sysup full

[07] Architecture Summary

SYSUP is composed of modular shell scripts:

sysup/
├── sysup
└── modules/
    ├── sysup_banner.sh
    ├── sysup_colors.sh
    ├── sysup_spinner.sh
    ├── sysup_tasks.sh
    ├── sysup_repl.sh
    ├── sysup_help.sh
    ├── sysup_utils.sh
    ├── sysup_log.sh
    └── sysup_info.sh

Each module has a single responsibility and can be extended independently.

[08] Requirements

Debian‑based Linux distribution

• bash

• sudo

• apt

• dpkg

• lsb_release (optional but recommended)

[09] License

MIT License.

[10] Contributing

See CONTRIBUTING.md for guidelines.

[11] Changelog

See CHANGELOG.md for version history.

Author

SAL