hardik.47
📚 Table of Contents
✨ What is namastejs?
A lightweight, fun, and powerful developer utility CLI. It started with a simple blessing and now supports real productivity tools like branch management, port killing, vault management, project cleaning, and more — all accessible via npx.
⚡ Quick Start
npx namastejs📦 Install (Optional)
npm install -g namastejs🧰 CLI Features
| Feature | Command Example | Description |
|---|---|---|
| 🙏 Default Greet | npx namastejs |
Prints a dev blessing and a spiritual namaste quote |
| 🔄 Branch Updater | npx namastejs update --my=feature --from=dev |
Pulls & merges a source branch into your current working one |
| 🔌 Port Scanner | npx namastejs ports |
Lists active local ports with process names and PIDs |
| ❌ Kill a Port | npx namastejs ports --kill=3000 |
Frees a stuck port instantly |
| 📊 Size Analyzer | npx namastejs size |
Displays top 5 heaviest folders/files in your project |
| 🧘 Breathing Timer | npx namastejs breathe |
60-second breathing animation for mental reset |
| 🔐 Vault CLI | npx namastejs vault |
Manage dev credentials (add/get/list/delete/clear) |
| 🚿 Project Cleaner | npx namastejs clear |
Deletes node_modules, dist, build, and cache folders |
| ⚙️ Project Setup | npx namastejs setup |
Installs dependencies, checks tools, creates .env if needed |
| 💬 Dev Blessing API | require('namastejs').blessingForDev() |
Use it in your apps to inject positive vibes into the console |
📊 Size Analyzer
npx namastejs size # Scan current directory for largest files/folders
npx namastejs size --path=C:\dev # Scan a custom path (e.g., project directory or drive)🔐 Vault Usage
npx namastejs vault add # Add a service (GitHub, Netlify, etc.)
npx namastejs vault get github # Get saved credentials
npx namastejs vault list # List all stored services
npx namastejs vault delete github # Delete a specific service
npx namastejs vault clear # Wipe the entire vault- Stored globally on your machine with safe (no-dependency) encryption.
📁 Setup Automation
npx namastejs setupThis command will 👇
- Check for required tools (git, node, npm)
- Install dependencies
- Create .env file from .env.sample (if available)
❤️ Contribution
Want to improve namastejs or suggest a new feature?
- Fork this project on GitLab: gitlab.com/hardik.47/namastejs
- Submit an issue or merge request
- Feature ideas? Use npx namastejs help and see what’s already built
⚒️ Made with
codeand a lot of ❤️ by Hardik B Chaudhary — may code bless you 🙏