🧰 CLI Toolkit

Unified collection of command-line utilities for everyday tasks — Node.js & Python

---

📦 Installation

Node.js Tools (via PNPM)

# Install all tools
pnpm install -g @mizoz/cli-toolkit

# Or install individual tools
pnpm install -g @mizoz/pass-gen
pnpm install -g @mizoz/timestamp
pnpm install -g @mizoz/uuid-gen

Python Tools (via pip)

# Install all tools
pip install mizoz-cli-toolkit

# Or install individual tools
pip install mizoz-pass-gen
pip install mizoz-timestamp
pip install mizoz-uuid-gen

---

🛠️ Available Tools

🔐 Security & Cryptography

Tool	Node.js	Python	Description
pass-gen	✅	✅	Generate secure random passwords
uuid-gen	✅	✅	Generate UUIDs (v4)
hash-gen	✅	✅	Generate cryptographic hashes (MD5, SHA1, SHA256)

📅 Date & Time

Tool	Node.js	Python	Description
timestamp	✅	✅	Work with timestamps and date/time conversions

📄 File Operations

Tool	Node.js	Python	Description
file-counter	✅	✅	Count lines, words, and characters in files
batch-renamer	✅	❌	Batch file renamer CLI tool
csv-viewer	❌	✅	View and analyze CSV files in the terminal
file-watcher	❌	✅	Watch file system changes in real-time

🔧 Data & Text Processing

Tool	Node.js	Python	Description
json-prettifier	✅	✅	Format and prettify JSON data
json-validator	✅	✅	Validate JSON syntax quickly
text-diff	✅	✅	Compare and show differences between text files
base64-tool	✅	✅	Base64 encode/decode
url-encode	✅	✅	URL encoding and decoding
color-convert	✅	✅	Convert between HEX and RGB color formats

📊 Batch Processing

Tool	Language	Description
batch-json-processor	Node.js	Process JSON files in batch

🏗️ Generators

Tool	Language	Description
boilerplate-generator	Node.js	Generate project boilerplates
changelog-generator	Python	Generate changelogs from git history
code-stats-cli	Node.js	Code statistics and metrics

📝 Utilities

Tool	Language	Description
quick-note	Python	Fast note-taking CLI for capturing ideas

---

📁 Project Structure

cli-toolkit/
├── packages/
│   ├── nodejs/           # Node.js tools (PNPM workspaces)
│   └── python/           # Python tools (pip installable)
├── shared/               # Language-agnostic tools
└── generators/           # Code generators

---

🚀 Quick Start

Node.js Example

# Generate a secure password
pass-gen --length 32 --symbols

# Generate a UUID
uuid-gen --count 5

# Hash a file
hash-gen --algorithm sha256 myfile.txt

Python Example

# Generate a secure password
pass-gen --length 32 --symbols

# View CSV stats
csv-viewer --stats data.csv

# Watch a directory
file-watcher --path ./my-project

---

🧪 Development

Node.js Tools

cd packages/nodejs
pnpm install

# Run all tests
pnpm test

# Build all packages
pnpm build

Python Tools

cd packages/python

# Install in development mode
pip install -e .

# Run tests
pytest

---

📄 License

MIT © AZ

---

🙏 Acknowledgments

All tools were originally developed as standalone repositories and consolidated into this monorepo for easier maintenance and discovery.