krims-code-cli 1.5.2__py3-none-any.whl

krims_code_cli-1.5.2.dist-info/METADATA

@@ -0,0 +1,336 @@
+Metadata-Version: 2.4
+Name: krims-code-cli
+Version: 1.5.2
+Summary: Krims Code AI — Universal AI Gateway CLI (Python Wrapper)
+Home-page: https://github.com/Krylo-60/krims-code-cli
+Author: Krishiv PB
+Author-email: krylobloxyt@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# Krims Code AI CLI
+
+> ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
+
+[![npm version](https://img.shields.io/npm/v/@krishivpb60/krims-code-cli.svg)](https://www.npmjs.com/package/@krishivpb60/krims-code-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-≥18.0.0-green.svg)](https://nodejs.org)
+
+```
+  ╔═══════════════════════════════════════════════════════════╗
+  ║     █████╗ ███████╗████████╗██╗  ██╗███████╗██████╗    ║
+  ║    ██╔══██╗██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗   ║
+  ║    ███████║█████╗     ██║   ████████║█████╗  ██████╔╝   ║
+  ║    ██╔══██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗   ║
+  ║    ██║  ██║███████╗   ██║   ██║  ██║███████╗██║  ██║   ║
+  ║    ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ║
+  ╚═══════════════════════════════════════════════════════════╝
+```
+
+**Krims Code AI v110** is a production-ready, globally installable command-line AI assistant that connects to **any AI provider in the world** — both free and paid. Chat with GPT-4o, Claude, Gemini, Llama, Mixtral, DeepSeek, and 50+ more models, all from one terminal.
+
+---
+
+## ✨ Features
+
+- 🌐 **13+ AI Providers** — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
+- 🆓 **Free Models Included** — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
+- 💬 **Interactive Chat** — Full terminal chat with slash commands, mode switching, and file attachments
+- ⚡ **Single-Shot Queries** — Quick one-off questions directly from the CLI
+- 🧠 **4 Reasoning Modes** — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
+- 📎 **File Context Injection** — Attach code files, logs, or documents for context-aware AI responses
+- 🤖 **Autopilot Debug Loop** — Automatically correct build/test failures using AI self-correcting feedback loop
+- 🌿 **Interactive Git TUI** — Beautiful cyberpunk ASCII branch tree commit history & interactive file staging checkbox menu
+- 📊 **Web HUD Dashboard** — Companion local zero-dependency telemetry dashboard displaying real-time latencies & provider status
+- 🎤 **Voice Microphone Input** — Record voice input directly from your terminal and transcribe it to text using Google Gemini or Whisper
+- 🔄 **Failover Mesh** — Automatic failback across all configured providers
+- 🔢 **Local Math Solver** — Evaluates mathematical expressions without an API call
+- 🤖 **Krylo Companion** — Offline cyberpunk companion bot when no API keys are configured
+- 🔐 **Your Keys, Your Control** — API keys stored locally on YOUR machine, never transmitted anywhere
+- 📤 **Export Conversations** — Save full chat history as Markdown files
+- 🎨 **Cyberpunk UI** — Neon colors, ASCII art, signal bars, and mode badges
+- 🎭 **4 Color Themes** — Cyberpunk, Matrix, Synthwave, Crimson — switch with `/theme`
+- ⌨️ **Custom Commands** — Create reusable prompt shortcuts with `/cmd add`
+- 📝 **File Creation** — AI can create files on your system with path override prompts
+- 📊 **Live Telemetry** — Real-time response latency & tokens/sec in the status bar
+- 🎮 **Mini-Game** — Built-in mainframe hacking game (`/game`)
+- 📋 **Clipboard Copy** — Copy last response to clipboard with `/copy`
+
+---
+
+## 🚀 Quick Start
+
+### Install globally via npm
+
+```bash
+npm install -g @krishivpb60/krims-code-cli
+```
+
+### Or run directly with npx
+
+```bash
+npx @krishivpb60/krims-code-cli chat
+```
+
+### Or install via pip (Python wrapper)
+
+```bash
+pip install krims-code-agent-cli
+# Run via terminal:
+Krims Code-pip chat
+```
+
+### Setup (Interactive Wizard)
+
+```bash
+Krims Code setup
+```
+
+The wizard walks you through configuring providers — **start with free ones!**
+
+### Or set keys manually
+
+```bash
+# Free providers (recommended to start)
+krims-code config set GROQ_API_KEY gsk_your_key_here
+krims-code config set GOOGLE_API_KEY AIza_your_key_here
+krims-code config set OPENROUTER_API_KEY sk-or-your_key_here
+
+# Paid providers
+krims-code config set OPENAI_API_KEY sk-your_key_here
+krims-code config set ANTHROPIC_API_KEY sk-ant-your_key_here
+```
+
+### Start chatting
+
+```bash
+Krims Code chat
+```
+
+### Quick one-shot query
+
+```bash
+Krims Code ask "Explain quantum computing in simple terms"
+```
+
+---
+
+## 📦 Supported Providers
+
+| Provider | Key | Free Tier | Default Model |
+|----------|-----|-----------|---------------|
+| **Groq** | `GROQ_API_KEY` | ✅ Generous | `llama-3.3-70b-versatile` |
+| **Together AI** | `TOGETHER_API_KEY` | ✅ Free credits | `Meta-Llama-3.1-70B-Instruct-Turbo` |
+| **Cerebras** | `CEREBRAS_API_KEY` | ✅ Free tier | `llama-3.3-70b` |
+| **OpenRouter** | `OPENROUTER_API_KEY` | ✅ Free models | `llama-3.1-70b-instruct:free` |
+| **Google Gemini** | `GOOGLE_API_KEY` | ✅ Free tier | `gemini-2.5-flash` |
+| **Cohere** | `COHERE_API_KEY` | ✅ Dev free | `command-r-plus` |
+| **Fireworks AI** | `FIREWORKS_API_KEY` | ✅ Free tier | `llama-v3p1-70b-instruct` |
+| **OpenAI** | `OPENAI_API_KEY` | 💳 Paid | `gpt-4o` |
+| **Anthropic** | `ANTHROPIC_API_KEY` | 💳 Paid | `claude-sonnet-4` |
+| **xAI** | `XAI_API_KEY` | 💳 Paid | `grok-2` |
+| **Mistral** | `MISTRAL_API_KEY` | 💳 Paid | `mistral-large-latest` |
+| **DeepSeek** | `DEEPSEEK_API_KEY` | 💳 Paid | `deepseek-chat` |
+| **Perplexity** | `PERPLEXITY_API_KEY` | 💳 Paid | `sonar` |
+
+> 💡 **Tip:** Start with **Groq** (fastest, free) or **Google Gemini** (most capable free tier). You can configure multiple providers and Krims Code will automatically failover between them!
+
+---
+
+## 🎮 Commands
+
+### Core Commands
+
+```bash
+Krims Code chat                    # Interactive chat session
+Krims Code ask "your question"     # Single-shot query
+Krims Code setup                   # Guided provider setup wizard
+```
+
+### Configuration
+
+```bash
+krims-code config set <KEY> <value>   # Set a config value
+krims-code config get <KEY>           # Get a config value
+krims-code config list                # List all config (keys masked)
+krims-code config delete <KEY>        # Delete a config key
+krims-code config reset               # Delete all config
+krims-code config path                # Show config file location
+```
+
+### Discovery
+
+```bash
+Krims Code providers               # List all 13+ supported providers
+Krims Code providers --free        # Show only free-tier providers
+Krims Code models                  # List all available models
+Krims Code models groq             # Models for a specific provider
+Krims Code modes                   # List reasoning modes
+Krims Code status                  # System status & active providers
+```
+
+### Flags
+
+```bash
+Krims Code ask "prompt" --mode research     # Use specific reasoning mode
+Krims Code ask "prompt" --file error.log    # Attach file context
+Krims Code ask "prompt" --model gpt-4o      # Override model
+Krims Code ask "prompt" --raw               # Raw text output (for piping)
+Krims Code chat --mode architect            # Start chat in specific mode
+```
+
+---
+
+## 💬 Chat Commands
+
+Inside interactive chat mode, use these slash commands:
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/mode <name>` | Switch reasoning mode (synthesis, research, architect, titan) |
+| `/modes` | List all modes with signal bars |
+| `/theme <name>` | Switch visual theme (cyberpunk, matrix, synthwave, crimson) |
+| `/themes` | List available color themes |
+| `/attach <file>` | Attach a file for context (supports Tab autocomplete!) |
+| `/files` | List attached files |
+| `/clear` | Clear terminal screen |
+| `/providers` | Show active providers |
+| `/export` | Export chat to Markdown |
+| `/copy` | Copy last response to clipboard |
+| `/write <file>` | Extract last code block and save to file |
+| `/cmd list` | List custom command shortcuts |
+| `/cmd add <name> <template>` | Create a custom command shortcut |
+| `/cmd remove <name>` | Delete a custom command |
+| `/game` | Start the mainframe hacking mini-game |
+| `/history` | List, switch, and resume past interactive chat sessions |
+| `/history-clear` | Clear saved persistent chat history |
+| `/autopilot <mode\|debug [cmd]>` | View/switch autopilot safety level or run autonomous debug loop |
+| `/git` | Launch interactive cyberpunk Git TUI and file stager checkbox menu |
+| `/github <status\|issues\|prs>` | Git/GitHub orchestration, auto-staging, semantic AI commit generation, and remote sync |
+| `/teamwork-preview` | Render real-time multi-agent matrix status dashboard with heartbeats & tasks |
+| `/dashboard` | Spawn zero-dependency local web server and launch telemetry dashboard HUD |
+| `/mic` | Record audio voice input from microphone and transcribe to text |
+| `/tokens` | View detailed session token usage and exchanges telemetry |
+| `/update` | Force check for updates and update Krims Code CLI manually |
+| `/review` | Run git diff and stream an AI code review |
+| `/diagnose [cmd]` | Run build/tests and AI-debug any errors |
+| `/explain <file>` | AI-explain the design and logic of a file |
+| `/refactor <file>` | AI-refactor the code of a target file |
+| `/bug <file>` | Scan a file to detect logical edge case failures |
+| `/doc <file>` | Write documentation, inline comments, or JSDoc |
+| `/translate <file> <lang>` | AI-translate file code into another target language |
+| `/exit` | End session |
+
+---
+
+## 🧠 Reasoning Modes
+
+| Mode | Layer | Style | Signal |
+|------|-------|-------|--------|
+| **Synthesis** | v2.5 | Balanced, clean, direct | ████████░░ 80% |
+| **Research** | v104 | Deep analysis, evidence-based | █████████░ 85% |
+| **Architect** | v55 | Systems thinking, debugging | █████████░ 90% |
+| **Titan Fusion** | v110 | Premium, maximum signal density | █████████░ 95% |
+
+---
+
+## 🔐 Security
+
+- **Your keys stay on YOUR machine** — stored at `~/.krims-code/config.json`
+- **No keys are bundled** in the package
+- **No telemetry** — zero data collection
+- **Keys are masked** when displayed (`krims-code config list`)
+- **Environment variables** also supported as fallback
+
+---
+
+## 🔄 Failover Mesh
+
+Krims Code routes your prompt through all configured providers automatically:
+
+```
+Your Prompt
+    ↓
+[Provider 1] → Success? → Response ✓
+    ↓ (fail)
+[Provider 2] → Success? → Response ✓
+    ↓ (fail)
+[Provider N] → Success? → Response ✓
+    ↓ (all fail)
+[Krylo Companion] → Local Response ✓
+```
+
+If a provider returns an error (rate limit, quota, etc.), Krims Code automatically tries the next one. Configure multiple free providers for maximum resilience!
+
+---
+
+## 📁 File Attachment
+
+Attach code files, logs, configs, or documents for context-aware responses:
+
+```bash
+# From CLI
+Krims Code ask "What's wrong with this code?" --file buggy.js
+
+# In chat mode
+/attach error.log
+What errors are in this file?
+```
+
+**Supported file types:** `.js`, `.ts`, `.py`, `.html`, `.css`, `.json`, `.md`, `.txt`, `.log`, `.yaml`, `.xml`, `.toml`, `.sql`, `.go`, `.rs`, `.java`, `.c`, `.cpp`, `.rb`, `.php`, `.swift`, `.kt`, `.dart`, `.vue`, `.svelte`, `.sh`, `.bat`, `.ps1`, `.env`, `.csv`
+
+---
+
+## 🏗️ Development
+
+```bash
+# Clone the repo
+git clone https://github.com/Krylo-60/krims-code-cli.git
+cd krims-code-cli
+
+# Install dependencies
+npm install
+
+# Link for local development
+npm link
+
+# Test
+Krims Code --help
+Krims Code status
+Krims Code ask "hello"
+```
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 👨‍💻 Author
+
+**Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
+
+> *"Stay cyberpunk. âš¡"*
+
+---
+
+<p align="center">
+  <b>⚡ Krims Code AI v110 — Fusion Command Station ⚡</b><br>
+  <i>Universal AI Gateway for the Terminal</i>
+</p>

krims_code_cli-1.5.2.dist-info/RECORD

@@ -0,0 +1,43 @@
+krims_code_cli-1.5.2.dist-info/licenses/LICENSE,sha256=9kKNPpKXSdgtv9HXqHorQiVH6NQKwF34mvXadmIGHYI,1079
+krims_pip/__init__.py,sha256=4Sx9mbVn7FqCcTQ7VUWZiXD7Coz_vGENU2v9lhh5k3U,40
+krims_pip/cli.py,sha256=bP_1-bL_hLiRACP69EI7i62LXzsOLtpGzUb_-ffmyJY,2126
+krims_pip/node_project/package-lock.json,sha256=pyOcefpETcGSC82Bv9vuI18FLU7Ij_-zwYUdAJ5gOBY,28419
+krims_pip/node_project/package.json,sha256=srhM2xeC312inIgkYQWD3ZxIirRa89hR0gceRx7hQZU,1102
+krims_pip/node_project/bin/krims-code.js,sha256=uExW1KeiLrjdgMzOUoCO_yV7ko_uKBjh56Mo464Tsj8,545
+krims_pip/node_project/src/agent.js,sha256=tJ59vVLCMx7_W5ZXgEr-oKKhUYB9NOi10WdSpTtCcno,11955
+krims_pip/node_project/src/chat.js,sha256=nsN7wxwl-4ZzW7VyQbklBdF89WNnAQBj2USCVb8yn44,92921
+krims_pip/node_project/src/cli.js,sha256=ZZWOZ9a5kK0fgqCmCee1Z9xX1MVm-4UUxm99mVKBPbM,23316
+krims_pip/node_project/src/config.js,sha256=UQr1Lrc8XA31vRXpEWFP9hTybmsf4TayKv9QZri41Ng,10559
+krims_pip/node_project/src/dashboard.js,sha256=u5SxFdTJpf-bbkgqVlivOGtz2B-EcY7wBLidiZB6bRQ,3526
+krims_pip/node_project/src/file-parser.js,sha256=JI0PR4bolvF-IJtRAFK0fUYlI2V5HgXK6_hkgAf3wAo,4866
+krims_pip/node_project/src/git.js,sha256=dCla61d47xyXuSrbc3ksVATVtKCND0EFQ24ovciGxAA,1224
+krims_pip/node_project/src/mic.js,sha256=IaGWJSXOZI-25IXxPxP5ppnYmGocTCKIYA6qPLT2_lI,7234
+krims_pip/node_project/src/modes.js,sha256=PnQpfOvhi3ZMS-mqa_RxysvwessXyDrjXNqXp0CGCeo,6254
+krims_pip/node_project/src/telemetry-server.js,sha256=GC_0gDq384Qn4Ok_ctSlc-eMcJ2AflbdKHz6zre4H0g,28603
+krims_pip/node_project/src/updater.js,sha256=KrgvJ-jv9CUsUIPDtXL7QjY9TLaaV9TGoAVlh-wZkP0,7498
+krims_pip/node_project/src/ai/fallback.js,sha256=-4jf6_Gm4wwCvG1yea7B4VRA4dxOPwzpefGnEAX19bg,8535
+krims_pip/node_project/src/ai/google.js,sha256=BnULtDNs133xSlPxAcxt28KkLE0oJkid2iWJmchwnAM,2795
+krims_pip/node_project/src/ai/providers.js,sha256=su0_9H9HQ3qUIp9-lQ4rEkr94rMdDE_7ZStgy9NDYW0,7504
+krims_pip/node_project/src/ai/router.js,sha256=AY9WCnf_ae6ENhdh4LItCB5RVjEuB5KRmMf0BY_4_tw,6219
+krims_pip/node_project/src/ai/search.js,sha256=7vDQjs2njnHr81D4ILkUJOKbIpBQQ0mWYxrrKu38W6o,2652
+krims_pip/node_project/src/ai/telemetry.js,sha256=FN0qud17OArXKa3XCXZoOjKwmZ1JFqscSiegxmCtvlU,3606
+krims_pip/node_project/src/ai/tokens.js,sha256=seRyRN4hSY8nwc6NEWtEXm9Bi5KpzInuISMI2eYZVHE,2944
+krims_pip/node_project/src/ai/universal.js,sha256=wOjp1OIXr8RWwB0EfZh8km8vDZHX26Ipx4IN42axOlU,17185
+krims_pip/node_project/src/ai/xai.js,sha256=h6RdoKBpUmwIGoOEJsZOCKXBBPKQAIPiQPPvXkAf75Y,1665
+krims_pip/node_project/src/commands/commit.js,sha256=YSHkZmZ_lYU3s9zn8hDBOlvRifcCkFXZXeO0moXsYSo,6787
+krims_pip/node_project/src/commands/dashboard.js,sha256=h-JcPvYh3-s2Jf9TedOdvB3KbpmkPuo346Rs7Ncn-nY,2443
+krims_pip/node_project/src/commands/github.js,sha256=ElwNY_7s7zLg3tUAJAqERnnSaHDP-FUbB_OkU9oxp5g,13060
+krims_pip/node_project/src/commands/index.js,sha256=07iqsSfNFZvKpNHb5uCjxWu57YqoMvIrVYjfmDEoTg8,1640
+krims_pip/node_project/src/commands/status.js,sha256=VWqsHUZv0Bgc9ZlizsN-jA3G1DnsXkVH3etO0aamcrM,2930
+krims_pip/node_project/src/commands/teamwork-preview.js,sha256=fi5d7btkaHg2rugVcgaXYLT3PPgBVUayfAt7PGBOYuQ,10096
+krims_pip/node_project/src/commands/theme.js,sha256=QZ9ACs4eDB1Or2p7ncY9yoze8fG--Ixjxyri2pmJzow,1825
+krims_pip/node_project/src/commands/themes.js,sha256=mbtT_YJgFjzZgoZGwbeizvW0MJTbxU2PLa61q8gENvU,1038
+krims_pip/node_project/src/ui/banner.js,sha256=5FIWPLdesK4bYziTP_Lo1Jj3ySxB_8VlFVfDCIcaF5E,8465
+krims_pip/node_project/src/ui/dashboard.html,sha256=5KY78wUjUB_m1h4B4OVyW41m1JsdW-XRUvMJ9Q-aYQQ,25200
+krims_pip/node_project/src/ui/spinner.js,sha256=iJHE-nc7g07zM7REfWB4nWYZ-YBnmNxM-ujzyh2y1tY,1369
+krims_pip/node_project/src/ui/theme.js,sha256=B8JoLH70PvcARWkEtCHvLUDMGsG_HkXj1wrFMq5wZGc,22025
+krims_code_cli-1.5.2.dist-info/METADATA,sha256=Ex1TNpEFeSWr-JVeNr4lFX3dwhCYhC8Gi9yqL76VCHE,15888
+krims_code_cli-1.5.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+krims_code_cli-1.5.2.dist-info/entry_points.txt,sha256=JskS9H9GWaM9ex7DqSYsXLAB0IYInQkORS8GEORKOuA,49
+krims_code_cli-1.5.2.dist-info/top_level.txt,sha256=Z2u4WfWI-MwDl1R2-lJZyIuOtFTqVYuXVsPjtQpyXmQ,10
+krims_code_cli-1.5.2.dist-info/RECORD,,

krims_code_cli-1.5.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

krims_code_cli-1.5.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+krims-pip = krims_pip.cli:main

krims_code_cli-1.5.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Krishiv PB (@Krylo-60)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

krims_code_cli-1.5.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+krims_pip

krims_pip/__init__.py

@@ -0,0 +1 @@
+# Krims Code AI CLI Pip Package Wrapper

krims_pip/cli.py

@@ -0,0 +1,50 @@
+import sys
+import os
+import subprocess
+import shutil
+
+def main():
+    # Find the Node.js entry point absolute path inside KRIMS CODE_pip/node_project
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    node_project_dir = os.path.join(script_dir, "node_project")
+    krims_code_js = os.path.join(node_project_dir, "bin", "krims-code.js")
+    
+    # If not found globally, check dev layout relative to current working directory
+    if not os.path.exists(krims_code_js):
+        krims_code_js = os.path.join(os.getcwd(), "bin", "krims-code.js")
+        node_project_dir = os.getcwd()
+
+    if not shutil.which("node"):
+        print("Error: Node.js is required to run Krims Code CLI.", file=sys.stderr)
+        print("Please install Node.js (https://nodejs.org) and try again.", file=sys.stderr)
+        sys.exit(1)
+
+    # Check if node_modules exists in the node_project directory.
+    # If not, automatically run npm install inside that directory!
+    node_modules_dir = os.path.join(node_project_dir, "node_modules")
+    if not os.path.exists(node_modules_dir):
+        print("First-time launch check: Installing node dependencies via npm...")
+        npm_cmd = shutil.which("npm")
+        if not npm_cmd:
+            print("Error: npm is required to install Node dependencies.", file=sys.stderr)
+            print("Please install Node.js/npm and try again.", file=sys.stderr)
+            sys.exit(1)
+        
+        # On Windows, run npm using shell=True to handle cmd/bat resolution
+        subprocess.run([npm_cmd, "install", "--no-audit", "--no-fund"], cwd=node_project_dir, shell=(os.name == "nt"))
+
+    try:
+        # Run node krims-code.js passing all command line arguments
+        os.environ["KRIMS_PACKAGER"] = "pip"
+        cmd = ["node", krims_code_js] + sys.argv[1:]
+        result = subprocess.run(cmd, check=False)
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        print("\nSession terminated by user.")
+        sys.exit(0)
+    except Exception as e:
+        print(f"Error running Krims Code: {e}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

krims_pip/node_project/bin/krims-code.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+// ═══════════════════════════════════════════════════════════
+// KRIMS CODE AI CLI — Entry Point
+// Universal AI Gateway — 13+ Providers, Free & Paid
+// ═══════════════════════════════════════════════════════════
+
+import { createCLI } from "../src/cli.js";
+
+createCLI(process.argv);