krims-code-cli 1.5.2__tar.gz → 1.5.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. krims_code_cli-1.5.3/PKG-INFO +342 -0
  2. krims_code_cli-1.5.3/README.md +319 -0
  3. krims_code_cli-1.5.3/krims_code_cli.egg-info/PKG-INFO +342 -0
  4. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/package.json +1 -1
  5. krims_code_cli-1.5.2/PKG-INFO +0 -336
  6. krims_code_cli-1.5.2/README.md +0 -313
  7. krims_code_cli-1.5.2/krims_code_cli.egg-info/PKG-INFO +0 -336
  8. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/LICENSE +0 -0
  9. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_code_cli.egg-info/SOURCES.txt +0 -0
  10. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_code_cli.egg-info/dependency_links.txt +0 -0
  11. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_code_cli.egg-info/entry_points.txt +0 -0
  12. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_code_cli.egg-info/top_level.txt +0 -0
  13. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/__init__.py +0 -0
  14. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/cli.py +0 -0
  15. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/bin/krims-code.js +0 -0
  16. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/package-lock.json +0 -0
  17. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/agent.js +0 -0
  18. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/fallback.js +0 -0
  19. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/google.js +0 -0
  20. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/providers.js +0 -0
  21. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/router.js +0 -0
  22. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/search.js +0 -0
  23. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/telemetry.js +0 -0
  24. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/tokens.js +0 -0
  25. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/universal.js +0 -0
  26. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ai/xai.js +0 -0
  27. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/chat.js +0 -0
  28. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/cli.js +0 -0
  29. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/commit.js +0 -0
  30. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/dashboard.js +0 -0
  31. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/github.js +0 -0
  32. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/index.js +0 -0
  33. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/status.js +0 -0
  34. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/teamwork-preview.js +0 -0
  35. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/theme.js +0 -0
  36. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/commands/themes.js +0 -0
  37. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/config.js +0 -0
  38. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/dashboard.js +0 -0
  39. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/file-parser.js +0 -0
  40. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/git.js +0 -0
  41. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/mic.js +0 -0
  42. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/modes.js +0 -0
  43. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/telemetry-server.js +0 -0
  44. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ui/banner.js +0 -0
  45. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ui/dashboard.html +0 -0
  46. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ui/spinner.js +0 -0
  47. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/ui/theme.js +0 -0
  48. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/krims_pip/node_project/src/updater.js +0 -0
  49. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/setup.cfg +0 -0
  50. {krims_code_cli-1.5.2 → krims_code_cli-1.5.3}/setup.py +0 -0
