km-musthaq 1.0.0

package/.env

@@ -0,0 +1 @@
+FORMSPREE_ENDPOINT="https://formspree.io/f/xvzbaeqk"

package/.env.example

@@ -0,0 +1 @@
+FORMSPREE_ENDPOINT="https://formspree.io/f/xvzbaeqk"

package/README.md

@@ -0,0 +1,94 @@
+# km.musthaq CLI Portfolio 🚀
+
+A professional animated interactive terminal portfolio CLI tool.
+
+![Portfolio Preview](https://via.placeholder.com/800x400?text=Terminal+Portfolio+Preview)
+
+## ✨ Features
+
+- 🎨 **Hacker Theme**: Authentic terminal experience with green text and black background.
+- 🔄 **Interactive**: Navigate through `about`, `projects`, `skills`, and more.
+- 📧 **Contact Form**: Send messages directly from the terminal.
+- ⚡ **Animations**: Smooth typing effects and loading spinners.
+- 🛠 **Customizable**: Easy to modify content and extend commands.
+
+## 🚀 Usage
+
+Run the portfolio directly using `npx`:
+
+```bash
+npx km.musthaq
+```
+
+Or install globally:
+
+```bash
+npm install -g km.musthaq
+km.musthaq
+```
+
+## 🛠 Installation for Development
+
+1.  Clone the repository:
+    ```bash
+    git clone https://github.com/yourusername/km-musthaq.git
+    cd km-musthaq
+    ```
+
+2.  Install dependencies:
+    ```bash
+    npm install
+    ```
+
+3.  Run locally:
+    ```bash
+    node bin/index.js
+    ```
+    OR
+    ```bash
+    npm link
+    km.musthaq
+    ```
+
+## 📧 Configuration
+
+To enable the contact form sending feature, create a `.env` file in the root directory:
+
+```env
+FORMSPREE_ENDPOINT=https://formspree.io/f/your-form-id
+```
+
+> **Note**: You can get your Form Endpoint from [Formspree](https://formspree.io/).
+>
+> **Fallback**: If the endpoint is not configured, messages will be saved locally to `messages.log` in the project directory.
+
+## 📦 Publishing to npm
+
+1.  Login to npm:
+    ```bash
+    npm login
+    ```
+
+2.  Publish:
+    ```bash
+    npm publish
+    ```
+
+## 📝 Commands
+
+- `help`: List available commands
+- `about`: Display bio
+- `projects`: Show portfolio projects
+- `skills`: Display skill proficiency
+- `contact`: Send an email
+- `education`: Show educational background
+- `certifications`: List certifications
+- `leadership`: Show leadership roles
+- `neofetch`: Display fake system info
+- `sudo`: Try it and see 😉
+- `clear`: Clear the screen
+- `hire`: Open collaboration channel
+
+## 📄 License
+
+MIT

package/bin/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+const inquirer = require('inquirer');
+const clear = require('clear');
+const chalk = require('chalk');
+const { showBanner, createBox, printGreen } = require('../lib/ui');
+const { sleep, typeText } = require('../lib/animations');
+const commands = require('../lib/commands');
+const ora = require('ora');
+
+process.on('SIGINT', () => {
+    console.log(chalk.green('\nGoodbye!'));
+    process.exit(0);
+});
+
+const start = async () => {
+    clear();
+    const spinner = ora('Initializing Musthaq Portfolio...').start();
+    await sleep(1500);
+    spinner.text = 'Loading modules...';
+    await sleep(1000);
+    spinner.succeed('Access Granted ✔');
+
+    await showBanner();
+
+    await typeText('Welcome to the interactive portfolio of Musthaq.', 30);
+    console.log(chalk.gray('Type "help" to see available commands.'));
+
+    // Initial prompt
+    ask();
+};
+
+const ask = async () => {
+    const { command } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'command',
+            message: 'km.musthaq$:',
+            prefix: '',
+            suffix: '',
+            validate: (val) => val ? true : 'Please enter a command'
+        }
+    ]);
+
+    const cmd = command.trim().toLowerCase();
+
+    if (cmd === 'exit' || cmd === 'quit' || cmd === 'exit()') {
+        console.log(chalk.green('Goodbye!'));
+        process.exit(0);
+    }
+
+    if (commands[cmd]) {
+        await commands[cmd]();
+    } else {
+        console.log(chalk.red(`Command not found: ${cmd}`));
+        console.log(chalk.gray('Type "help" for a list of commands.'));
+    }
+
+    // Loop
+    ask();
+};
+
+start();

