command-profiler
v1.0.0
Published
Scoped command profiles for project & global usage
Maintainers
Readme
Command-Profiler 🚀

Scoped command profiles for the lazy (and efficient) developer in all of us.
What is Command-Profiler?
Tired of juggling a million terminal commands across projects? Wish you could magically summon the exact set of commands you need — whether you’re working on a project or just doing your global thing?
Command-Profiler has got your back.
It’s a CLI tool that helps you create, edit, delete, and run profiles — think of them as command playlists — scoped either per project or globally across your system.
Why use Command-Profiler?
- 🚀 Project or global scope: Use project-specific command bundles or go global if you’re feeling adventurous.
- 🎯 Keep your workflow clean: No more hunting through your shell history or guessing commands.
- 🧙♂️ Wizardry with a twist: Profiles are collections of commands you run with a single keyword. Boom!
- ✂️ Edit/Delete: Change your mind? Edit or delete profiles without breaking a sweat.
- ⚡ Run anytime: Fire off your favorite command combos instantly.
Installation
npm install -g command-profilerQuickstart
🧰 init — Initialize a config in your current project
Before using command-profiler inside a project, you can run:
npx cmdprofiler initThis will create a local configuration for your project:
your-project/ ├── cmdprofiler/ │ └── config.json
The config.json will look like this:
{ "profiles": {} }
Once initialized, any profiles you create from this folder (and any subfolders) will be stored locally in that cmdprofiler/config.json file — not in your global config. 🎯
Create a profile
npx cmdprofiler create devYou’ll be prompted to enter commands one-by-one. Press enter on an empty line when done.
List profiles
npx cmdprofiler listRun a profile
npx cmdprofiler run devEdit a profile
npx cmdprofiler edit devDelete a profile
npx cmdprofiler delete devQuick usage
📘 Full Usage Flow in a Project
Go into your project folder:
cd ~/Projects/my-awesome-appRun the init command:
npx cmdprofiler initCreate your first profile:
npx cmdprofiler create devList and run it:
npx cmdprofiler list
npx cmdprofiler run devNow you're flying. 🛫
Pro Tips 🧠
- Use
--globalflag to manage global profiles:
npx cmdprofiler list --global
npx cmdprofiler create deploy --globalProfiles are stored in:
- Project scope:
cmdprofiler/config.jsonin your project root (or nearest ancestor folder) - Global scope:
~/cmdprofiler/config.json
- Project scope:
You can add any shell commands you want — from
npm run buildtodocker-compose up.
Final Words
If you’re the type who likes to automate, simplify, and impress your future self — command-profiler is your new best friend. Make your terminal less talk, more action.
ABOUT THE AUTHOR
** cinfinit** — believes in clean code, minimal commands, and maximal productivity. When not coding, probably pondering the meaning of life… or the perfect CLI UX.
