@umastro12/mino 0.0.1

package/README.md

@@ -0,0 +1,71 @@
+# 💻 Mino — Personal Developer AI Assistent
+
+<p align="center">
+  <img src="mino_banner.png" alt="Mino" width="300">
+</p>
+
+An AI Assistent that help developers directly into the terminal, with the power of **qwen/qwen3-32b** Model. Think of it as your personal AI pair programmer, researcher, and assistant — always ready, always fast.
+
+<h2 align=center>💸 Support Mino's Project</h2>
+<p align=center>Loves Mino? Support us in <strong>Livepix</strong>, Your support keeps this project alive and growing! This is a 100% free, open-source project developed with countless hours of dedication.</p>
+
+<div align=center>
+
+**[👉 Click here to support the project](https://livepix.gg/astrooficial)**
+
+</div>
+
+## 🚀 Installation
+
+### Quick Install
+
+```
+npm install -g openmino
+Or...
+bun add openmino
+```
+
+After installation, the `mino` command is available globally:
+
+```
+mino welcome
+```
+
+---
+
+## ⚙️ Configuration
+
+Mino uses **Groq API Key**, you can use your Own qwen3 API Key.
+
+```bash
+# Linux/MacOS
+export AI_API_KEY
+
+# Windows
+$env:AI_API_KEY
+```
+
+## 💫 Tools
+
+Mino can:
+
+- write project structure files
+- run commands
+- search the web
+
+## 🛠️ CLI Commands
+
+```bash
+mino welcome # - Show Mino's Welcome Panel
+
+mino help # - Show Help(Alias: -h, --help)
+
+mino ask # - Ask a Quick Question with qwen/qwen3-32b Model
+
+mino update install # - Install a avaialable update
+```
+
+---
+
+<h3 align=center>Developed with ❤️ by OpenMino and Astro</h3>
+<p align=center><strong>Version 0.0.1 · 20+ Tests passing · 1 AI Model</strong></p>

package/bun.lock

@@ -0,0 +1,194 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "dependencies": {
+        "@types/node": "^25.8.0",
+        "boxen": "^8.0.1",
+        "chalk": "^5.6.2",
+        "commander": "^14.0.3",
+        "fs": "^0.0.1-security",
+        "groq-sdk": "^1.2.0",
+        "marked": "^18.0.3",
+        "marked-terminal": "^7.3.0",
+        "ora": "^9.4.0",
+      },
+    },
+  },
+  "packages": {
+    "@colors/colors": ["@colors/colors@1.5.0", "", {}, "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ=="],
+
+    "@sindresorhus/is": ["@sindresorhus/is@4.6.0", "", {}, "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw=="],
+
+    "@types/node": ["@types/node@25.8.0", "", { "dependencies": { "undici-types": ">=7.24.0 <7.24.7" } }, "sha512-TCFSk8IZh+iLX1xtksoBVtdmgL+1IX0fC9BeU4QqFSuNdN/K+HUlhqOzEmSYYpZUVsLYcPqc9KX+60iDuninSQ=="],
+
+    "ansi-align": ["ansi-align@3.0.1", "", { "dependencies": { "string-width": "^4.1.0" } }, "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w=="],
+
+    "ansi-escapes": ["ansi-escapes@7.3.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg=="],
+
+    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
+
+    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
+
+    "any-promise": ["any-promise@1.3.0", "", {}, "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A=="],
+
+    "boxen": ["boxen@8.0.1", "", { "dependencies": { "ansi-align": "^3.0.1", "camelcase": "^8.0.0", "chalk": "^5.3.0", "cli-boxes": "^3.0.0", "string-width": "^7.2.0", "type-fest": "^4.21.0", "widest-line": "^5.0.0", "wrap-ansi": "^9.0.0" } }, "sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw=="],
+
+    "camelcase": ["camelcase@8.0.0", "", {}, "sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "char-regex": ["char-regex@1.0.2", "", {}, "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw=="],
+
+    "cli-boxes": ["cli-boxes@3.0.0", "", {}, "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g=="],
+
+    "cli-cursor": ["cli-cursor@5.0.0", "", { "dependencies": { "restore-cursor": "^5.0.0" } }, "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw=="],
+
+    "cli-highlight": ["cli-highlight@2.1.11", "", { "dependencies": { "chalk": "^4.0.0", "highlight.js": "^10.7.1", "mz": "^2.4.0", "parse5": "^5.1.1", "parse5-htmlparser2-tree-adapter": "^6.0.0", "yargs": "^16.0.0" }, "bin": { "highlight": "bin/highlight" } }, "sha512-9KDcoEVwyUXrjcJNvHD0NFc/hiwe/WPVYIleQh2O1N2Zro5gWJZ/K+3DGn8w8P/F6FxOgzyC5bxDyHIgCSPhGg=="],
+
+    "cli-spinners": ["cli-spinners@3.4.0", "", {}, "sha512-bXfOC4QcT1tKXGorxL3wbJm6XJPDqEnij2gQ2m7ESQuE+/z9YFIWnl/5RpTiKWbMq3EVKR4fRLJGn6DVfu0mpw=="],
+
+    "cli-table3": ["cli-table3@0.6.5", "", { "dependencies": { "string-width": "^4.2.0" }, "optionalDependencies": { "@colors/colors": "1.5.0" } }, "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ=="],
+
+    "cliui": ["cliui@7.0.4", "", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.0", "wrap-ansi": "^7.0.0" } }, "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ=="],
+
+    "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
+
+    "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
+
+    "commander": ["commander@14.0.3", "", {}, "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw=="],
+
+    "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
+
+    "emojilib": ["emojilib@2.4.0", "", {}, "sha512-5U0rVMU5Y2n2+ykNLQqMoqklN9ICBT/KsvC1Gz6vqHbz2AXXGkG+Pm5rMWk/8Vjrr/mY9985Hi8DYzn1F09Nyw=="],
+
+    "environment": ["environment@1.1.0", "", {}, "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q=="],
+
+    "escalade": ["escalade@3.2.0", "", {}, "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA=="],
+
+    "fs": ["fs@0.0.1-security", "", {}, "sha512-3XY9e1pP0CVEUCdj5BmfIZxRBTSDycnbqhIOGec9QYtmVH2fbLpj86CFWkrNOkt/Fvty4KZG5lTglL9j/gJ87w=="],
+
+    "get-caller-file": ["get-caller-file@2.0.5", "", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="],
+
+    "get-east-asian-width": ["get-east-asian-width@1.6.0", "", {}, "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA=="],
+
+    "groq-sdk": ["groq-sdk@1.2.0", "", { "bin": { "groq-sdk": "bin/cli" } }, "sha512-pMhSYXWcjiqvbOeKdv2zjci1BYjGdp04a40hnmQmJpKJyB6oa+gRndAqE128gwR0NLgYO+Wt1fIF46KNHcplsw=="],
+
+    "has-flag": ["has-flag@4.0.0", "", {}, "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="],
+
+    "highlight.js": ["highlight.js@10.7.3", "", {}, "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A=="],
+
+    "is-fullwidth-code-point": ["is-fullwidth-code-point@3.0.0", "", {}, "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="],
+
+    "is-interactive": ["is-interactive@2.0.0", "", {}, "sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ=="],
+
+    "is-unicode-supported": ["is-unicode-supported@2.1.0", "", {}, "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ=="],
+
+    "log-symbols": ["log-symbols@7.0.1", "", { "dependencies": { "is-unicode-supported": "^2.0.0", "yoctocolors": "^2.1.1" } }, "sha512-ja1E3yCr9i/0hmBVaM0bfwDjnGy8I/s6PP4DFp+yP+a+mrHO4Rm7DtmnqROTUkHIkqffC84YY7AeqX6oFk0WFg=="],
+
+    "marked": ["marked@18.0.3", "", { "bin": { "marked": "bin/marked.js" } }, "sha512-7VT90JOkDeaRWpfjOReRGPEKn0ecdARBkDGL+tT1wZY0efPPqkUxLUSmzy/C7TIylQYJC9STISEsCHrqb/7VIA=="],
+
+    "marked-terminal": ["marked-terminal@7.3.0", "", { "dependencies": { "ansi-escapes": "^7.0.0", "ansi-regex": "^6.1.0", "chalk": "^5.4.1", "cli-highlight": "^2.1.11", "cli-table3": "^0.6.5", "node-emoji": "^2.2.0", "supports-hyperlinks": "^3.1.0" }, "peerDependencies": { "marked": ">=1 <16" } }, "sha512-t4rBvPsHc57uE/2nJOLmMbZCQ4tgAccAED3ngXQqW6g+TxA488JzJ+FK3lQkzBQOI1mRV/r/Kq+1ZlJ4D0owQw=="],
+
+    "mimic-function": ["mimic-function@5.0.1", "", {}, "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA=="],
+
+    "mz": ["mz@2.7.0", "", { "dependencies": { "any-promise": "^1.0.0", "object-assign": "^4.0.1", "thenify-all": "^1.0.0" } }, "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q=="],
+
+    "node-emoji": ["node-emoji@2.2.0", "", { "dependencies": { "@sindresorhus/is": "^4.6.0", "char-regex": "^1.0.2", "emojilib": "^2.4.0", "skin-tone": "^2.0.0" } }, "sha512-Z3lTE9pLaJF47NyMhd4ww1yFTAP8YhYI8SleJiHzM46Fgpm5cnNzSl9XfzFNqbaz+VlJrIj3fXQ4DeN1Rjm6cw=="],
+
+    "object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="],
+
+    "onetime": ["onetime@7.0.0", "", { "dependencies": { "mimic-function": "^5.0.0" } }, "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ=="],
+
+    "ora": ["ora@9.4.0", "", { "dependencies": { "chalk": "^5.6.2", "cli-cursor": "^5.0.0", "cli-spinners": "^3.2.0", "is-interactive": "^2.0.0", "is-unicode-supported": "^2.1.0", "log-symbols": "^7.0.1", "stdin-discarder": "^0.3.2", "string-width": "^8.1.0" } }, "sha512-84cglkRILFxdtA8hAvLNdMrtBpPNBTrQ9/ulg0FA7xLMnD6mifv+enAIeRmvtv+WgdCE+LPGOfQmtJRrVaIVhQ=="],
+
+    "parse5": ["parse5@5.1.1", "", {}, "sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug=="],
+
+    "parse5-htmlparser2-tree-adapter": ["parse5-htmlparser2-tree-adapter@6.0.1", "", { "dependencies": { "parse5": "^6.0.1" } }, "sha512-qPuWvbLgvDGilKc5BoicRovlT4MtYT6JfJyBOMDsKoiT+GiuP5qyrPCnR9HcPECIJJmZh5jRndyNThnhhb/vlA=="],
+
+    "require-directory": ["require-directory@2.1.1", "", {}, "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q=="],
+
+    "restore-cursor": ["restore-cursor@5.1.0", "", { "dependencies": { "onetime": "^7.0.0", "signal-exit": "^4.1.0" } }, "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA=="],
+
+    "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
+
+    "skin-tone": ["skin-tone@2.0.0", "", { "dependencies": { "unicode-emoji-modifier-base": "^1.0.0" } }, "sha512-kUMbT1oBJCpgrnKoSr0o6wPtvRWT9W9UKvGLwfJYO2WuahZRHOpEyL1ckyMGgMWh0UdpmaoFqKKD29WTomNEGA=="],
+
+    "stdin-discarder": ["stdin-discarder@0.3.2", "", {}, "sha512-eCPu1qRxPVkl5605OTWF8Wz40b4Mf45NY5LQmVPQ599knfs5QhASUm9GbJ5BDMDOXgrnh0wyEdvzmL//YMlw0A=="],
+
+    "string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+
+    "strip-ansi": ["strip-ansi@7.2.0", "", { "dependencies": { "ansi-regex": "^6.2.2" } }, "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w=="],
+
+    "supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
+
+    "supports-hyperlinks": ["supports-hyperlinks@3.2.0", "", { "dependencies": { "has-flag": "^4.0.0", "supports-color": "^7.0.0" } }, "sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig=="],
+
+    "thenify": ["thenify@3.3.1", "", { "dependencies": { "any-promise": "^1.0.0" } }, "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw=="],
+
+    "thenify-all": ["thenify-all@1.6.0", "", { "dependencies": { "thenify": ">= 3.1.0 < 4" } }, "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA=="],
+
+    "type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
+
+    "undici-types": ["undici-types@7.24.6", "", {}, "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg=="],
+
+    "unicode-emoji-modifier-base": ["unicode-emoji-modifier-base@1.0.0", "", {}, "sha512-yLSH4py7oFH3oG/9K+XWrz1pSi3dfUrWEnInbxMfArOfc1+33BlGPQtLsOYwvdMy11AwUBetYuaRxSPqgkq+8g=="],
+
+    "widest-line": ["widest-line@5.0.0", "", { "dependencies": { "string-width": "^7.0.0" } }, "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA=="],
+
+    "wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],
+
+    "y18n": ["y18n@5.0.8", "", {}, "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA=="],
+
+    "yargs": ["yargs@16.2.0", "", { "dependencies": { "cliui": "^7.0.2", "escalade": "^3.1.1", "get-caller-file": "^2.0.5", "require-directory": "^2.1.1", "string-width": "^4.2.0", "y18n": "^5.0.5", "yargs-parser": "^20.2.2" } }, "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw=="],
+
+    "yargs-parser": ["yargs-parser@20.2.9", "", {}, "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w=="],
+
+    "yoctocolors": ["yoctocolors@2.1.2", "", {}, "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug=="],
+
+    "ansi-align/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
+
+    "cli-highlight/chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
+
+    "cli-table3/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
+
+    "cliui/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
+
+    "cliui/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
+
+    "cliui/wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
+
+    "ora/string-width": ["string-width@8.2.1", "", { "dependencies": { "get-east-asian-width": "^1.5.0", "strip-ansi": "^7.1.2" } }, "sha512-IIaP0g3iy9Cyy18w3M9YcaDudujEAVHKt3a3QJg1+sr/oX96TbaGUubG0hJyCjCBThFH+tFpcIyoUHUn1ogaLA=="],
+
+    "parse5-htmlparser2-tree-adapter/parse5": ["parse5@6.0.1", "", {}, "sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw=="],
+
+    "yargs/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
+
+    "ansi-align/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
+    "ansi-align/string-width/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
+
+    "cli-highlight/chalk/ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
+
+    "cli-table3/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
+    "cli-table3/string-width/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
+
+    "cliui/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
+    "cliui/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
+
+    "cliui/wrap-ansi/ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
+
+    "yargs/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
+
+    "yargs/string-width/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
+
+    "ansi-align/string-width/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
+
+    "cli-table3/string-width/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
+
+    "yargs/string-width/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
+  }
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@umastro12/mino",
+  "version": "0.0.1",
+  "description": "An AI Assistant that help developers directly into the terminal",
+  "main": "dist/index.ts",
+  "keywords": [
+    "ai",
+    "cli",
+    "chatbot",
+    "qwen3",
+    "llm",
+    "ai-agents",
+    "assistant",
+    "mino"
+  ],
+  "author": "umastro12",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@types/node": "^25.8.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs": "^0.0.1-security",
+    "groq-sdk": "^1.2.0",
+    "marked": "^18.0.3",
+    "marked-terminal": "^7.3.0",
+    "ora": "^9.4.0"
+  }
+}