package/lib/animations.js

@@ -0,0 +1,11 @@
+const sleep = (ms = 100) => new Promise((r) => setTimeout(r, ms));
+
+const typeText = async (text, delay = 50) => {
+  for (const char of text) {
+    process.stdout.write(char);
+    await sleep(delay);
+  }
+  process.stdout.write('\n');
+};
+
+module.exports = { sleep, typeText };

package/lib/commands.js

@@ -0,0 +1,124 @@
+const chalk = require('chalk');
+const open = require('open');
+const { contact } = require('./contact');
+const { createBox, printGreen } = require('./ui');
+const { typeText, sleep } = require('./animations');
+const clear = require('clear');
+
+const commands = {
+    help: () => {
+        console.log(
+            chalk.green(
+                'Available commands: help | about | projects | skills | contact | education | certifications | leadership | neofetch | sudo | clear | hire'
+            )
+        );
+    },
+    about: async () => {
+        console.log(
+            createBox(
+                chalk.white(
+                    'AI Enthusiast\nFull Stack Developer\nFocused on automation & security'
+                ),
+                'About Me'
+            )
+        );
+    },
+    projects: async () => {
+        console.log(chalk.bold.green('Projects:'));
+        const projects = [
+            '• Phishing URL Detection – Built a machine learning model to classify phishing websites using URL-based feature extraction and Random Forest classifier. [GitHub]',
+            '• Handwritten Digit Recognition – Developed a model to classify handwritten digits using image processing. [GitHub]',
+            '• Portfolio Terminal Interface',
+        ];
+        for (const project of projects) {
+            await typeText(project, 20);
+        }
+    },
+    skills: async () => {
+        console.log(chalk.bold.green('Skills:'));
+        const skillCategories = [
+            '• Programming Languages: Python',
+            '• Web Development: React.js, React Native, HTML5, CSS3, JavaScript, Tailwind CSS',
+            '• Machine Learning & AI: TensorFlow, Scikit-learn, Machine Learning',
+            '• Database Management: MySQL, PostgreSQL',
+        ];
+
+        for (const skill of skillCategories) {
+            await typeText(skill, 20);
+        }
+    },
+    education: () => {
+        console.log(createBox(chalk.white('BCA Graduate\nBearys Institute of Emerging Science'), 'Education'));
+    },
+    certifications: () => {
+        console.log(createBox(chalk.white(
+            '• Foundation of Cyber Security: Gained essential knowledge of cybersecurity principles.\n' +
+            '• Play it Safe: Manage Security Risks: Acquired skills to identify and mitigate risks.\n' +
+            '• EyeQ Dot Net Webinar (Feb 2024): Cybersecurity webinar by leading company.\n' +
+            '• 2nd Place in Idea Pitching (Feb 2025): "SenseIT" by IEEE Student Branch.'
+        ), 'Certifications & Achievements'));
+    },
+    leadership: () => {
+        console.log(createBox(chalk.white(
+            '• 🔒 Reliable and Disciplined\n' +
+            '• 🤐 Lead Silently, Act Strongly\n' +
+            '• 🧑💻 Technical Role Model\n' +
+            '• 💬 Supportive in One-on-One'
+        ), 'Leadership Style'));
+    },
+    neofetch: () => {
+        const art = `
+@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+@@@@@@@#BGGB&@@@@@@@@&G555G#@@@@@@@&BBGB#&@@@@@@@@
+@@@@#J^.    :!P@@@@G!.     .~5@@@GJ?7777??5#@@@@@@
+@@@G:          7@@Y           !@G77???????7?G@@@@@
+@@@^            5&.            P@??????????7?&@@@@
+@@@^            5#             B@??????????7J@@@@@
+@@@G:          ?@7           .5@P7?77??????J#@@@@@
+@@@@&Y~:.  .^7GB~    .:^~^^!YBGJ77?5G#&&&&&@@@@@@@
+@@@@@@#GPPPPPY~   :JPGGGGGP5Y?77?P&&G5YJJY5G#@@@@@
+@@@&Y~...:..     ?&BY??777777?7Y&@5?77777777?5&@@@
+@@#^            !@577????????7J&@57??????????7Y@@@
+@@?             Y#7??????????7G@&????????????7?&@@
+@@J             ?@J7????????77#@@5?7????????7JP@@@
+@@&!            .P&Y?7777777JG@@@@#Y7???????P&@@@@
+@@@@P!:.....      7B#G5YY5PB&@@@@@@@Y7????7P@@@@@@
+@@@@@@#PYYYYY?^    .~?5PGB&@@@@@@@@@G7????7#@@@@@@
+@@@@B7:.   .:!55:         .~Y&@@@@@@57????7P@@@@@@
+@@@5.          7B:           ^#@@@&57???????5&@@@@
+@@&:            P5            7@@P?7????????7?5&@@
+@@&^            G5            ?@@J7??????????7J@@@
+@@@B:          J@#~          ~&@@#J77??????77J#@@@
+@@@@&5!:....^?B@@@@5!:.  .:!5@@@@@@@BYJ????JYG@@@@
+@@@@@@@&#B#&@@@@@@@@@&#BB#&@@@@@@@@@@@&##&@@@@@@@@
+@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@`;
+
+        const info = `
+Musthaq OS v1.0
+-----------------
+~ core.modules:   Cybersecurity, AI/ML, Full Stack
+~ sys.tools:      Python, React, Node.js, Linux
+~ exec.tasks:     Building Secure AI Systems
+~ focus.targets:  Automation & Innovation
+~ shell.env:      zsh / km-musthaq-cli
+~ cpu.mode:       100% Dedicated to Code
+~ gpu.driver:     Neural Engine Active
+~ mem.status:     Overflowing with Ideas`;
+
+        console.log(chalk.green(art));
+        console.log(chalk.cyan(info));
+    },
+    sudo: async () => {
+        await typeText('Hi I am Musthaq Ahmed a Cybersecurity & AI/ML Enthusiast', 50);
+    },
+    clear: () => {
+        clear();
+    },
+    hire: async () => {
+        console.log(chalk.green('Smart decision detected.\nOpening collaboration channel...\nLet\'s build something legendary.'));
+        // open('mailto:musthaqahmead@gmail.com'); // Optional: open email client
+    },
+    contact: contact
+};
+
+module.exports = commands;

