kepfi

README

kepfi

I got tired of losing files to rm, so I built kepfi with zero dependencies.

A smart alternative to rm with a recovery bin and storage tracking.

🚀 Features & Usage

Usage: kepfi [OPTION]

Options:
  -l,  --list                   Shows a detailed table of kepfi trashed items
  -r,  --restore <FILE>         Restores a file/folder back to its original location
  -t,  --temp <FILE>            Move a file/folder to /tmp/
  -ps, --purge-specific <FILE>  Purge specific file/folder in kepfi trash
  -pa, --purge-all              Purge all files/folders in kepfi trash
  -f,  --force                  Force action (no confirmation)
  -at, --at-time <HH:MM>        Schedule a one-time purge at a specific time
  -v,  --version                Displays version and infos

Examples:
kepfi file.txt        Move file.txt to kepfi trash
kepfi -r file.txt     Restore file.txt to its original path
kepfi -at 22:30       Schedule a background purge for 22:30

📥 Easy Install

curl -sSL https://raw.githubusercontent.com/knuspii/kepfi/main/install.sh | sudo bash

Or

go install github.com/Knuspii/kepfi@latest

You can also download kepfi from the Releases

---

📂 Directory Structure

~/.local/share/kepfi/
├── trash/           # This is where your 'deleted' files actually live
└── metadata.json    # The "brain" that remembers original paths and timestamps

How to Build it yourself!

git clone https://github.com/Knuspii/kepfi.git
cd kepfi/scripts
bash lin_build.sh

---

💀 rm is mid. kepfi is the glow-up.

Using rm in 2026 is low-key traumatic. It’s giving "I accidentally deleted my entire project..."