kitsune-cli 1.0.0

package/README.md

@@ -0,0 +1,149 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/bhavish-codes/Kitsune-cli/main/assets/logo.png" alt="Kitsune CLI" width="200" onerror="this.style.display='none'"/>
+  
+  <h1>🦊 Kitsune CLI</h1>
+  <p><b>A mystical, fox-spirit themed command-line interface companion.</b></p>
+
+  <p>
+    <a href="https://github.com/bhavish-codes/Kitsune-cli/issues"><img src="https://img.shields.io/github/issues/bhavish-codes/Kitsune-cli?style=flat-square&color=magenta" alt="Issues"></a>
+    <a href="https://github.com/bhavish-codes/Kitsune-cli/stargazers"><img src="https://img.shields.io/github/stars/bhavish-codes/Kitsune-cli?style=flat-square&color=cyan" alt="Stars"></a>
+    <a href="https://github.com/bhavish-codes/Kitsune-cli/blob/main/LICENSE"><img src="https://img.shields.io/github/license/bhavish-codes/Kitsune-cli?style=flat-square&color=yellow" alt="License"></a>
+  </p>
+</div>
+
+---
+
+**Kitsune CLI** (`kit`) is a beautifully crafted, terminal-based companion. Channeling the ancient wisdom of the Kitsune (fox spirit), this CLI tool provides mystical advice, speaks to you directly through your terminal, and offers a visually stunning experience using gradients, beautiful boxes, and terminal animations.
+
+
+##  Features
+
+- 🦊 **Mystical Aesthetic:** Beautiful terminal styling using `chalk`, `gradient-string`, and `boxen`.
+- 🗣️ **Auditory Responses:** The spirit actually speaks to you using the `say` package.
+- 🧘‍♂️ **Wisdom & Quotes:** Summons random wisdom and philosophical quotes via the API Ninjas service.
+- 🛠️ **Modular Architecture:** Built with TypeScript and Node.js using `commander`.
+
+##  Installation
+
+Ensure you have [Node.js](https://nodejs.org/) installed, then follow these steps:
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/bhavish-codes/Kitsune-cli.git
+   cd Kitsune-cli
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+3. **Set up your environment variables:**
+   Create a `.env` file in the root directory and add your API Ninjas Key:
+   ```env
+   API_NINJAS_KEY=your_api_key_here
+   ```
+
+4. **Build the TypeScript files:**
+   ```bash
+   npx tsc
+   ```
+
+5. **Link the package globally:**
+   ```bash
+   npm link
+   ```
+
+Now you can summon the spirit from anywhere using the `kit` command!
+
+##  Usage & Commands
+
+Here are the currently active incantations you can use:
+
+### 1. Speak
+Have the Kitsune channel ancient wisdom and speak your words aloud.
+
+```bash
+kit speak "Hello traveler, welcome to my realm."
+```
+
+### 2. Spirit
+Summon the Kitsune spirit to receive a piece of wisdom, philosophy, or truth. Optionally, have the spirit speak the quote out loud.
+
+```bash
+kit spirit
+# Or to hear the spirit speak:
+kit spirit speak
+```
+
+### 3. Help
+Summon the mystical help menu for detailed information about a specific command.
+
+```bash
+kit help speak
+```
+
+### 4. Loud
+Make the Kitsune shout your message across the digital realm, using large text.
+
+```bash
+kit loud "Wake up!"
+# Or to hear the spirit speak loud:
+kit loud "Wake up!" speak
+```
+
+### 5. Riddle
+The cunning fox presents a puzzle for your mind. You can provide a timer in seconds.
+
+```bash
+kit riddle 30
+```
+
+### 6. Joke
+A touch of kitsune mischief. Summon the fox to tell you a witty joke.
+
+```bash
+kit joke
+# Or to hear the spirit speak the joke:
+kit joke speak
+```
+
+### 7. Weather
+Read the winds and skies. The spirit will consult the atmosphere to divine your local conditions or any specified location.
+
+```bash
+kit weather
+# For a specific location:
+kit weather tokyo
+# To hear the forecast aloud:
+kit weather london speak
+```
+
+### 8. Wordel
+The cunning fox tests your vocabulary with a game of Wordel. You have 6 tries to guess a mystery word. You can optionally specify the word length.
+
+```bash
+kit wordel
+# For a specific word length between 3 and 8:
+kit wordel 6
+```
+
+---
+
+##  Built With
+
+- [TypeScript](https://www.typescriptlang.org/) - For robust, strongly-typed code.
+- [Commander.js](https://github.com/tj/commander.js) - The complete solution for node.js command-line interfaces.
+- [Chalk](https://github.com/chalk/chalk) & [Gradient-String](https://github.com/bokub/gradient-string) - For beautiful terminal styling.
+- [Boxen](https://github.com/sindresorhus/boxen) - For creating terminal boxes.
+- [Ora](https://github.com/sindresorhus/ora) - Elegant terminal spinners.
+- [Say](https://github.com/Marak/say.js) - TTS (Text To Speech) wrapper.
+
+##  Contributing
+
+Contributions, issues, and feature requests are welcome!
+Feel free to check the [issues page](https://github.com/bhavish-codes/Kitsune-cli/issues) if you want to contribute.
+
+##  License
+
+This project is licensed under the ISC License.

package/dist/cli_engin/cli_engin.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+class CLI {
+    constructor() {
+        this.program = new commander_1.Command();
+    }
+    registerCommand(command) {
+        command.forEach((value) => {
+            const cmdInstance = new value(this.program);
+            cmdInstance.register();
+        });
+    }
+    run() {
+        this.program.parse();
+    }
+}
+exports.default = CLI;

package/dist/commands/apiStorage.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiKey = exports.setApiKey = void 0;
+const fs_1 = require("fs");
+const FILE_PATH = __dirname + "/file.txt";
+const setApiKey = (key) => (0, fs_1.writeFileSync)(FILE_PATH, key.trim(), "utf-8");
+exports.setApiKey = setApiKey;
+const getApiKey = () => (0, fs_1.existsSync)(FILE_PATH) ? (0, fs_1.readFileSync)(FILE_PATH, "utf-8").trim() : null;
+exports.getApiKey = getApiKey;

package/dist/commands/help.js

@@ -0,0 +1,153 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const boxen_1 = __importDefault(require("boxen"));
+class Help {
+    constructor(program) {
+        this.existingCommands = [
+            "spirit",
+            "speak",
+            "riddle",
+            "joke",
+            "loud",
+            "wordel",
+            "weather"
+        ];
+        this.implementedCommands = ["speak", "spirit", "loud", "riddle", "joke", "weather", "wordel"];
+        this.commandHelpData = {
+            speak: {
+                title: "🦊  Kitsune Speak Command",
+                summary: "Have the Kitsune channel ancient wisdom and speak your words aloud.",
+                usage: "kitsune speak <message>",
+                description: "Invoke the fox spirit to vocalize a message through your terminal.\nThe spirit uses TTS (Text-to-Speech) to clearly enunciate your thoughts.",
+                examples: [
+                    'kit speak "Hello traveler"',
+                    'kit speak "Build completed successfully"',
+                    'kit speak "The spiritual realm awaits"',
+                ],
+            },
+            spirit: {
+                title: "🦊  Kitsune Spirit Command",
+                summary: "Summon the Kitsune spirit to receive quotes of philosophy and truth.",
+                usage: "kitsune spirit [speak]",
+                description: "Calls upon the fox spirit to guide your terminal journey with timeless wisdom.\nPass the optional `speak` argument to hear the spirit read the quote aloud.",
+                examples: [
+                    "kit spirit",
+                    "kit spirit speak"
+                ],
+            },
+            loud: {
+                title: "🦊  Kitsune Loud Command",
+                summary: "Make the Kitsune shout your message across the digital realm.",
+                usage: "kitsune loud <text> [speak]",
+                description: "Proclaim a grand message with large, shadow-styled ASCII text.\nPass the optional `speak` argument to have the spirit announce it out loud.",
+                examples: [
+                    'kit loud "Wake up!"',
+                    'kit loud "Tests Passing!" speak',
+                ],
+            },
+            riddle: {
+                title: "🦊  Kitsune Riddle Command",
+                summary: "The Kitsune spirit shares a mysterious riddle.",
+                usage: "kitsune riddle <timer>",
+                description: "The cunning fox tests your wits by presenting a riddle.\nYou have the given time (in seconds) to contemplate the answer.",
+                examples: [
+                    "kit riddle 30",
+                    "kit riddle 60"
+                ],
+            },
+            joke: {
+                title: "🦊  Kitsune Joke Command",
+                summary: "The Kitsune spirit shares a humorous joke.",
+                usage: "kitsune joke [speak]",
+                description: "The playful fox entertains you with a witty joke.\nPass the optional `speak` argument to have the spirit tell the joke aloud.",
+                examples: [
+                    "kit joke",
+                    "kit joke speak"
+                ]
+            },
+            weather: {
+                title: "🦊  Kitsune Weather Command",
+                summary: "Read the winds and skies for any location.",
+                usage: "kitsune weather [location] [speak]",
+                description: "The spirit looks into the atmosphere to tell you the current weather.\nYou can specify a location or let it read your local skies.\nPass the optional `speak` argument to hear the forecast aloud.",
+                examples: [
+                    "kit weather",
+                    "kit weather tokyo",
+                    "kit weather speak",
+                    "kit weather london speak"
+                ]
+            },
+            wordel: {
+                title: "🦊  Kitsune Wordel Command",
+                summary: "The Kitsune challenges your vocabulary with a game of Wordel.",
+                usage: "kitsune wordel [wordlength]",
+                description: "Play a mystical game of Wordel with the fox.\nYou have 6 tries to guess a mystery word. You can optionally specify the word length (between 3 and 8).",
+                examples: [
+                    "kit wordel",
+                    "kit wordel 6"
+                ]
+            }
+        };
+        this.kitsune = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("help <command>")
+            .description("Display help information for a specific command")
+            .action((command) => this.show(command));
+    }
+    show(command) {
+        console.log(gradient_string_1.default.instagram.multiline(`
+╔══════════════════════════════╗
+     🦊  KITSUNE CLI HELP
+╚══════════════════════════════╝
+`));
+        if (this.implementedCommands.includes(command)) {
+            const details = this.commandHelpData[command];
+            if (details) {
+                console.log(gradient_string_1.default.pastel(this.kitsune));
+                const examplesText = details.examples.map(ex => `  ${ex}`).join("\n");
+                const helpText = `
+${details.title}
+
+${details.summary}
+
+Usage
+  ${details.usage}
+
+Description
+  ${details.description}
+
+Examples
+${examplesText}
+`;
+                console.log((0, boxen_1.default)(chalk_1.default.cyan(helpText), {
+                    padding: 1,
+                    borderStyle: "round",
+                    borderColor: "magenta",
+                }));
+            }
+            else {
+                console.log(chalk_1.default.yellow(`\nHelp documentation for '${command}' is being written by the spirits...`));
+            }
+        }
+        else if (this.existingCommands.includes(command)) {
+            console.log(chalk_1.default.yellow(`\nThe command '${command}' is still in development. Please check back later!`));
+        }
+        else {
+            console.log(chalk_1.default.red(`\nThe command '${command}' is not available.`));
+        }
+    }
+}
+exports.default = Help;

package/dist/commands/init.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const apiStorage_1 = require("./apiStorage");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+class Init {
+    constructor(program) {
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("init [apikey]")
+            .description("Initialize the Kitsune CLI environment")
+            .action((apikey) => this.initialize(apikey));
+    }
+    async initialize(apiKey) {
+        if (!apiKey) {
+            console.log("enter your api ninja api key:");
+            console.log("https://api-ninjas.com/profile");
+            console.log("kit init <your-api-key>");
+            return;
+        }
+        console.log("Initializing Kitsune CLI...");
+        const spinner = (0, ora_1.default)({
+            text: chalk_1.default.magenta("🦊 Validating your API Key..."),
+            spinner: "dots",
+        }).start();
+        try {
+            const res = await fetch(`https://api.api-ninjas.com/v1/jokes`, {
+                headers: {
+                    "X-Api-Key": apiKey,
+                },
+            });
+            if (!res.ok) {
+                spinner.fail(chalk_1.default.red("Invalid API Key! The key was not saved. Please check your key."));
+                return;
+            }
+            spinner.succeed(chalk_1.default.green("API Key is valid!"));
+            (0, apiStorage_1.setApiKey)(apiKey);
+            console.log(chalk_1.default.green('API Key saved successfully!'));
+        }
+        catch (err) {
+            spinner.fail(chalk_1.default.red('Failed to validate API Key: ' + err));
+            return;
+        }
+        console.log("Kitsune CLI is ready to use! Type 'kit --help' to see available commands.");
+    }
+}
+exports.default = Init;

package/dist/commands/joke.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const ora_1 = __importDefault(require("ora"));
+const say_1 = __importDefault(require("say"));
+const apiStorage_1 = require("./apiStorage");
+class Joke {
+    constructor(program) {
+        this.kitsune = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("joke [speak]")
+            .description("The Kitsune spirit shares a humorous joke")
+            .action((speak) => this.joker(speak));
+    }
+    async joker(speak) {
+        if (!(0, apiStorage_1.getApiKey)()) {
+            console.log(chalk_1.default.red("\nYou have to first write kit init <apikey>\n"));
+            return;
+        }
+        console.log(gradient_string_1.default.pastel(this.kitsune));
+        console.log(chalk_1.default.red("\n🔥 KITSUNE APEARS 🔥\n"));
+        const spinner = (0, ora_1.default)({
+            text: chalk_1.default.magenta("🦊 Summoning the Kitsune spirit..."),
+            spinner: "dots",
+        }).start();
+        try {
+            const res = await fetch(`https://api.api-ninjas.com/v1/jokes`, {
+                headers: {
+                    "X-Api-Key": (0, apiStorage_1.getApiKey)() || "",
+                },
+            });
+            if (!res.ok) {
+                throw new Error("Failed to fetch joke");
+            }
+            const data = await res.json();
+            spinner.stop();
+            console.log(chalk_1.default.yellow(`😂 Joke: ${data[0].joke}\n`));
+            if (speak) {
+                say_1.default.speak(data[0].joke, "Kyoko");
+            }
+        }
+        catch (error) {
+            spinner.stop();
+            console.log(chalk_1.default.red("🌪️  The spirit could not remember a joke at this time."));
+        }
+    }
+}
+exports.default = Joke;

package/dist/commands/loud.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const figlet_1 = __importDefault(require("figlet"));
+const chalk_1 = __importDefault(require("chalk"));
+const say_1 = __importDefault(require("say"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+class Loud {
+    constructor(program) {
+        this.kitsune = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("loud <text> [speak]")
+            .description("Make the Kitsune shout your message across the digital realm")
+            .action((text, speak) => this.loud(text, speak));
+    }
+    async loud(text, speak) {
+        console.log(gradient_string_1.default.pastel(this.kitsune));
+        console.log(chalk_1.default.red("\n🔥 KITSUNE PROCLAMATION 🔥\n"));
+        (0, figlet_1.default)(text.toUpperCase(), { font: "ANSI Shadow" }, (err, data) => {
+            console.log(gradient_string_1.default.passion(data));
+            if (speak) {
+                say_1.default.speak(text, "Kyoko", 1.8);
+            }
+        });
+    }
+}
+exports.default = Loud;

package/dist/commands/riddle.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const boxen_1 = __importDefault(require("boxen"));
+const apiStorage_1 = require("./apiStorage");
+class Riddle {
+    constructor(program) {
+        this.kitsune = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("riddle <timer>")
+            .description("The Kitsune spirit shares a mysterious riddle")
+            .action((timer) => this.startrRiddle(timer));
+    }
+    async startrRiddle(timer) {
+        if (!(0, apiStorage_1.getApiKey)()) {
+            console.log(chalk_1.default.red("\nYou have to first write kit init <apikey>\n"));
+            return;
+        }
+        try {
+            console.log(gradient_string_1.default.pastel(this.kitsune));
+            console.log(chalk_1.default.red(`\n🔥 The Kitsune presents you with a riddle. You have ${timer} seconds to solve it! 🔥\n`));
+            const spinner = (0, ora_1.default)({
+                text: chalk_1.default.magenta("🦊 Summoning the Kitsune spirit..."),
+                spinner: "dots",
+            }).start();
+            const res = await fetch(`https://api.api-ninjas.com/v1/riddles`, {
+                headers: {
+                    "X-Api-Key": (0, apiStorage_1.getApiKey)() || "",
+                },
+            });
+            if (!res.ok) {
+                throw new Error("Failed to fetch riddle");
+            }
+            const data = await res.json();
+            spinner.stop();
+            const riddle = data[0].question;
+            const answer = data[0].answer;
+            console.log(chalk_1.default.yellow(`🧩 Riddle: ${riddle}\n`));
+            let timeLeft = Number(timer);
+            await new Promise((resolve) => {
+                const interval = setInterval(() => {
+                    console.clear();
+                    const message = `
+🧩 Riddle:
+${riddle}
+
+⏳ Time left: ${timeLeft}s
+`;
+                    console.log((0, boxen_1.default)(chalk_1.default.cyan(message), {
+                        padding: 1,
+                        borderStyle: "round",
+                        borderColor: "magenta",
+                        title: "🦊 Kitsune Wisdom",
+                        titleAlignment: "center",
+                    }));
+                    timeLeft--;
+                    if (timeLeft < 0) {
+                        clearInterval(interval);
+                        process.stdout.write("\n");
+                        resolve(null);
+                    }
+                }, 1000);
+            });
+            console.log(chalk_1.default.green(`💡 Answer: ${answer}`));
+        }
+        catch (error) {
+            console.error(chalk_1.default.red("An error occurred while fetching the riddle. Please try again later."));
+        }
+    }
+}
+exports.default = Riddle;

package/dist/commands/speak.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const say_1 = __importDefault(require("say"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+class Speak {
+    constructor(program) {
+        this.kitsune = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("speak <text>")
+            .description("Have the Kitsune channel ancient wisdom and speak your words aloud")
+            .action((text) => this.talk(text));
+    }
+    talk(text) {
+        console.log(gradient_string_1.default.pastel(this.kitsune));
+        const spinner = (0, ora_1.default)({
+            text: chalk_1.default.cyan("The Kitsune is channeling ancient wisdom..."),
+            spinner: "dots",
+        }).start();
+        setTimeout(() => {
+            spinner.stop();
+            console.log(chalk_1.default.yellow(`🦊 ${text}`));
+            say_1.default.speak(text, "Kyoko");
+        }, 3000);
+    }
+}
+exports.default = Speak;

package/dist/commands/spirit.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const say_1 = __importDefault(require("say"));
+const boxen_1 = __importDefault(require("boxen"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const ora_1 = __importDefault(require("ora"));
+const apiStorage_1 = require("./apiStorage");
+class Spirit {
+    constructor(program) {
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("spirit [speak]")
+            .description("Summon the Kitsune spirit to receive quotes of philosophy and truth")
+            .action((speak) => this.invoke(speak));
+    }
+    async invoke(speak) {
+        if (!(0, apiStorage_1.getApiKey)()) {
+            console.log(chalk_1.default.red("\nYou have to first write kit init <apikey>\n"));
+            return;
+        }
+        try {
+            const spinner = (0, ora_1.default)({
+                text: chalk_1.default.magenta("🦊 Summoning the Kitsune spirit..."),
+                spinner: "dots",
+            }).start();
+            const categories = [
+                "wisdom",
+                "philosophy",
+                "life",
+                "truth",
+                "inspirational",
+                "relationships",
+                "love",
+                "faith",
+                "humor",
+                "success",
+                "courage",
+                "happiness",
+                "art",
+                "writing",
+                "fear",
+                "nature",
+                "time",
+                "freedom",
+                "death",
+                "leadership",
+            ];
+            const shuffled = [...categories].sort(() => 0.5 - Math.random());
+            const count = Math.floor(Math.random() * 3) + 1;
+            const selected = shuffled.slice(0, count);
+            const categoryParam = encodeURIComponent(selected.join(","));
+            const res = await fetch(`https://api.api-ninjas.com/v2/quotes?categories=${categoryParam}`, {
+                headers: {
+                    "X-Api-Key": (0, apiStorage_1.getApiKey)() || "",
+                },
+            });
+            const data = await res.json();
+            spinner.stop();
+            const quote = data[0].quote;
+            const author = data[0].author;
+            const fox = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+            console.log(gradient_string_1.default.pastel(fox));
+            const message = `
+"${quote}"
+
+— ${author}
+`;
+            console.log((0, boxen_1.default)(chalk_1.default.cyan(message), {
+                padding: 1,
+                borderStyle: "round",
+                borderColor: "magenta",
+                title: "🦊 Kitsune Wisdom",
+                titleAlignment: "center",
+            }));
+            console.log(chalk_1.default.gray("\n✨ The fox spirit fades into the forest...\n"));
+            if (speak) {
+                say_1.default.speak(quote, "Kyoko");
+            }
+        }
+        catch (err) {
+            console.log("🦊 The spirit could not be summoned...");
+        }
+    }
+}
+exports.default = Spirit;

package/dist/commands/weather.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const ora_1 = __importDefault(require("ora"));
+const boxen_1 = __importDefault(require("boxen"));
+const say_1 = __importDefault(require("say"));
+const weatherReplies = {
+    "Haze": "A mystical veil blurs the horizon. The kitsune's eyes glow through the haze.",
+    "Rain with thunderstorm": "Lightning cracks the weeping sky! The fox seeks the safety of the deep woods.",
+    "Haze, rain with thunderstorm": "A mystical veil blurs the horizon as lightning cracks the weeping sky! The fox seeks the safety of the deep woods.",
+    "Sunny": "The fox lounges in golden warmth, tail curled in bliss. The heavens smile upon your journey today.",
+    "Clear": "Not a single cloud dares interrupt the sky. The spirit realm is open — your path is unobstructed.",
+    "Partly Cloudy": "The sun plays hide and seek with the clouds. Even the sky cannot make up its mind today.",
+    "Partly cloudy": "The sun plays hide and seek with the clouds. Even the sky cannot make up its mind today.",
+    "Cloudy": "The heavens have drawn grey curtains across the sky. The fox watches from the shadows.",
+    "Overcast": "A heavy blanket smothers the sky. The spirits are in deep thought. Tread quietly today.",
+    "Mist": "The veil between realms grows thin. Walk carefully — not all that moves in the mist is of this world.",
+    "Fog": "The fox vanishes into the white silence. The world beyond ten steps is a mystery.",
+    "Freezing Fog": "Frozen spirits drift through the air. The cold bites and blinds. Even the fox stays close to warmth.",
+    "Freezing fog": "Frozen spirits drift through the air. The cold bites and blinds. Even the fox stays close to warmth.",
+    "Patchy rain possible": "The fox flicks its ears. A few droplets dance nearby — not enough to drench, just enough to tease.",
+    "Patchy rain nearby": "The fox flicks its ears. A few droplets dance nearby — not enough to drench, just enough to tease.",
+    "Light drizzle": "The sky weeps softly, barely a whisper of rain. The fox does not even bother to find shelter.",
+    "Rain": "The spirits cleanse the earth. The fox dances in the refreshing downpour.",
+    "Light rain": "Tears from the sky fall gently. The earth drinks quietly under the fox's watchful gaze.",
+    "Moderate rain": "A steady rhythm of water from the heavens. The foxes are singing to the rainfall.",
+    "Heavy rain": "The skies roar with watery fury. The kitsune seeks refuge until the storm passes.",
+    "Snow": "Glistening white dust falls from the heavens. The fox leaves delicate tracks in the fresh snow.",
+    "Light snow": "Tiny crystalline spirits dance down. The fox tries to catch them on its nose.",
+    "Heavy snow": "The world is buried in a deep, silent white slumber. The kitsune wanders through the frozen dream.",
+    "Thunderstorm": "The sky gods' drums beat fiercely! The fox's fur stands on end with electric energy.",
+    "Thundery outbreaks in nearby": "Distant rumblings echo. The spirits are restless, warning of a coming storm.",
+    "Thundery outbreaks possible": "Distant rumblings echo. The spirits are restless, warning of a coming storm.",
+    "Blowing snow": "The fierce winds scatter the frozen crystals like fleeing spirits.",
+    "Blizzard": "A terrible frozen tempest! The kitsune has long sought the safety of its den.",
+};
+const windDirections = {
+    "N": "North",
+    "NNE": "North-Northeast",
+    "NE": "Northeast",
+    "ENE": "East-Northeast",
+    "E": "East",
+    "ESE": "East-Southeast",
+    "SE": "Southeast",
+    "SSE": "South-Southeast",
+    "S": "South",
+    "SSW": "South-Southwest",
+    "SW": "Southwest",
+    "WSW": "West-Southwest",
+    "W": "West",
+    "WNW": "West-Northwest",
+    "NW": "Northwest",
+    "NNW": "North-Northwest"
+};
+class Weather {
+    constructor(program) {
+        this.kitsune = `
+        /\\_/\\
+      =( °w° )=
+        )   ( 
+       (__ __)
+    `;
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("weather [location] [speak]")
+            .description("Read the winds and skies for any location")
+            .action((location, speak) => this.readWinds(location, speak));
+    }
+    async readWinds(locationArg, speakArg) {
+        var _a, _b;
+        let location = locationArg;
+        let speak = false;
+        if (locationArg === "speak") {
+            location = "";
+            speak = true;
+        }
+        else if (speakArg === "speak") {
+            speak = true;
+        }
+        console.log(gradient_string_1.default.pastel(this.kitsune));
+        console.log(chalk_1.default.cyan("\n☁️  THE SPIRIT READS THE WINDS ☁️\n"));
+        const spinner = (0, ora_1.default)({
+            text: chalk_1.default.blue("🦊 The Kitsune is seeking the weather signs..."),
+            spinner: "dots",
+        }).start();
+        try {
+            const query = location ? encodeURIComponent(location) : "";
+            const res = await fetch(`https://wttr.in/${query}?format=j1`);
+            if (!res.ok) {
+                throw new Error("The winds are obscured.");
+            }
+            const data = await res.json();
+            spinner.stop();
+            const current = data.current_condition[0];
+            const area = data.nearest_area[0].areaName[0].value;
+            const temp = current.temp_C;
+            const desc = current.weatherDesc[0].value;
+            const windDirCode = current.winddir16Point;
+            const windDir = (_a = windDirections[windDirCode]) !== null && _a !== void 0 ? _a : windDirCode;
+            const windSpeed = current.windspeedKmph;
+            const reply = (_b = weatherReplies[desc]) !== null && _b !== void 0 ? _b : "The fox peers at the sky, but the spirits reveal nothing familiar.";
+            const mysticalWeather = `The winds over ${chalk_1.default.yellow(area)} reveal ${chalk_1.default.magenta(desc.toLowerCase())}. \n${chalk_1.default.italic(reply)}\n\nStill, feel the air at ${chalk_1.default.green(temp + '°C')}, as the winds from the ${chalk_1.default.cyan(windDir)} travels at ${chalk_1.default.cyan(windSpeed + ' km/h')}.`;
+            const spokenText = `The winds over ${area} reveal ${desc.toLowerCase()}. ${reply} Still, feel the air at ${temp} degrees Celsius, as the winds from the ${windDir} travels at ${windSpeed} kilometers per hour.`;
+            console.log((0, boxen_1.default)(mysticalWeather, {
+                padding: 1,
+                borderStyle: "round",
+                borderColor: "cyan",
+            }));
+            if (speak) {
+                say_1.default.speak(spokenText, "Kyoko");
+            }
+        }
+        catch (error) {
+            spinner.stop();
+            console.log(chalk_1.default.red("🌪️  The spirit could not discern the weather at this time."));
+        }
+    }
+}
+exports.default = Weather;

package/dist/commands/wordel.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const ora_1 = __importDefault(require("ora"));
+const boxen_1 = __importDefault(require("boxen"));
+const readline_1 = __importDefault(require("readline"));
+const fox = `
+        /\\_/\\
+      =( °w° )=
+        )   (
+       (__ __)
+`;
+class Wordel {
+    constructor(program) {
+        this.program = program;
+    }
+    register() {
+        this.program
+            .command("wordel [wordlength]")
+            .description("Play a game of Wordel")
+            .action((wordlength) => this.playWordel(wordlength));
+    }
+    async playWordel(wordlength) {
+        let length = wordlength !== null && wordlength !== void 0 ? wordlength : 5;
+        if (isNaN(length) || length < 3 || length > 8) {
+            console.log(chalk_1.default.yellow(`⚠ Word length must be between 3 and 8. Defaulting to 5.`));
+            length = 5;
+        }
+        console.log(gradient_string_1.default.cristal(fox));
+        console.log(chalk_1.default.italic.magentaBright(`  ✦ Now the ancient game of Wordel begins... ✦\n`));
+        console.log((0, boxen_1.default)(gradient_string_1.default.pastel(`  W O R D E L  \n`) +
+            chalk_1.default.gray(`  Guess the ${length}-letter word in 6 tries`), { padding: 1, borderStyle: "round", borderColor: "cyan" }));
+        const spinner = (0, ora_1.default)("Fetching a secret word...").start();
+        let secret;
+        try {
+            const res = await fetch(`https://random-word-api.herokuapp.com/word?length=${length}`);
+            const data = await res.json();
+            secret = data[0].toUpperCase();
+            spinner.succeed(chalk_1.default.green("Secret word ready!"));
+        }
+        catch {
+            spinner.fail(chalk_1.default.red("Failed to fetch word. Check your connection."));
+            return;
+        }
+        const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        const ask = (q) => new Promise((r) => rl.question(q, r));
+        const history = [];
+        for (let attempt = 1; attempt <= 6; attempt++) {
+            console.log(chalk_1.default.dim(`\nAttempt ${attempt}/6`));
+            let guess = "";
+            while (true) {
+                guess = (await ask(chalk_1.default.cyan(`Enter a ${length}-letter word: `))).trim().toUpperCase();
+                if (guess.length !== length) {
+                    console.log(chalk_1.default.red(`Must be exactly ${length} letters.`));
+                    continue;
+                }
+                const valSpinner = (0, ora_1.default)("Validating word...").start();
+                try {
+                    const res = await fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${guess.toLowerCase()}`);
+                    if (res.ok) {
+                        valSpinner.succeed(chalk_1.default.green("Valid word!"));
+                        break;
+                    }
+                    else {
+                        valSpinner.fail(chalk_1.default.red("Not a valid word. Try again."));
+                    }
+                }
+                catch {
+                    valSpinner.warn(chalk_1.default.yellow("Could not validate — accepting anyway."));
+                    break;
+                }
+            }
+            const row = this.buildRow(guess, secret);
+            history.forEach((r) => console.log(r));
+            console.log(row);
+            history.push(row);
+            if (guess === secret) {
+                console.log((0, boxen_1.default)(gradient_string_1.default.rainbow(`🎉  You got it in ${attempt}!`), { padding: 1, borderColor: "green", borderStyle: "double" }));
+                rl.close();
+                return;
+            }
+        }
+        console.log((0, boxen_1.default)(chalk_1.default.red(`💀  Out of attempts!\nThe word was: `) + chalk_1.default.bold.white(secret), { padding: 1, borderColor: "red", borderStyle: "round" }));
+        rl.close();
+    }
+    buildRow(guess, secret) {
+        return guess
+            .split("")
+            .map((ch, i) => {
+            if (ch === secret[i])
+                return chalk_1.default.bgGreen.black(` ${ch} `);
+            if (secret.includes(ch))
+                return chalk_1.default.bgYellow.black(` ${ch} `);
+            return chalk_1.default.bgGray.white(` ${ch} `);
+        })
+            .join(" ");
+    }
+}
+exports.default = Wordel;

package/dist/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_engin_1 = __importDefault(require("./cli_engin/cli_engin"));
+const speak_1 = __importDefault(require("./commands/speak"));
+const help_1 = __importDefault(require("./commands/help"));
+const spirit_1 = __importDefault(require("./commands/spirit"));
+const loud_1 = __importDefault(require("./commands/loud"));
+const wordel_1 = __importDefault(require("./commands/wordel"));
+const riddle_1 = __importDefault(require("./commands/riddle"));
+const joke_1 = __importDefault(require("./commands/joke"));
+const weather_1 = __importDefault(require("./commands/weather"));
+const init_1 = __importDefault(require("./commands/init"));
+const cli = new cli_engin_1.default();
+cli.registerCommand([speak_1.default, help_1.default, spirit_1.default, loud_1.default, wordel_1.default, riddle_1.default, joke_1.default, weather_1.default, init_1.default]);
+cli.run();

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "kitsune-cli",
+  "version": "1.0.0",
+  "description": "A magical Fox Spirit CLI tool offering wisdom, jokes, riddles, weather, and more.",
+  "main": "dist/index.js",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "prepare": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bhavish-codes/Kitsune-cli.git"
+  },
+  "keywords": [
+    "cli",
+    "kitsune",
+    "fox",
+    "spirit",
+    "weather",
+    "riddle",
+    "joke"
+  ],
+  "author": "bhavish dhar",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/bhavish-codes/Kitsune-cli/issues"
+  },
+  "homepage": "https://github.com/bhavish-codes/Kitsune-cli#readme",
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "nodemon": "^3.1.14",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "bin": {
+    "kit": "dist/index.js"
+  },
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "figlet": "^1.10.0",
+    "gradient-string": "^3.0.0",
+    "ora": "^9.3.0",
+    "say": "^0.16.0"
+  }
+}