package/lib/contact.js

@@ -0,0 +1,71 @@
+const inquirer = require('inquirer');
+const axios = require('axios');
+const ora = require('ora');
+const chalk = require('chalk');
+const { sleep } = require('./animations');
+const fs = require('fs');
+const path = require('path');
+require('dotenv').config();
+
+const contact = async () => {
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Name:',
+            validate: (input) => (input ? true : 'Name is required'),
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Email:',
+            validate: (input) =>
+                /\S+@\S+\.\S+/.test(input) ? true : 'Please enter a valid email',
+        },
+        {
+            type: 'input',
+            name: 'message',
+            message: 'Message:',
+            validate: (input) => (input ? true : 'Message is required'),
+        },
+    ]);
+
+    const spinner = ora('Sending message via Formspree...').start();
+    await sleep(1000); // Simulate network delay
+
+    const endpoint = process.env.FORMSPREE_ENDPOINT;
+
+    try {
+        if (endpoint) {
+            await axios.post(endpoint, {
+                name: answers.name,
+                email: answers.email,
+                message: answers.message
+            });
+            spinner.succeed(chalk.green('Message sent successfully via email ✔'));
+            console.log(chalk.green('Musthaq will contact you soon.'));
+        } else {
+            // Mock send + Local Save
+            spinner.warn(chalk.yellow('Formspree Endpoint not found in .env'));
+
+            const logPath = path.join(process.cwd(), 'messages.log');
+            const logEntry = `\n--- [${new Date().toISOString()}] (MOCK/NO-ENDPOINT) ---\nName: ${answers.name}\nEmail: ${answers.email}\nMessage: ${answers.message}\n`;
+
+            fs.appendFileSync(logPath, logEntry);
+
+            spinner.succeed(chalk.green(`Message saved locally to ${logPath} ✔`));
+            console.log(chalk.cyan('Since Formspree is not configured, I saved your message to a file!'));
+            console.log(chalk.gray('Tip: Configure FORMSPREE_ENDPOINT in .env to enable real emailing.'));
+        }
+
+    } catch (error) {
+        spinner.fail(chalk.red('Failed to send message via Formspree.'));
+        // Fallback save
+        const logPath = path.join(process.cwd(), 'messages.log');
+        const logEntry = `\n--- [${new Date().toISOString()}] (FAILED FORMSPREE) ---\nName: ${answers.name}\nEmail: ${answers.email}\nMessage: ${answers.message}\nError: ${error.message}\n`;
+        fs.appendFileSync(logPath, logEntry);
+        console.log(chalk.yellow(`Saved to ${logPath} instead.`));
+    }
+};
+
+module.exports = { contact };

