https://github.com/gabrielcapilla/zrm
Remove folders and files easily and efficiently
https://github.com/gabrielcapilla/zrm
cli nim tool
Last synced: 9 months ago
JSON representation
Remove folders and files easily and efficiently
- Host: GitHub
- URL: https://github.com/gabrielcapilla/zrm
- Owner: gabrielcapilla
- License: mit
- Created: 2024-06-16T23:50:47.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-18T05:10:21.000Z (9 months ago)
- Last Synced: 2025-09-18T07:10:38.379Z (9 months ago)
- Language: Nim
- Homepage:
- Size: 1.13 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zrm
`zrm` is a command-line tool written in Nim that enhances file and folder deletion by integrating with `fzf` (a command-line fuzzy finder). It provides a fast and interactive way to select multiple items for deletion.
## Features
- **Interactive Deletion:** Uses `fzf` to create a fuzzy-searchable, interactive list of files and directories.
- **Multiple Selections:** Select one or more items to delete using the `` key.
- **Safety First:**
- Requires confirmation before deleting any files.
- Prevents the deletion of critical system paths like your home directory (`/home/user`) or the root directory (`/`).
- **Efficient:** Quickly lists items in the current directory for selection.
## Prerequisites
- [Nim](https://nim-lang.org/install.html) (version 2.2.4 or higher)
- [fzf](https://github.com/junegunn/fzf#installation)
## Installation
### Install using Nimble
```bash
nimble install https://github.com/gabrielcapilla/zrm.git
```
### Build
1. **Clone the repository:**
```bash
git clone https://github.com/gabrielcapilla/zrm.git
cd zrm
```
2. **Install dependencies and build the project using Nimble:**
```bash
nimble install
```
## Usage
Simply run `zrm` in any directory:
```bash
zrm
```
This will open an `fzf` window listing all files and subdirectories in the current location.
- Navigate the list with the arrow keys.
- Use `` to select one or more items.
- Press `` to confirm your selection.
- Type `y` to confirm the deletion or `n` to cancel.
## Uninstallation
To remove `zrm` from your system, use Nimble:
```bash
nimble uninstall zrm
```
---
**Documentation automatically generated by the artificial intelligence model [Gemini CLI](https://github.com/google-gemini/gemini-cli).*