krims_code_cli-1.5.3/PKG-INFO ADDED
@@ -0,0 +1,342 @@
1
+ Metadata-Version: 2.4
2
+ Name: krims-code-cli
3
+ Version: 1.5.3
4
+ Summary: Krims Code AI — Universal AI Gateway CLI (Python Wrapper)
5
+ Home-page: https://github.com/Krylo-60/krims-code-cli
6
+ Author: Krishiv PB
7
+ Author-email: krylobloxyt@gmail.com
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: License :: OSI Approved :: MIT License
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.6
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ Dynamic: author
15
+ Dynamic: author-email
16
+ Dynamic: classifier
17
+ Dynamic: description
18
+ Dynamic: description-content-type
19
+ Dynamic: home-page
20
+ Dynamic: license-file
21
+ Dynamic: requires-python
22
+ Dynamic: summary
23
+
24
+ # Krims Code CLI
25
+
26
+ > ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
27
+
28
+ [![npm version](https://img.shields.io/npm/v/@krishivpb60/krims-code-cli.svg)](https://www.npmjs.com/package/@krishivpb60/krims-code-cli)
29
+ [![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg)](LICENSE)
30
+ [![Node.js](https://img.shields.io/badge/Node.js-≥18.0.0-green.svg)](https://nodejs.org)
31
+
32
+ ```
33
+ ╔════════════════════════════════════════════════════════════════╗
34
+ ║ ██╗ ██╗██████╗ ██╗███╗ ███╗███████╗ ██████╗ ██████╗ ║
35
+ ║ ██║ ██╔╝██╔══██╗██║████╗ ████║██╔════╝ ██╔════╝██╔═══██╗ ║
36
+ ║ █████╔╝ ██████╔╝██║██╔████╔██║███████╗ ██║ ██║ ██║ ║
37
+ ║ ██╔═██╗ ██╔══██╗██║██║╚██╔╝██║╚════██║ ██║ ██║ ██║ ║
38
+ ║ ██║ ██╗██║ ██║██║██║ ╚═╝ ██║███████║ ╚██████╗╚██████╔╝ ║
39
+ ║ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝ ║
40
+ ║ ██████╗██╗ ██╗ ║
41
+ ║ ██╔════╝██║ ██║ ║
42
+ ║ ██║ ██║ ██║ ║
43
+ ║ ██║ ██║ ██║ ║
44
+ ║ ╚██████╗███████╗██║ ║
45
+ ║ ╚═════╝╚══════╝╚═╝ ║
46
+ ╚════════════════════════════════════════════════════════════════╝
47
+ ```
48
+
49
+ **Krims Code CLI** 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.
50
+
51
+ ---
52
+
53
+ ## ✨ Features
54
+
55
+ - 🌐 **13+ AI Providers** — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
56
+ - 🆓 **Free Models Included** — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
57
+ - 💬 **Interactive Chat** — Full terminal chat with slash commands, mode switching, and file attachments
58
+ - ⚡ **Single-Shot Queries** — Quick one-off questions directly from the CLI
59
+ - 🧠 **4 Reasoning Modes** — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
60
+ - 📎 **File Context Injection** — Attach code files, logs, or documents for context-aware AI responses
61
+ - 🤖 **Autopilot Debug Loop** — Automatically correct build/test failures using AI self-correcting feedback loop
62
+ - 🌿 **Interactive Git TUI** — Beautiful cyberpunk ASCII branch tree commit history & interactive file staging checkbox menu
63
+ - 📊 **Web HUD Dashboard** — Companion local zero-dependency telemetry dashboard displaying real-time latencies & provider status
64
+ - 🎤 **Voice Microphone Input** — Record voice input directly from your terminal and transcribe it to text using Google Gemini or Whisper
65
+ - 🔄 **Failover Mesh** — Automatic failback across all configured providers
66
+ - 🔢 **Local Math Solver** — Evaluates mathematical expressions without an API call
67
+ - 🤖 **Krylo Companion** — Offline cyberpunk companion bot when no API keys are configured
68
+ - 🔐 **Your Keys, Your Control** — API keys stored locally on YOUR machine, never transmitted anywhere
69
+ - 📤 **Export Conversations** — Save full chat history as Markdown files
70
+ - 🎨 **Cyberpunk UI** — Neon colors, ASCII art, signal bars, and mode badges
71
+ - 🎭 **4 Color Themes** — Cyberpunk, Matrix, Synthwave, Crimson — switch with `/theme`
72
+ - ⌨️ **Custom Commands** — Create reusable prompt shortcuts with `/cmd add`
73
+ - 📝 **File Creation** — AI can create files on your system with path override prompts
74
+ - 📊 **Live Telemetry** — Real-time response latency & tokens/sec in the status bar
75
+ - 🎮 **Mini-Game** — Built-in mainframe hacking game (`/game`)
76
+ - 📋 **Clipboard Copy** — Copy last response to clipboard with `/copy`
77
+
78
+ ---
79
+
80
+ ## 🚀 Quick Start
81
+
82
+ ### Install globally via npm
83
+
84
+ ```bash
85
+ npm install -g @krishivpb60/krims-code-cli
86
+ ```
87
+
88
+ ### Or run directly with npx
89
+
90
+ ```bash
91
+ npx @krishivpb60/krims-code-cli chat
92
+ ```
93
+
94
+ ### Or install via pip (Python wrapper)
95
+
96
+ ```bash
97
+ pip install krims-code-cli
98
+ # Run via terminal:
99
+ krims-pip chat
100
+ ```
101
+
102
+ ### Setup (Interactive Wizard)
103
+
104
+ ```bash
105
+ krims-code setup
106
+ ```
107
+
108
+ The wizard walks you through configuring providers — **start with free ones!**
109
+
110
+ ### Or set keys manually
111
+
112
+ ```bash
113
+ # Free providers (recommended to start)
114
+ krims-code config set GROQ_API_KEY gsk_your_key_here
115
+ krims-code config set GOOGLE_API_KEY AIza_your_key_here
116
+ krims-code config set OPENROUTER_API_KEY sk-or-your_key_here
117
+
118
+ # Paid providers
119
+ krims-code config set OPENAI_API_KEY sk-your_key_here
120
+ krims-code config set ANTHROPIC_API_KEY sk-ant-your_key_here
121
+ ```
122
+
123
+ ### Start chatting
124
+
125
+ ```bash
126
+ krims-code chat
127
+ ```
128
+
129
+ ### Quick one-shot query
130
+
131
+ ```bash
132
+ krims-code ask "Explain quantum computing in simple terms"
133
+ ```
134
+
135
+ ---
136
+
137
+ ## 📦 Supported Providers
138
+
139
+ | Provider | Key | Free Tier | Default Model |
140
+ |----------|-----|-----------|---------------|
141
+ | **Groq** | `GROQ_API_KEY` | ✅ Generous | `llama-3.3-70b-versatile` |
142
+ | **Together AI** | `TOGETHER_API_KEY` | ✅ Free credits | `Meta-Llama-3.1-70B-Instruct-Turbo` |
143
+ | **Cerebras** | `CEREBRAS_API_KEY` | ✅ Free tier | `llama-3.3-70b` |
144
+ | **OpenRouter** | `OPENROUTER_API_KEY` | ✅ Free models | `llama-3.1-70b-instruct:free` |
145
+ | **Google Gemini** | `GOOGLE_API_KEY` | ✅ Free tier | `gemini-2.5-flash` |
146
+ | **Cohere** | `COHERE_API_KEY` | ✅ Dev free | `command-r-plus` |
147
+ | **Fireworks AI** | `FIREWORKS_API_KEY` | ✅ Free tier | `llama-v3p1-70b-instruct` |
148
+ | **OpenAI** | `OPENAI_API_KEY` | 💳 Paid | `gpt-4o` |
149
+ | **Anthropic** | `ANTHROPIC_API_KEY` | 💳 Paid | `claude-sonnet-4` |
150
+ | **xAI** | `XAI_API_KEY` | 💳 Paid | `grok-2` |
151
+ | **Mistral** | `MISTRAL_API_KEY` | 💳 Paid | `mistral-large-latest` |
152
+ | **DeepSeek** | `DEEPSEEK_API_KEY` | 💳 Paid | `deepseek-chat` |
153
+ | **Perplexity** | `PERPLEXITY_API_KEY` | 💳 Paid | `sonar` |
154
+
155
+ > 💡 **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!
156
+
157
+ ---
158
+
159
+ ## 🎮 Commands
160
+
161
+ ### Core Commands
162
+
163
+ ```bash
164
+ krims-code chat # Interactive chat session
165
+ krims-code ask "your question" # Single-shot query
166
+ krims-code setup # Guided provider setup wizard
167
+ ```
168
+
169
+ ### Configuration
170
+
171
+ ```bash
172
+ krims-code config set <KEY> <value> # Set a config value
173
+ krims-code config get <KEY> # Get a config value
174
+ krims-code config list # List all config (keys masked)
175
+ krims-code config delete <KEY> # Delete a config key
176
+ krims-code config reset # Delete all config
177
+ krims-code config path # Show config file location
178
+ ```
179
+
180
+ ### Discovery
181
+
182
+ ```bash
183
+ krims-code providers # List all 13+ supported providers
184
+ krims-code providers --free # Show only free-tier providers
185
+ krims-code models # List all available models
186
+ krims-code models groq # Models for a specific provider
187
+ krims-code modes # List reasoning modes
188
+ krims-code status # System status & active providers
189
+ ```
190
+
191
+ ### Flags
192
+
193
+ ```bash
194
+ krims-code ask "prompt" --mode research # Use specific reasoning mode
195
+ krims-code ask "prompt" --file error.log # Attach file context
196
+ krims-code ask "prompt" --model gpt-4o # Override model
197
+ krims-code ask "prompt" --raw # Raw text output (for piping)
198
+ krims-code chat --mode architect # Start chat in specific mode
199
+ ```
200
+
201
+ ---
202
+
203
+ ## 💬 Chat Commands
204
+
205
+ Inside interactive chat mode, use these slash commands:
206
+
207
+ | Command | Description |
208
+ |---------|-------------|
209
+ | `/help` | Show all commands |
210
+ | `/mode <name>` | Switch reasoning mode (synthesis, research, architect, titan) |
211
+ | `/modes` | List all modes with signal bars |
212
+ | `/theme <name>` | Switch visual theme (cyberpunk, matrix, synthwave, crimson) |
213
+ | `/themes` | List available color themes |
214
+ | `/attach <file>` | Attach a file for context (supports Tab autocomplete!) |
215
+ | `/files` | List attached files |
216
+ | `/clear` | Clear terminal screen |
217
+ | `/providers` | Show active providers |
218
+ | `/export` | Export chat to Markdown |
219
+ | `/copy` | Copy last response to clipboard |
220
+ | `/write <file>` | Extract last code block and save to file |
221
+ | `/cmd list` | List custom command shortcuts |
222
+ | `/cmd add <name> <template>` | Create a custom command shortcut |
223
+ | `/cmd remove <name>` | Delete a custom command |
224
+ | `/game` | Start the mainframe hacking mini-game |
225
+ | `/history` | List, switch, and resume past interactive chat sessions |
226
+ | `/history-clear` | Clear saved persistent chat history |
227
+ | `/autopilot <mode\|debug [cmd]>` | View/switch autopilot safety level or run autonomous debug loop |
228
+ | `/git` | Launch interactive cyberpunk Git TUI and file stager checkbox menu |
229
+ | `/github <status\|issues\|prs>` | Git/GitHub orchestration, auto-staging, semantic AI commit generation, and remote sync |
230
+ | `/teamwork-preview` | Render real-time multi-agent matrix status dashboard with heartbeats & tasks |
231
+ | `/dashboard` | Spawn zero-dependency local web server and launch telemetry dashboard HUD |
232
+ | `/mic` | Record audio voice input from microphone and transcribe to text |
233
+ | `/tokens` | View detailed session token usage and exchanges telemetry |
234
+ | `/update` | Force check for updates and update Krims Code CLI manually |
235
+ | `/review` | Run git diff and stream an AI code review |
236
+ | `/diagnose [cmd]` | Run build/tests and AI-debug any errors |
237
+ | `/explain <file>` | AI-explain the design and logic of a file |
238
+ | `/refactor <file>` | AI-refactor the code of a target file |
239
+ | `/bug <file>` | Scan a file to detect logical edge case failures |
240
+ | `/doc <file>` | Write documentation, inline comments, or JSDoc |
241
+ | `/translate <file> <lang>` | AI-translate file code into another target language |
242
+ | `/exit` | End session |
243
+
244
+ ---
245
+
246
+ ## 🧠 Reasoning Modes
247
+
248
+ | Mode | Layer | Style | Signal |
249
+ |------|-------|-------|--------|
250
+ | **Synthesis** | v2.5 | Balanced, clean, direct | ████████░░ 80% |
251
+ | **Research** | v104 | Deep analysis, evidence-based | █████████░ 85% |
252
+ | **Architect** | v55 | Systems thinking, debugging | █████████░ 90% |
253
+ | **Titan Fusion** | v110 | Premium, maximum signal density | █████████░ 95% |
254
+
255
+ ---
256
+
257
+ ## 🔐 Security
258
+
259
+ - **Your keys stay on YOUR machine** — stored at `~/.krims-code/config.json`
260
+ - **No keys are bundled** in the package
261
+ - **No telemetry** — zero data collection
262
+ - **Keys are masked** when displayed (`krims-code config list`)
263
+ - **Environment variables** also supported as fallback
264
+
265
+ ---
266
+
267
+ ## 🔄 Failover Mesh
268
+
269
+ Krims Code routes your prompt through all configured providers automatically:
270
+
271
+ ```
272
+ Your Prompt
273
+ ↓
274
+ [Provider 1] → Success? → Response ✓
275
+ ↓ (fail)
276
+ [Provider 2] → Success? → Response ✓
277
+ ↓ (fail)
278
+ [Provider N] → Success? → Response ✓
279
+ ↓ (all fail)
280
+ [Krylo Companion] → Local Response ✓
281
+ ```
282
+
283
+ If a provider returns an error (rate limit, quota, etc.), Krims Code automatically tries the next one. Configure multiple free providers for maximum resilience!
284
+
285
+ ---
286
+
287
+ ## 📁 File Attachment
288
+
289
+ Attach code files, logs, configs, or documents for context-aware responses:
290
+
291
+ ```bash
292
+ # From CLI
293
+ krims-code ask "What's wrong with this code?" --file buggy.js
294
+
295
+ # In chat mode
296
+ /attach error.log
297
+ What errors are in this file?
298
+ ```
299
+
300
+ **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`
301
+
302
+ ---
303
+
304
+ ## 🏗️ Development
305
+
306
+ ```bash
307
+ # Clone the repo
308
+ git clone https://github.com/Krylo-60/krims-code-cli.git
309
+ cd krims-code-cli
310
+
311
+ # Install dependencies
312
+ npm install
313
+
314
+ # Link for local development
315
+ npm link
316
+
317
+ # Test
318
+ krims-code --help
319
+ krims-code status
320
+ krims-code ask "hello"
321
+ ```
322
+
323
+ ---
324
+
325
+ ## 📄 License
326
+
327
+ MIT License — see [LICENSE](LICENSE) for details.
328
+
329
+ ---
330
+
331
+ ## 👨‍💻 Author
332
+
333
+ **Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
334
+
335
+ > *"Stay cyberpunk. ⚡"*
336
+
337
+ ---
338
+
339
+ <p align="center">
340
+ <b>⚡ Krims Code CLI — Fusion Command Station ⚡</b><br>
341
+ <i>Universal AI Gateway for the Terminal</i>
342
+ </p>
krims_code_cli-1.5.3/README.md ADDED
@@ -0,0 +1,319 @@
1
+ # Krims Code CLI
2
+
3
+ > ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@krishivpb60/krims-code-cli.svg)](https://www.npmjs.com/package/@krishivpb60/krims-code-cli)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg)](LICENSE)
7
+ [![Node.js](https://img.shields.io/badge/Node.js-≥18.0.0-green.svg)](https://nodejs.org)
8
+
9
+ ```
10
+ ╔════════════════════════════════════════════════════════════════╗
11
+ ║ ██╗ ██╗██████╗ ██╗███╗ ███╗███████╗ ██████╗ ██████╗ ║
12
+ ║ ██║ ██╔╝██╔══██╗██║████╗ ████║██╔════╝ ██╔════╝██╔═══██╗ ║
13
+ ║ █████╔╝ ██████╔╝██║██╔████╔██║███████╗ ██║ ██║ ██║ ║
14
+ ║ ██╔═██╗ ██╔══██╗██║██║╚██╔╝██║╚════██║ ██║ ██║ ██║ ║
15
+ ║ ██║ ██╗██║ ██║██║██║ ╚═╝ ██║███████║ ╚██████╗╚██████╔╝ ║
16
+ ║ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝ ║
17
+ ║ ██████╗██╗ ██╗ ║
18
+ ║ ██╔════╝██║ ██║ ║
19
+ ║ ██║ ██║ ██║ ║
20
+ ║ ██║ ██║ ██║ ║
21
+ ║ ╚██████╗███████╗██║ ║
22
+ ║ ╚═════╝╚══════╝╚═╝ ║
23
+ ╚════════════════════════════════════════════════════════════════╝
24
+ ```
25
+
26
+ **Krims Code CLI** 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.
27
+
28
+ ---
29
+
30
+ ## ✨ Features
31
+
32
+ - 🌐 **13+ AI Providers** — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
33
+ - 🆓 **Free Models Included** — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
34
+ - 💬 **Interactive Chat** — Full terminal chat with slash commands, mode switching, and file attachments
35
+ - ⚡ **Single-Shot Queries** — Quick one-off questions directly from the CLI
36
+ - 🧠 **4 Reasoning Modes** — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
37
+ - 📎 **File Context Injection** — Attach code files, logs, or documents for context-aware AI responses
38
+ - 🤖 **Autopilot Debug Loop** — Automatically correct build/test failures using AI self-correcting feedback loop
39
+ - 🌿 **Interactive Git TUI** — Beautiful cyberpunk ASCII branch tree commit history & interactive file staging checkbox menu
40
+ - 📊 **Web HUD Dashboard** — Companion local zero-dependency telemetry dashboard displaying real-time latencies & provider status
41
+ - 🎤 **Voice Microphone Input** — Record voice input directly from your terminal and transcribe it to text using Google Gemini or Whisper
42
+ - 🔄 **Failover Mesh** — Automatic failback across all configured providers
43
+ - 🔢 **Local Math Solver** — Evaluates mathematical expressions without an API call
44
+ - 🤖 **Krylo Companion** — Offline cyberpunk companion bot when no API keys are configured
45
+ - 🔐 **Your Keys, Your Control** — API keys stored locally on YOUR machine, never transmitted anywhere
46
+ - 📤 **Export Conversations** — Save full chat history as Markdown files
47
+ - 🎨 **Cyberpunk UI** — Neon colors, ASCII art, signal bars, and mode badges
48
+ - 🎭 **4 Color Themes** — Cyberpunk, Matrix, Synthwave, Crimson — switch with `/theme`
49
+ - ⌨️ **Custom Commands** — Create reusable prompt shortcuts with `/cmd add`
50
+ - 📝 **File Creation** — AI can create files on your system with path override prompts
51
+ - 📊 **Live Telemetry** — Real-time response latency & tokens/sec in the status bar
52
+ - 🎮 **Mini-Game** — Built-in mainframe hacking game (`/game`)
53
+ - 📋 **Clipboard Copy** — Copy last response to clipboard with `/copy`
54
+
55
+ ---
56
+
57
+ ## 🚀 Quick Start
58
+
59
+ ### Install globally via npm
60
+
61
+ ```bash
62
+ npm install -g @krishivpb60/krims-code-cli
63
+ ```
64
+
65
+ ### Or run directly with npx
66
+
67
+ ```bash
68
+ npx @krishivpb60/krims-code-cli chat
69
+ ```
70
+
71
+ ### Or install via pip (Python wrapper)
72
+
73
+ ```bash
74
+ pip install krims-code-cli
75
+ # Run via terminal:
76
+ krims-pip chat
77
+ ```
78
+
79
+ ### Setup (Interactive Wizard)
80
+
81
+ ```bash
82
+ krims-code setup
83
+ ```
84
+
85
+ The wizard walks you through configuring providers — **start with free ones!**
86
+
87
+ ### Or set keys manually
88
+
89
+ ```bash
90
+ # Free providers (recommended to start)
91
+ krims-code config set GROQ_API_KEY gsk_your_key_here
92
+ krims-code config set GOOGLE_API_KEY AIza_your_key_here
93
+ krims-code config set OPENROUTER_API_KEY sk-or-your_key_here
94
+
95
+ # Paid providers
96
+ krims-code config set OPENAI_API_KEY sk-your_key_here
97
+ krims-code config set ANTHROPIC_API_KEY sk-ant-your_key_here
98
+ ```
99
+
100
+ ### Start chatting
101
+
102
+ ```bash
103
+ krims-code chat
104
+ ```
105
+
106
+ ### Quick one-shot query
107
+
108
+ ```bash
109
+ krims-code ask "Explain quantum computing in simple terms"
110
+ ```
111
+
112
+ ---
113
+
114
+ ## 📦 Supported Providers
115
+
116
+ | Provider | Key | Free Tier | Default Model |
117
+ |----------|-----|-----------|---------------|
118
+ | **Groq** | `GROQ_API_KEY` | ✅ Generous | `llama-3.3-70b-versatile` |
119
+ | **Together AI** | `TOGETHER_API_KEY` | ✅ Free credits | `Meta-Llama-3.1-70B-Instruct-Turbo` |
120
+ | **Cerebras** | `CEREBRAS_API_KEY` | ✅ Free tier | `llama-3.3-70b` |
121
+ | **OpenRouter** | `OPENROUTER_API_KEY` | ✅ Free models | `llama-3.1-70b-instruct:free` |
122
+ | **Google Gemini** | `GOOGLE_API_KEY` | ✅ Free tier | `gemini-2.5-flash` |
123
+ | **Cohere** | `COHERE_API_KEY` | ✅ Dev free | `command-r-plus` |
124
+ | **Fireworks AI** | `FIREWORKS_API_KEY` | ✅ Free tier | `llama-v3p1-70b-instruct` |
125
+ | **OpenAI** | `OPENAI_API_KEY` | 💳 Paid | `gpt-4o` |
126
+ | **Anthropic** | `ANTHROPIC_API_KEY` | 💳 Paid | `claude-sonnet-4` |
127
+ | **xAI** | `XAI_API_KEY` | 💳 Paid | `grok-2` |
128
+ | **Mistral** | `MISTRAL_API_KEY` | 💳 Paid | `mistral-large-latest` |
129
+ | **DeepSeek** | `DEEPSEEK_API_KEY` | 💳 Paid | `deepseek-chat` |
130
+ | **Perplexity** | `PERPLEXITY_API_KEY` | 💳 Paid | `sonar` |
131
+
132
+ > 💡 **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!
133
+
134
+ ---
135
+
136
+ ## 🎮 Commands
137
+
138
+ ### Core Commands
139
+
140
+ ```bash
141
+ krims-code chat # Interactive chat session
142
+ krims-code ask "your question" # Single-shot query
143
+ krims-code setup # Guided provider setup wizard
144
+ ```
145
+
146
+ ### Configuration
147
+
148
+ ```bash
149
+ krims-code config set <KEY> <value> # Set a config value
150
+ krims-code config get <KEY> # Get a config value
151
+ krims-code config list # List all config (keys masked)
152
+ krims-code config delete <KEY> # Delete a config key
153
+ krims-code config reset # Delete all config
154
+ krims-code config path # Show config file location
155
+ ```
156
+
157
+ ### Discovery
158
+
159
+ ```bash
160
+ krims-code providers # List all 13+ supported providers
161
+ krims-code providers --free # Show only free-tier providers
162
+ krims-code models # List all available models
163
+ krims-code models groq # Models for a specific provider
164
+ krims-code modes # List reasoning modes
165
+ krims-code status # System status & active providers
166
+ ```
167
+
168
+ ### Flags
169
+
170
+ ```bash
171
+ krims-code ask "prompt" --mode research # Use specific reasoning mode
172
+ krims-code ask "prompt" --file error.log # Attach file context
173
+ krims-code ask "prompt" --model gpt-4o # Override model
174
+ krims-code ask "prompt" --raw # Raw text output (for piping)
175
+ krims-code chat --mode architect # Start chat in specific mode
176
+ ```
177
+
178
+ ---
179
+
180
+ ## 💬 Chat Commands
181
+
182
+ Inside interactive chat mode, use these slash commands:
183
+
184
+ | Command | Description |
185
+ |---------|-------------|
186
+ | `/help` | Show all commands |
187
+ | `/mode <name>` | Switch reasoning mode (synthesis, research, architect, titan) |
188
+ | `/modes` | List all modes with signal bars |
189
+ | `/theme <name>` | Switch visual theme (cyberpunk, matrix, synthwave, crimson) |
190
+ | `/themes` | List available color themes |
191
+ | `/attach <file>` | Attach a file for context (supports Tab autocomplete!) |
192
+ | `/files` | List attached files |
193
+ | `/clear` | Clear terminal screen |
194
+ | `/providers` | Show active providers |
195
+ | `/export` | Export chat to Markdown |
196
+ | `/copy` | Copy last response to clipboard |
197
+ | `/write <file>` | Extract last code block and save to file |
198
+ | `/cmd list` | List custom command shortcuts |
199
+ | `/cmd add <name> <template>` | Create a custom command shortcut |
200
+ | `/cmd remove <name>` | Delete a custom command |
201
+ | `/game` | Start the mainframe hacking mini-game |
202
+ | `/history` | List, switch, and resume past interactive chat sessions |
203
+ | `/history-clear` | Clear saved persistent chat history |
204
+ | `/autopilot <mode\|debug [cmd]>` | View/switch autopilot safety level or run autonomous debug loop |
205
+ | `/git` | Launch interactive cyberpunk Git TUI and file stager checkbox menu |
206
+ | `/github <status\|issues\|prs>` | Git/GitHub orchestration, auto-staging, semantic AI commit generation, and remote sync |
207
+ | `/teamwork-preview` | Render real-time multi-agent matrix status dashboard with heartbeats & tasks |
208
+ | `/dashboard` | Spawn zero-dependency local web server and launch telemetry dashboard HUD |
209
+ | `/mic` | Record audio voice input from microphone and transcribe to text |
210
+ | `/tokens` | View detailed session token usage and exchanges telemetry |
211
+ | `/update` | Force check for updates and update Krims Code CLI manually |
212
+ | `/review` | Run git diff and stream an AI code review |
213
+ | `/diagnose [cmd]` | Run build/tests and AI-debug any errors |
214
+ | `/explain <file>` | AI-explain the design and logic of a file |
215
+ | `/refactor <file>` | AI-refactor the code of a target file |
216
+ | `/bug <file>` | Scan a file to detect logical edge case failures |
217
+ | `/doc <file>` | Write documentation, inline comments, or JSDoc |
218
+ | `/translate <file> <lang>` | AI-translate file code into another target language |
219
+ | `/exit` | End session |
220
+
221
+ ---
222
+
223
+ ## 🧠 Reasoning Modes
224
+
225
+ | Mode | Layer | Style | Signal |
226
+ |------|-------|-------|--------|
227
+ | **Synthesis** | v2.5 | Balanced, clean, direct | ████████░░ 80% |
228
+ | **Research** | v104 | Deep analysis, evidence-based | █████████░ 85% |
229
+ | **Architect** | v55 | Systems thinking, debugging | █████████░ 90% |
230
+ | **Titan Fusion** | v110 | Premium, maximum signal density | █████████░ 95% |
231
+
232
+ ---
233
+
234
+ ## 🔐 Security
235
+
236
+ - **Your keys stay on YOUR machine** — stored at `~/.krims-code/config.json`
237
+ - **No keys are bundled** in the package
238
+ - **No telemetry** — zero data collection
239
+ - **Keys are masked** when displayed (`krims-code config list`)
240
+ - **Environment variables** also supported as fallback
241
+
242
+ ---
243
+
244
+ ## 🔄 Failover Mesh
245
+
246
+ Krims Code routes your prompt through all configured providers automatically:
247
+
248
+ ```
249
+ Your Prompt
250
+ ↓
251
+ [Provider 1] → Success? → Response ✓
252
+ ↓ (fail)
253
+ [Provider 2] → Success? → Response ✓
254
+ ↓ (fail)
255
+ [Provider N] → Success? → Response ✓
256
+ ↓ (all fail)
257
+ [Krylo Companion] → Local Response ✓
258
+ ```
259
+
260
+ If a provider returns an error (rate limit, quota, etc.), Krims Code automatically tries the next one. Configure multiple free providers for maximum resilience!
261
+
262
+ ---
263
+
264
+ ## 📁 File Attachment
265
+
266
+ Attach code files, logs, configs, or documents for context-aware responses:
267
+
268
+ ```bash
269
+ # From CLI
270
+ krims-code ask "What's wrong with this code?" --file buggy.js
271
+
272
+ # In chat mode
273
+ /attach error.log
274
+ What errors are in this file?
275
+ ```
276
+
277
+ **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`
278
+
279
+ ---
280
+
281
+ ## 🏗️ Development
282
+
283
+ ```bash
284
+ # Clone the repo
285
+ git clone https://github.com/Krylo-60/krims-code-cli.git
286
+ cd krims-code-cli
287
+
288
+ # Install dependencies
289
+ npm install
290
+
291
+ # Link for local development
292
+ npm link
293
+
294
+ # Test
295
+ krims-code --help
296
+ krims-code status
297
+ krims-code ask "hello"
298
+ ```
299
+
300
+ ---
301
+
302
+ ## 📄 License
303
+
304
+ MIT License — see [LICENSE](LICENSE) for details.
305
+
306
+ ---
307
+
308
+ ## 👨‍💻 Author
309
+
310
+ **Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
311
+
312
+ > *"Stay cyberpunk. ⚡"*
313
+
314
+ ---
315
+
316
+ <p align="center">
317
+ <b>⚡ Krims Code CLI — Fusion Command Station ⚡</b><br>
318
+ <i>Universal AI Gateway for the Terminal</i>
319
+ </p>