codrninja 0.1.0__tar.gz

codrninja-0.1.0/LICENSE

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

codrninja-0.1.0/PKG-INFO

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: codrninja
+Version: 0.1.0
+Summary: AI-first coding assistant for automation
+Author-email: Milan <your-email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/20ZollCoder/codrninja
+Project-URL: Repository, https://github.com/20ZollCoder/codrninja
+Project-URL: Issues, https://github.com/20ZollCoder/codrninja/issues
+Keywords: ai,coding,automation,ollama,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Dynamic: license-file
+
+# 🥷 codrninja
+
+AI-first coding assistant for automation. A lightweight, programmatic alternative to interactive coding tools like OpenCode or Claude Code.
+
+## 🔌 Multi-Provider Support
+
+Works with **any** AI provider:
+
+| Provider | Setup | Models |
+|----------|-------|--------|
+| **Ollama** (default) | Local server | codellama, llama2, mistral |
+| **OpenAI** | API key | gpt-4, gpt-4-turbo, gpt-3.5 |
+| **Anthropic** | API key | claude-3-opus, claude-3-sonnet |
+| **OpenRouter** | API key | Access to all major models |
+
+### Provider Configuration
+
+```bash
+# Ollama (default)
+export OLLAMA_URL=http://localhost:11434
+export OLLAMA_MODEL=codellama
+
+# OpenAI
+export OPENAI_API_KEY=sk-...
+export CODRNINJA_PROVIDER=openai
+export CODRNINJA_MODEL=gpt-4
+
+# Anthropic
+export ANTHROPIC_API_KEY=sk-ant-...
+export CODRNINJA_PROVIDER=anthropic
+export CODRNINJA_MODEL=claude-3-sonnet-20240229
+
+# OpenRouter
+export OPENROUTER_API_KEY=sk-or-...
+export CODRNINJA_PROVIDER=openrouter
+export CODRNINJA_MODEL=openai/gpt-4
+```
+
+## 🚀 Quick Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/20ZollCoder/codrninja/main/install.sh | bash
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/20ZollCoder/codrninja.git
+cd codrninja
+pip install -e .
+pip install rich  # Optional, for TUI
+```
+
+## ⚡ Quick Start
+
+```bash
+# Set your provider (Ollama is default)
+export OLLAMA_URL=http://localhost:11434
+
+# Or use OpenAI
+# export OPENAI_API_KEY=sk-...
+# export CODRNINJA_PROVIDER=openai
+
+# Start interactive TUI
+codrninja-tui my-project
+
+# Or use agent mode
+codrninja agent my-project "Create a Button component"
+```
+
+## 🎯 Features
+
+### For Humans (TUI Mode)
+- 🎨 Beautiful terminal UI with ASCII art welcome
+- 💻 Syntax highlighting for code blocks
+- 📊 Tool usage tables
+- ⌨️ Slash commands (`/help`, `/files`, `/read`, `/exec`)
+- ⚡ Progress indicators
+
+### For AI Systems (Automation Mode)
+- 🤖 Agent loop with tool execution
+- 🛠️ Read, write, edit files automatically
+- 🔧 Execute shell commands
+- 📤 JSON output for scripting
+- 🧠 Session-based conversations
+
+## 📖 Usage
+
+### Interactive TUI
+
+```bash
+# Start TUI
+codrninja-tui my-project
+
+# Inside TUI:
+You: Create a Button component in React
+🤖 AI: I'll create that for you...
+✅ Tool: write_file → src/components/Button.jsx
+✅ Tool: execute_command → npm test (passed)
+
+You: /read src/components/Button.jsx
+📄 (shows file with syntax highlighting)
+
+You: /exec npm run build
+⚡ (runs build command)
+
+You: /help
+📖 (shows all commands)
+```
+
+### Agent Mode (Scripting)
+
+```bash
+# Set automation mode
+export AI_CODE_MODE=automation
+
+# Run agent with auto-approval
+codrninja agent my-project "Create a login form"
+
+# Continue conversation
+codrninja agent my-project "Add validation to the form"
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `codrninja-tui <session>` | Start interactive TUI |
+| `codrninja agent <session> "msg"` | Run agent with tools |
+| `codrninja send <session> "msg"` | Send message |
+| `codrninja create-session <name>` | Create session |
+| `codrninja show-session <name>` | Show history |
+
+### TUI Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show help |
+| `/files` | List files |
+| `/read <file>` | Read file |
+| `/write <file>` | Write file (interactive) |
+| `/exec <cmd>` | Execute command |
+| `/model` | Show AI model config |
+| `/session` | Show session info |
+| `/clear` | Clear screen |
+| `/exit` | Quit |
+
+## 🔧 Configuration
+
+```bash
+# Environment variables
+export OLLAMA_URL=http://localhost:11434    # Ollama endpoint
+export OLLAMA_MODEL=codellama                 # Default model
+export AI_CODE_MODE=automation                # JSON output mode
+```
+
+## 🆚 Comparison with OpenCode
+
+| Feature | OpenCode | codrninja |
+|---------|----------|-----------|
+| **Size** | ~146MB Go binary | ~8KB Python |
+| **TTY Required** | ❌ Yes | ✅ No |
+| **JSON Output** | ❌ No | ✅ Yes |
+| **Agent Loop** | ✅ Yes | ✅ Yes |
+| **Tool Execution** | ✅ Yes | ✅ Yes |
+| **Session API** | Hidden | Simple CLI |
+| **Installation** | Complex | `pip install` |
+| **Automation** | Limited | First-class |
+
+## 📦 Installation Details
+
+The install script will:
+1. ✅ Check Python and pip
+2. ✅ Install codrninja from PyPI or git
+3. ✅ Install Rich (optional, for TUI)
+4. ✅ Add `~/.local/bin` to PATH
+5. ✅ Create config directory
+6. ✅ Install `codrninja-setup` helper
+
+## 🔗 Links
+
+- **GitHub:** https://github.com/20ZollCoder/codrninja
+- **Issues:** https://github.com/20ZollCoder/codrninja/issues
+
+## 📄 License
+
+MIT