package/lib/ui.js

@@ -0,0 +1,34 @@
+const figlet = require('figlet');
+const gradient = require('gradient-string');
+const boxen = require('boxen');
+const chalk = require('chalk');
+
+const showBanner = () => {
+    return new Promise((resolve, reject) => {
+        figlet('Musthaq', (err, data) => {
+            if (err) {
+                console.log('Something went wrong...');
+                console.dir(err);
+                reject(err);
+                return;
+            }
+            console.log(gradient.pastel.multiline(data));
+            resolve();
+        });
+    });
+};
+
+const createBox = (text, title = '') => {
+    return boxen(text, {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'green',
+        title: title,
+        titleAlignment: 'center',
+    });
+};
+
+const printGreen = (text) => console.log(chalk.green(text));
+
+module.exports = { showBanner, createBox, printGreen };

package/messages.log

@@ -0,0 +1,15 @@
+
+--- [2026-02-16T05:37:51.614Z] ---
+Name: adler
+Email: musthaqibnmohammad@gmail.com
+Message: hey
+
+--- [2026-02-16T05:52:53.441Z] (MOCK/NO-ENDPOINT) ---
+Name: musthaq
+Email: musthaqibnmohammad@gmail.com
+Message: hey
+
+--- [2026-02-16T05:53:49.595Z] (MOCK/NO-ENDPOINT) ---
+Name: musthaq
+Email: musthaqibnmohammad@gmail.com
+Message: hey

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "km-musthaq",
+  "version": "1.0.0",
+  "description": "",
+  "main": "bin/index.js",
+  "bin": {
+    "km-musthaq": "bin/index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "axios": "^1.13.5",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "clear": "^0.1.0",
+    "dotenv": "^10.0.0",
+    "figlet": "^1.5.0",
+    "gradient-string": "^2.0.0",
+    "inquirer": "^8.0.0",
+    "open": "^8.4.0",
+    "ora": "^5.4.1"
+  }
+}