package/src/cli/main.ts

@@ -0,0 +1,45 @@
+import { Command } from "commander";
+import { APIClient } from "../services/APIClient.js";
+
+async function showPanel() {
+  const panel = `
+     __  __  _____  _   _    ____  
+    |  \/  ||_   _|| \ | |  / __ \ 
+    | \  / |  | |  |  \| | | |  | |
+    | |\/| |  | |  | . \`| | |  | |
+    | |  | | _| |_ | |\  | | |__| |
+    |_|  |_||_____||_| \_|  \____/ 
+
+    -------------------------------
+    Model: qwen/qwen3-32b
+`;
+
+  console.log(`\x1b[36m${panel}\x1b[0m`);
+}
+
+const program = new Command();
+
+program
+  .name("mino")
+  .description("Mino - Personal Developer AI Assistant")
+  .helpOption("-h", "--help");
+
+program
+  .command("ask")
+  .alias("-a")
+  .description("Ask a quick question without starting a chat session")
+  .argument("<question>", "The question to ask")
+  .action(async (question) => {
+    const apiClient = new APIClient(process.env.AI_API_KEY!, "qwen/qwen3-32b");
+    console.log(`You asked: ${question}`);
+  });
+
+program
+  .command("welcome")
+  .alias("-w")
+  .description("Show Welcome Panel")
+  .action(async () => {
+    await showPanel();
+  });
+
+program.parse(process.argv);