codrninja-0.1.0/README.md

@@ -0,0 +1,187 @@
+# 🥷 codrninja
+
+AI-first coding assistant for automation. A lightweight, programmatic alternative to interactive coding tools like OpenCode or Claude Code.
+
+## 🔌 Multi-Provider Support
+
+Works with **any** AI provider:
+
+| Provider | Setup | Models |
+|----------|-------|--------|
+| **Ollama** (default) | Local server | codellama, llama2, mistral |
+| **OpenAI** | API key | gpt-4, gpt-4-turbo, gpt-3.5 |
+| **Anthropic** | API key | claude-3-opus, claude-3-sonnet |
+| **OpenRouter** | API key | Access to all major models |
+
+### Provider Configuration
+
+```bash
+# Ollama (default)
+export OLLAMA_URL=http://localhost:11434
+export OLLAMA_MODEL=codellama
+
+# OpenAI
+export OPENAI_API_KEY=sk-...
+export CODRNINJA_PROVIDER=openai
+export CODRNINJA_MODEL=gpt-4
+
+# Anthropic
+export ANTHROPIC_API_KEY=sk-ant-...
+export CODRNINJA_PROVIDER=anthropic
+export CODRNINJA_MODEL=claude-3-sonnet-20240229
+
+# OpenRouter
+export OPENROUTER_API_KEY=sk-or-...
+export CODRNINJA_PROVIDER=openrouter
+export CODRNINJA_MODEL=openai/gpt-4
+```
+
+## 🚀 Quick Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/20ZollCoder/codrninja/main/install.sh | bash
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/20ZollCoder/codrninja.git
+cd codrninja
+pip install -e .
+pip install rich  # Optional, for TUI
+```
+
+## ⚡ Quick Start
+
+```bash
+# Set your provider (Ollama is default)
+export OLLAMA_URL=http://localhost:11434
+
+# Or use OpenAI
+# export OPENAI_API_KEY=sk-...
+# export CODRNINJA_PROVIDER=openai
+
+# Start interactive TUI
+codrninja-tui my-project
+
+# Or use agent mode
+codrninja agent my-project "Create a Button component"
+```
+
+## 🎯 Features
+
+### For Humans (TUI Mode)
+- 🎨 Beautiful terminal UI with ASCII art welcome
+- 💻 Syntax highlighting for code blocks
+- 📊 Tool usage tables
+- ⌨️ Slash commands (`/help`, `/files`, `/read`, `/exec`)
+- ⚡ Progress indicators
+
+### For AI Systems (Automation Mode)
+- 🤖 Agent loop with tool execution
+- 🛠️ Read, write, edit files automatically
+- 🔧 Execute shell commands
+- 📤 JSON output for scripting
+- 🧠 Session-based conversations
+
+## 📖 Usage
+
+### Interactive TUI
+
+```bash
+# Start TUI
+codrninja-tui my-project
+
+# Inside TUI:
+You: Create a Button component in React
+🤖 AI: I'll create that for you...
+✅ Tool: write_file → src/components/Button.jsx
+✅ Tool: execute_command → npm test (passed)
+
+You: /read src/components/Button.jsx
+📄 (shows file with syntax highlighting)
+
+You: /exec npm run build
+⚡ (runs build command)
+
+You: /help
+📖 (shows all commands)
+```
+
+### Agent Mode (Scripting)
+
+```bash
+# Set automation mode
+export AI_CODE_MODE=automation
+
+# Run agent with auto-approval
+codrninja agent my-project "Create a login form"
+
+# Continue conversation
+codrninja agent my-project "Add validation to the form"
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `codrninja-tui <session>` | Start interactive TUI |
+| `codrninja agent <session> "msg"` | Run agent with tools |
+| `codrninja send <session> "msg"` | Send message |
+| `codrninja create-session <name>` | Create session |
+| `codrninja show-session <name>` | Show history |
+
+### TUI Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show help |
+| `/files` | List files |
+| `/read <file>` | Read file |
+| `/write <file>` | Write file (interactive) |
+| `/exec <cmd>` | Execute command |
+| `/model` | Show AI model config |
+| `/session` | Show session info |
+| `/clear` | Clear screen |
+| `/exit` | Quit |
+
+## 🔧 Configuration
+
+```bash
+# Environment variables
+export OLLAMA_URL=http://localhost:11434    # Ollama endpoint
+export OLLAMA_MODEL=codellama                 # Default model
+export AI_CODE_MODE=automation                # JSON output mode
+```
+
+## 🆚 Comparison with OpenCode
+
+| Feature | OpenCode | codrninja |
+|---------|----------|-----------|
+| **Size** | ~146MB Go binary | ~8KB Python |
+| **TTY Required** | ❌ Yes | ✅ No |
+| **JSON Output** | ❌ No | ✅ Yes |
+| **Agent Loop** | ✅ Yes | ✅ Yes |
+| **Tool Execution** | ✅ Yes | ✅ Yes |
+| **Session API** | Hidden | Simple CLI |
+| **Installation** | Complex | `pip install` |
+| **Automation** | Limited | First-class |
+
+## 📦 Installation Details
+
+The install script will:
+1. ✅ Check Python and pip
+2. ✅ Install codrninja from PyPI or git
+3. ✅ Install Rich (optional, for TUI)
+4. ✅ Add `~/.local/bin` to PATH
+5. ✅ Create config directory
+6. ✅ Install `codrninja-setup` helper
+
+## 🔗 Links
+
+- **GitHub:** https://github.com/20ZollCoder/codrninja
+- **Issues:** https://github.com/20ZollCoder/codrninja/issues
+
+## 📄 License
+
+MIT

