@gokulvenkatareddy/cortex 0.1.18 → 0.1.20

package/CORTEX.md

@@ -0,0 +1,22 @@
+# CORTEX — Zero-Command Routing
+
+Infer user intent from plain English and act directly using available tools. Do not ask the user to run slash commands.
+
+## Core Behavior
+- Read/search first, then fix. Never describe what you'd do — just do it.
+- Chain steps for multi-part requests (implement → test → commit).
+- Be proactive. If you see an obvious improvement, mention it briefly.
+- Ask only when truly ambiguous; make sensible defaults.
+
+## Safety
+- NEVER push/deploy without explicit user approval
+- NEVER delete files without confirmation (temp/build files excluded)
+- NEVER modify `.env` or secrets
+- NEVER install system packages automatically
+- ALWAYS verify after changes; prefer minimal targeted edits
+
+## Agents
+162 specialist agents in `src/skills/agency/`. Use the `Agent` tool with `subagent_type` for domain work. Run `/agents` to list them.
+
+## Tone
+Concise. Markdown. Cite file:line. No filler. One-line summary at end.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gokul Venkata Reddy
+
+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.

package/README.md

@@ -12,18 +12,14 @@
 
 <p align="center">
   <strong>An open-source, agentic AI coding assistant for your terminal, desktop, and editor.</strong><br/>
-  Runs entirely on free HuggingFace models. No Anthropic / OpenAI subscription required.
+  Connect to any LLM provider — OpenRouter, Groq, HuggingFace, NVIDIA, OpenAI, Anthropic, Gemini, and more.
 </p>
 
 <p align="center">
-  <a href="#-quick-start"><img src="https://img.shields.io/badge/Quick%20Start-5%20min-brightgreen" /></a>
-  <a href="#-architecture"><img src="https://img.shields.io/badge/Architecture-Full%20Diagram-blue" /></a>
-  <a href="#-command-reference-50-total"><img src="https://img.shields.io/badge/Commands-50+-purple" /></a>
-  <a href="#-153-specialist-agents"><img src="https://img.shields.io/badge/Agents-153-orange" /></a>
-  <a href="#-mcp-servers-38-registered"><img src="https://img.shields.io/badge/MCP%20Servers-38-cyan" /></a>
-  <a href="#-quick-start"><img src="https://img.shields.io/badge/Install-1%20command-green" /></a>
-  <a href="#-docker"><img src="https://img.shields.io/badge/Docker-ready-2496ED?logo=docker&logoColor=white" /></a>
-  <a href="https://www.npmjs.com/package/@gitlawb/cortex"><img src="https://img.shields.io/badge/npm-%40gitlawb%2Fcortex-red?logo=npm" /></a>
+  <a href="ARCHITECTURE.md"><img src="https://img.shields.io/badge/Architecture-View-blue" /></a>
+  <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/Contributing-Guide-green" /></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/Changelog-View-purple" /></a>
+  <a href="SECURITY.md"><img src="https://img.shields.io/badge/Security-Policy-orange" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow" /></a>
 </p>
 
@@ -83,7 +79,7 @@ A fully-agentic AI coding assistant with **everything built-in** — 50+ slash c
 | 🔄 | **Auto-failover** | Primary `zai-org/GLM-5:together` → fallback `:novita` on 5xx errors |
 | 🦙 | **Offline mode** | Ollama detected automatically at `localhost:11434` — zero config |
 | ⚡ | **50+ slash commands** | Smart commits, PR reviews, RAG, agents, voice, media, diagrams |
-| 👥 | **153 specialist agents** | Engineering · Marketing · Security · Design · Testing · Compliance · XR |
+| 👥 | **162 specialist agents** | Engineering · Marketing · Security · Design · Testing · Compliance · XR |
 | 🔌 | **38 MCP servers** | GitHub, Slack, Linear, Context7, Serena, Playwright, Jupyter, Git, Exa, Tavily, DuckDuckGo, Time, Everything, Postgres, SQLite, Puppeteer, Fetch, Memory, Filesystem, Seq-Thinking, Docker, Kubernetes, Chroma, Excel, Pandoc, PDF-Reader, Wikipedia, ArXiv, HackerNews, Reddit, YouTube-Transcript, RepoMix, OSM, AppleScript, Apple-Shortcuts, Automation-Mac, Calculator |
 | 🎤 | **Voice I/O** | Whisper (STT) + Bark (TTS) + Web Speech API |
 | 👁 | **Screen vision** | Electron `desktopCapturer` → vision LLM every 10s |
@@ -934,6 +930,32 @@ ollama serve                    # listens on :11434
 
 Dashboard → **Overview** tab shows green Ollama indicator when reachable.
 
+### Free Models (No API key required)
+
+CORTEX supports multiple free model providers:
+
+| Provider | Model | How to Use |
+|---|---|---|
+| **OpenRouter** (default) | MiniMax M2.5, Gemma, Llama | Set `OPENAI_MODEL=minimax/minimax-m2.5:free` |
+| **NVIDIA NIM** | DeepSeek V4 Pro, Qwen3 Coder | Use `/model` to select |
+| **Ollama** (local) | llama3.2:3b, moondream | Automatic fallback when offline |
+
+**Model Commands:**
+```
+/model          # Show NVIDIA NIM models only
+/model openrouter  # Show OpenRouter free models
+```
+
+**Environment Variables (`.env`):**
+```bash
+# Default: OpenRouter MiniMax (free)
+OPENAI_MODEL=minimax/minimax-m2.5:free
+
+# NVIDIA models (for /model selection)
+NVIDIA_MODEL_ID=deepseek-ai/deepseek-v4-pro
+NVIDIA_CODE_MODEL_ID=qwen/qwen3-coder-480b-a35b-instruct
+```
+
 ---
 
 ## 🖥 Tier A — Floating Desktop UI with Screen Watcher
@@ -1264,6 +1286,21 @@ All contributions welcome — new agents, new commands, new MCPs, UI polish, bug
 
 ---
 
+## 🆕 Recent Changes
+
+| Change | Description |
+|--------|-------------|
+| **45+ Provider Registry** | Connect to OpenRouter, Groq, HuggingFace, NVIDIA, Cerebras, Together AI, Deep Infra, Fireworks, OpenAI, Anthropic, Google Gemini, DeepSeek, Mistral, xAI, Ollama, LM Studio, and more |
+| **`/connect` command** | Interactive provider setup — pick a category, pick a provider, paste API key, done |
+| **`/tools` command** | Toggle extra tools on/off. 7 default tools (Bash, Read, Edit, Write, Glob, Grep, WebFetch) + optional extras (Agent, WebSearch, NotebookEdit, TodoWrite, etc.) |
+| **`/model` picker** | Now shows only your active provider's models (not all mixed together) |
+| **Startup provider picker** | First-run wizard when no API key is configured — pick a provider, paste your key, it persists |
+| **Persistent API keys** | Keys saved to provider profile → remembered across restarts |
+| **Token optimization** | 162-agent list moved out of tool description (saves ~5K tokens/turn), CORTEX.md trimmed 85%, Bash git instructions compacted |
+| **162 specialist agents** | All game engine agents (Godot, Unity, Unreal, Roblox, Blender) now properly loaded |
+
+---
+
 ## 📜 License
 
 MIT — do whatever you want, just don't sue me.