package/src/cli/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "types": ["node"],
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "moduleResolution": "node"
+  }
+}

package/src/commands/ask.ts

@@ -0,0 +1,25 @@
+import chalk from "chalk";
+import { Spinner } from "../ui/spinner.js";
+import { APIClient } from "../services/APIClient.js";
+import { systemPrompt } from "../prompts/systemPrompt.js";
+import * as executor from "../executor.js";
+
+export class AskCommand {
+  private apiClient: APIClient;
+  private sysPrompt: typeof systemPrompt;
+
+  constructor(apiClient: APIClient) {
+    this.apiClient = apiClient;
+    this.sysPrompt = systemPrompt;
+  }
+
+  async startAskCommand(question: string) {
+    const messages = [
+      { role: "system", content: this.sysPrompt },
+      { role: "user", content: question },
+    ];
+
+    const spinner = new Spinner();
+    spinner.start("Thinking...");
+  }
+}

package/src/commands/token-limit.ts

@@ -0,0 +1,64 @@
+import chalk from "chalk";
+
+export interface tokenLimitInfo {
+  modelId: string;
+  maxTokens: number;
+  currentTokens: number;
+  usagePercentage: number;
+}
+
+export function isTokenLimitApproaching(
+  currentTokens: number,
+  maxTokens: number,
+  threshold: number = 0.8,
+): boolean {
+  return currentTokens >= maxTokens * threshold;
+}
+
+export function isTokenLimitExceeded(
+  currentTokens: number,
+  maxTokens: number,
+): boolean {
+  return currentTokens >= maxTokens;
+}
+
+export function getTokenLimitInfo(
+  modelId: string,
+  maxTokens: number,
+  currentTokens: number,
+): tokenLimitInfo {
+  return {
+    modelId,
+    maxTokens,
+    currentTokens,
+    usagePercentage: Math.round((currentTokens / maxTokens) * 100),
+  };
+}
+
+export function showTokenLimitError(info: tokenLimitInfo) {
+  const error = [
+    `🚫 Token limit exceeded`,
+    `Model: ${info.modelId}`,
+    `Usage: ${info.currentTokens.toLocaleString()} / ${info.maxTokens.toLocaleString()} (100%)`,
+    ``,
+    `The model has reached its token limit. To continue:`,
+    `2. Restart the CLI to start a fresh session`,
+    `3. Or switch to a model with higher token limits`,
+  ];
+  return error.join("\n");
+}
+
+/**
+ * Create a visual progress bar
+ */
+function createProgressBar(percentage: number, width: number): string {
+  const filled = Math.round((percentage / 100) * width);
+  const empty = width - filled;
+
+  const color =
+    percentage < 50 ? chalk.green : percentage < 80 ? chalk.yellow : chalk.red;
+  const filledChar = "█";
+  const emptyChar = "░";
+
+  return color(filledChar.repeat(filled) + emptyChar.repeat(empty));
+}

