Skip to content

🧹 Bleach is a safe, terminal-based system maintenance tool designed for developers who want a fast, clean, and distraction-free Linux environment.

License

Notifications You must be signed in to change notification settings

maruf-pfc/bleach

Bleach (Go Version)

A lightning-fast, terminal-based system cleaner and dashboard for Linux, rewritten in Go using the Bubble Tea framework.

License Go

Features

  • Unified Dashboard: Real-time "Command Center" view with live CPU, RAM, and Disk usage bars.
  • System Operations:
    • Cleanup: One-click apt clean, autoremove, and log rotation.
    • Updates: streamlining apt update && upgrade.
    • Maintenance: Automated system maintenance tasks.
  • Responsive TUI: Adapts layout automatically (Side-by-side or Stacked) based on terminal window size.
  • Safe & Transparent: Executes standard Linux commands (sudo apt ...) and streams output directly to you.

🚀 Installation

One-Line Installer (Recommended)

This script will install Go (if missing), clone the repo, and build the binary for you.

curl -sL https://raw.githubusercontent.com/maruf-pfc/bleach/main/install.sh | sudo bash

From Source (Manual)

If you prefer to control the build process:

  1. Clone the repository:
    git clone https://github.com/maruf-pfc/bleach.git
    cd bleach
  2. Build:
    go build ./cmd/bleach

🎮 Usage

Launch Bleach from your terminal:

./bleach

Interface

  • Dashboard (Top): Shows your System Info (Hostname, Kernel) and Live Resource Usage.
  • Menu (Bottom Left): Navigate using partially Up / Down arrows.
  • Output (Bottom Right): Displays real-time logs of actions performed.

Controls

Key Action
↑ / ↓ / k / j Navigate Menu
Enter Select Action
q / Ctrl+C Quit

🛠 Tech Stack

License

MIT License. Use at your own risk.

About

🧹 Bleach is a safe, terminal-based system maintenance tool designed for developers who want a fast, clean, and distraction-free Linux environment.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •