CLI Tool Kit

A collection of lightweight, single-file command-line utilities for everyday tasks. Each tool is self-contained and ready to use from the terminal.

---

QUICK START

Clone repository

git clone https://github.com/nbolok-code/cli-tool-kit.git cd cli-tool-kit

Automatic install

./install.sh source venv/bin/activate

---

AVAILABLE COMMANDS

FILE ORGANIZER Organize files by type or date.

forganize ./downloads --by type forganize ./photos --by date --date-format "%Y-%m"

PASSWORD GENERATOR Generate secure passwords.

pgen --length 16 pgen --count 5 --entropy --copy

JSON FORMATTER Format, validate, and compact JSON.

jsonfmt config.json --format --sort-keys cat data.json | jsonfmt --compact

URL SHORTENER Shorten or expand URLs locally.

urlshort https://example.com --shorten urlshort https://tinyurl.com/abc123 --expand

CSV PROCESSOR Filter and aggregate CSV data.

csvproc data.csv --filter "age > 30" csvproc sales.csv --aggregate month revenue sum

TEXT PROCESSOR Process and analyze text files.

textproc document.txt --upper --stats textproc log.txt --filter "ERROR" --output errors.txt

---

MANUAL INSTALLATION (OPTIONAL)

python3 -m venv venv source venv/bin/activate pip install -r requirements.txt chmod +x tools/*.py

---

GLOBAL COMMANDS (OPTIONAL)

sudo ln -sf $(pwd)/tools/file_organizer.py /usr/local/bin/forganize sudo ln -sf $(pwd)/tools/password_generator.py /usr/local/bin/pgen sudo ln -sf $(pwd)/tools/json_formatter.py /usr/local/bin/jsonfmt sudo ln -sf $(pwd)/tools/url_shortener.py /usr/local/bin/urlshort sudo ln -sf $(pwd)/tools/csv_processor.py /usr/local/bin/csvproc sudo ln -sf $(pwd)/tools/text_processor.py /usr/local/bin/textproc

---

PROJECT STRUCTURE

. ├── tools/ │ ├── file_organizer.py │ ├── password_generator.py │ ├── json_formatter.py │ ├── url_shortener.py │ ├── csv_processor.py │ └── text_processor.py ├── examples/ ├── install.sh ├── requirements.txt └── README.md

---

REQUIREMENTS

pyperclip>=1.8.2 requests>=2.28.0 chardet>=5.1.0

---

HELP

forganize --help pgen --help jsonfmt --help urlshort --help csvproc --help textproc --help

---

LICENSE

MIT License