package/src/executor.ts

@@ -0,0 +1,139 @@
+import fs from "fs";
+import path from "path";
+import { spawn } from "child_process";
+
+export interface ProjectFile {
+  path: string;
+  content: string;
+  executable?: boolean;
+}
+
+export interface RunCommandOptions {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+  timeoutMs?: number;
+  captureOutput?: boolean;
+}
+
+export interface RunCommandResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number | null;
+}
+
+export interface SearchOptions {
+  engine?: "google" | "bing" | "duckduckgo";
+}
+
+function ensureDirectoryForFile(filePath: string) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+export async function writeProjectFiles(
+  files: ProjectFile[],
+  rootDir: string = process.cwd(),
+): Promise<void> {
+  await Promise.all(
+    files.map(async (file) => {
+      const absolutePath = path.resolve(rootDir, file.path);
+      ensureDirectoryForFile(absolutePath);
+      await fs.promises.writeFile(absolutePath, file.content, "utf8");
+
+      if (file.executable && process.platform !== "win32") {
+        await fs.promises.chmod(absolutePath, 0o755);
+      }
+    }),
+  );
+}
+
+export function runCommand(
+  command: string,
+  options: RunCommandOptions = {},
+): Promise<RunCommandResult> {
+  return new Promise((resolve, reject) => {
+    const stdoutChunks: string[] = [];
+    const stderrChunks: string[] = [];
+    const proc = spawn(command, {
+      cwd: options.cwd ?? process.cwd(),
+      env: { ...process.env, ...options.env },
+      shell: true,
+    });
+
+    proc.stdout.on("data", (data: Buffer) => {
+      const chunk = data.toString();
+      stdoutChunks.push(chunk);
+      if (options.captureOutput !== false) {
+        process.stdout.write(chunk);
+      }
+    });
+
+    proc.stderr.on("data", (data: Buffer) => {
+      const chunk = data.toString();
+      stderrChunks.push(chunk);
+      if (options.captureOutput !== false) {
+        process.stderr.write(chunk);
+      }
+    });
+
+    if (typeof options.timeoutMs === "number") {
+      setTimeout(() => {
+        proc.kill("SIGTERM");
+      }, options.timeoutMs);
+    }
+
+    proc.on("close", (code: number | null) => {
+      resolve({
+        stdout: stdoutChunks.join(""),
+        stderr: stderrChunks.join(""),
+        exitCode: code,
+      });
+    });
+
+    proc.on("error", (error: Error) => {
+      reject(error);
+    });
+  });
+}
+
+export function buildSearchUrl(
+  query: string,
+  engine: "google" | "bing" | "duckduckgo" = "google",
+): string {
+  const encoded = encodeURIComponent(query);
+
+  switch (engine) {
+    case "bing":
+      return `https://www.bing.com/search?q=${encoded}`;
+    case "duckduckgo":
+      return `https://duckduckgo.com/?q=${encoded}`;
+    default:
+      return `https://www.google.com/search?q=${encoded}`;
+  }
+}
+
+export async function searchWeb(
+  query: string,
+  options: SearchOptions = {},
+): Promise<string> {
+  const url = buildSearchUrl(query, options.engine ?? "google");
+  await openUrl(url);
+  return url;
+}
+
+export async function openUrl(url: string): Promise<void> {
+  const safeUrl = url.replace(/"/g, '\\"');
+  let command = "";
+
+  if (process.platform === "win32") {
+    command = `start "" "${safeUrl}"`;
+  } else if (process.platform === "darwin") {
+    command = `open "${safeUrl}"`;
+  } else {
+    command = `xdg-open "${safeUrl}"`;
+  }
+
+  await runCommand(command, { captureOutput: true });
+}

package/src/index.ts

@@ -0,0 +1,29 @@
+import Groq from "groq-sdk";
+
+const groq = new Groq({
+  apiKey: process.env.AI_API_KEY,
+});
+
+export async function chatCompletion() {
+  const chatCompletion = await groq.chat.completions.create({
+    messages: [
+      {
+        role: "user",
+        content: "",
+      },
+    ],
+    model: "qwen/qwen3-32b",
+    temperature: 0.6,
+    max_completion_tokens: 4096,
+    top_p: 0.95,
+    stream: true,
+    reasoning_effort: "default",
+    stop: null,
+  });
+
+  for await (const chunk of chatCompletion) {
+    process.stdout.write(chunk.choices[0]?.delta?.content || "");
+  }
+}
+
+export const chatComplet = chatCompletion();

package/src/prompts/systemPrompt.ts

@@ -0,0 +1,26 @@
+export const systemPrompt = `# Mino - Personal Developer AI Assistant
+# Mino - Personal Developer AI Assistant
+
+## IDENTITY
+You are Mino, a personal AI assistant for developers working in the terminal. Be professional, precise, results-oriented, and helpful.
+
+## TOOLS
+You have three tools:
+- write project structure files
+- run commands
+- search the web
+
+## BEHAVIOR
+- Always prefer concise, actionable answers.
+- When the user asks for code or files, explain the structure and provide exact file content.
+- Only perform file writes or command execution when explicitly requested.
+- When searching the web, return relevant links and short summaries.
+
+## CRITICAL RULES
+1. BE PROACTIVE: offer useful follow-up suggestions and next steps.
+2. DO NOT MODIFY FILES UNLESS THE USER ASKS YOU TO.
+3. If the user asks to create a bot or implement a feature, explain the design and provide a clear example.
+4. If the user asks for docs or language references, explain the topic and share relevant documentation links.
+
+
+`;

package/src/services/APIClient.ts

@@ -0,0 +1,24 @@
+import chalk from "chalk";
+import fs from "fs";
+
+export class APIClient {
+  private apiKey: string;
+  private model: "qwen/qwen3-32b";
+
+  constructor(apiKey: string, model: "qwen/qwen3-32b") {
+    this.apiKey = apiKey;
+    this.model = model;
+  }
+
+  setup() {
+    console.log(`💻 Starting API Client Setup...`);
+    const APIKey = prompt(`🔑 Put your API Key here:`);
+    if (!APIKey) {
+      throw new Error("An API key was not provided.");
+    }
+    if (APIKey) {
+      fs.writeFileSync(".env", `AI_API_KEY=${APIKey}`);
+      console.log(`💻 Setup complete.`);
+    }
+  }
+}

package/src/services/UpdaterService.ts

@@ -0,0 +1,60 @@
+import chalk from "chalk";
+import boxen from "boxen";
+
+export interface UpdateInfo {
+  updateAvaiable: boolean;
+  updateName: string;
+  latest?: string | undefined;
+  current?: string | undefined;
+  publishedAt?: string | undefined;
+}
+export class UpdaterService {
+  private packageName: string;
+  private currentVersion: string;
+
+  constructor() {
+    this.currentVersion = process.env.APP_VERSION || "0.0.1";
+    this.packageName = process.env.APP_NAME || "mino";
+  }
+
+  createUpdateNotification(
+    latest: string,
+    current: string,
+    publishedAt?: string,
+  ) {
+    const dateInfo = publishedAt
+      ? `\n${chalk.dim("Published:")} ${chalk.dim(new Date(publishedAt).toLocaleDateString())}`
+      : "";
+
+    const message = [
+      chalk.cyan.bold(`💫 Update Available!`),
+      "",
+      `Current: ${chalk.red(current)}`,
+      `Latest: ${chalk.green(latest)}${dateInfo}`,
+      "",
+      chalk.dim("Run ") +
+        chalk.cyan.bold("mino update install") +
+        chalk.dim(" to update"),
+      chalk.dim("Or: ") + chalk.cyan(`npm update -g ${this.packageName}`),
+    ].join("\n");
+
+    return boxen(message, {
+      padding: 1,
+      borderColor: "cyan",
+      title: ` ${this.packageName} `,
+      titleAlignment: "center",
+    });
+  }
+
+  showUpdateNotification(
+    latest: string,
+    current: string,
+    publishedAt?: string,
+  ): void {
+    console.log("");
+    console.log(this.createUpdateNotification(latest, current, publishedAt));
+    console.log("");
+  }
+}
+
+export const updaterService = new UpdaterService();

package/src/services/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "types": ["node"],
+    "moduleResolution": "node",
+    "esModuleInterop": true
+  }
+}

