andreafrancia/trash-cli

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

4557 stars · 211 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A Python command-line tool implementing the FreeDesktop.org Trash specification, providing commands to trash, list, restore, and permanently remove files using the same trashcan as KDE, GNOME, and XFCE. It records original paths, deletion dates, and permissions so deleted files can be safely recovered.

Use cases

• safely delete files from the terminal instead of rm
• restore accidentally deleted files from the command line
• list trashed files with deletion dates
• empty the trash or purge files older than N days
• script file deletion with recoverability in shell scripts
• remove specific trashed files matching a pattern

When to choose

• you want a recoverable alternative to rm on Linux
• you need CLI trash integration with desktop environments like GNOME or KDE
• you're writing scripts that delete files but want an undo path
• you want to age out trash contents automatically by deletion date

When to avoid

• you need a graphical trash manager
• you're on a platform without FreeDesktop trash support
• you want permanent, immediate deletion without a trashcan

Facets

cli-tool · maturity stable

cli file-system developer-tools developer-tools files cli python trashcan freedesktop file-deletion recycle-bin safe-rm command-line linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="andreafrancia/trash-cli")