codrninja-0.1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "codrninja"
+version = "0.1.0"
+description = "AI-first coding assistant for automation"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Milan", email = "your-email@example.com"}
+]
+keywords = ["ai", "coding", "automation", "ollama", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "black>=23.0",
+    "flake8>=6.0",
+]
+
+[project.scripts]
+codrninja = "codrninja.cli:main"
+codrninja-tui = "codrninja.tui:main"
+
+[project.urls]
+Homepage = "https://github.com/20ZollCoder/codrninja"
+Repository = "https://github.com/20ZollCoder/codrninja"
+Issues = "https://github.com/20ZollCoder/codrninja/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39']
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

codrninja-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

codrninja-0.1.0/src/codrninja/__init__.py

@@ -0,0 +1,14 @@
+"""
+codrninja: AI-first coding assistant for automation
+"""
+
+__version__ = "0.1.0"
+__author__ = "Milan"
+__license__ = "MIT"
+
+from .core import AICode, Session
+from .config import Config
+from .agent import Agent
+from .providers import ProviderManager, OllamaProvider, OpenAIProvider, AnthropicProvider, OpenRouterProvider
+
+__all__ = ["AICode", "Session", "Config", "Agent", "ProviderManager", "OllamaProvider", "OpenAIProvider", "AnthropicProvider", "OpenRouterProvider"]