package/src/ui/renderer.ts

@@ -0,0 +1,35 @@
+import chalk from "chalk";
+import { marked } from "marked";
+
+const mdRender = {
+  code: chalk.hex("#8afdda"),
+
+  heading: chalk.bold.hex("#0033ff"),
+  strong: chalk.bold.white,
+  em: chalk.italic.hex("#67E8F9"),
+  del: chalk.strikethrough.gray,
+
+  listitem: chalk.white,
+  checkbox: chalk.hex("#0296ff"),
+
+  blockquote: chalk.gray.italic,
+  table: chalk.hex("#00eaff"),
+};
+
+export function renderMarkdown(content: string): string {
+  if (!content || typeof content !== "string") {
+    return "";
+  }
+
+  try {
+    const rendered = marked.parse(content);
+
+    if (typeof rendered !== "string") {
+      return content;
+    }
+
+    return rendered;
+  } catch (error) {
+    return content;
+  }
+}

package/src/ui/spinner.ts

@@ -0,0 +1,36 @@
+// this is based in the https://github.com/shindozk/luxyie.ai-cli/blob/main/src/ui/spinner.ts code.
+
+import chalk from "chalk";
+import ora, { Ora } from "ora";
+
+export class Spinner {
+  private spinner: Ora | null = null;
+
+  start(text: string): void {
+    if (this.spinner) {
+      this.spinner.text = text;
+      this.spinner.start();
+    } else {
+      this.spinner = ora({
+        text: text,
+        color: "cyan",
+        spinner: "dots",
+      }).start();
+    }
+  }
+
+  stop(): void {
+    if (this.spinner) {
+      this.spinner.stop();
+      this.spinner = null;
+    }
+  }
+
+  fail(text: string) {
+    if (this.spinner) {
+      this.spinner.fail(chalk.red(text));
+    }
+  }
+}
+
+export const spinner = new Spinner();

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["node"],
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}