resrm/README.md

resrm

resrm is a safe, drop-in replacement for the Linux rm command with undo/restore support.
It moves files to a per-user trash instead of permanently deleting them, while still allowing full sudo support for root-owned files.

---

Features

• Move files and directories to a trash folder instead of permanent deletion
• Restore deleted files by short ID or exact basename
• Empty trash safely
• Supports -r, -f, -i, --perma options
• Works with sudo for root-owned files

---

Installation

Install via Poetry:

poetry add resrm

Or clone the repo and install locally:

git clone https://github.com/yourusername/resrm.git
cd resrm
poetry install

Usage

# Move files to trash
resrm file1 file2

# Recursive remove of a directory
resrm -r mydir

# Force remove (ignore nonexistent)
resrm -f file

# Interactive remove
resrm -i file

# Permanent delete (bypass trash)
resrm --perma file

# List trash entries
resrm -l

# Restore a file by ID or basename
resrm --restore <id|name>

# Empty the trash permanently
resrm --empty

Trash Location

Normal users: ~/.local/share/resrm/files

Root user: /root/.local/share/resrm/files