neuroncli 2.1.0__tar.gz

neuroncli-2.1.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: neuroncli
+Version: 2.1.0
+Summary: AI Coding Agent — Free Claude Code alternative powered by Kimi K2.5 + Ollama
+Author-email: Rahul S <rahultech72216@gmail.com>
+License: MIT
+Project-URL: Homepage, https://zero-x.live
+Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuroncli
+Project-URL: Issues, https://github.com/RAHUL-DevelopeRR/neuroncli/issues
+Keywords: ai,coding,agent,cli,llm,kimi,ollama,code-assistant
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: License :: OSI Approved :: MIT License
+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: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# NeuronCLI
+
+**Free AI Coding Agent** — Claude Code alternative powered by Kimi K2.5. Works on **Windows, Linux, macOS**.
+
+> Built by [zero-x Corporation](https://zero-x.live)
+
+---
+
+## Install
+
+```bash
+# From PyPI (all platforms)
+pip install neuroncli
+
+# Or from source
+git clone https://github.com/RAHUL-DevelopeRR/neuroncli.git
+cd neuroncli
+pip install -e .
+```
+
+```bash
+# Linux/macOS one-liner
+curl -fsSL https://raw.githubusercontent.com/RAHUL-DevelopeRR/neuroncli/master/install.sh | bash
+```
+
+## Quick Start
+
+```bash
+# Start interactive REPL
+neuron
+
+# One-shot task
+neuron "fix the bug in main.py"
+
+# YOLO mode — no permission prompts
+neuron --yolo "refactor src/ to use async"
+
+# Plan mode — think first, code later
+neuron --plan "add authentication to this API"
+
+# Use local Ollama instead
+neuron --provider ollama "explain this codebase"
+```
+
+## Zero Setup — First Run
+
+1. Type `neuron` in any project directory
+2. Browser opens to **OpenRouter** login (free account)
+3. API key auto-provisioned + saved to `~/.neuroncli/config.json`
+4. **Done.** No manual config, no copy-paste.
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Parallel Tool Execution** | Reads 5 files simultaneously, not one-by-one |
+| **Git Auto-Commit** | Every AI edit is auto-committed like Aider |
+| **Context Compression** | H2A-style compression prevents context bloat |
+| **3 Modes** | Standard (ask permission), Plan (think first), YOLO (full auto) |
+| **Session Persistence** | Resume previous conversations with `/resume` |
+| **Brand Color Output** | Clean terminal output with colored tables, headers |
+| **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
+| **Token Tracking** | Shows token usage per session |
+| **Dual Provider** | OpenRouter (cloud, free) + Ollama (local, offline) |
+
+## Modes
+
+```bash
+neuron                    # Standard — asks before writing/running
+neuron --plan             # Plan — generates plan, waits for approval
+neuron --yolo             # YOLO — full autonomous, no prompts
+```
+
+Switch at runtime: `/mode plan`, `/mode yolo`, `/mode standard`
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents with line numbers |
+| `write_file` | Create or overwrite a file |
+| `edit_file` | Surgical find-and-replace edit |
+| `list_directory` | Tree view of directory contents |
+| `run_command` | Execute shell commands |
+| `search_in_files` | Grep-style search across files |
+| `get_project_structure` | Full project overview |
+
+## REPL Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/init` | Create NEURON.md project context |
+| `/compact` | Compress context (free up memory) |
+| `/mode <mode>` | Switch: standard, plan, yolo |
+| `/model <name>` | Switch model |
+| `/provider <name>` | Switch: openrouter, ollama |
+| `/upgrade` | Info on faster response times |
+| `/clear` | Clear conversation history |
+| `/config` | Show current configuration |
+| `/exit` | Exit |
+
+## CLI Flags
+
+| Flag | Description |
+|------|-------------|
+| `--yolo` | Skip all permission prompts |
+| `--plan` | Plan mode — reason before coding |
+| `--model`, `-m` | Model to use |
+| `--provider`, `-p` | `openrouter` or `ollama` |
+| `--dir`, `-d` | Working directory |
+| `--no-stream` | Disable token streaming |
+
+## Architecture
+
+```
+neuroncli/
+  agent.py              # ReAct engine — parallel tools, context compression
+  auth.py               # OpenRouter OAuth auto-provisioning
+  cli.py                # REPL + slash commands
+  config.py             # Modes (standard/plan/yolo)
+  git_integration.py    # Auto-commit AI edits
+  session.py            # Save/resume conversations
+  prompts.py            # Mode-aware system prompt builder
+  tools.py              # Tool registry + 7 tool implementations
+  ui.py                 # Brand colors, startup screen
+  provider.py           # Provider abstraction layer
+  openrouter_client.py  # OpenRouter (Kimi K2.5)
+  ollama_client.py      # Local Ollama
+tests/
+  test_agent.py         # 18 unit tests
+```
+
+## Requirements
+
+- **Python 3.10+**
+- Internet connection (for Kimi K2.5 via OpenRouter)
+- **Optional:** [Ollama](https://ollama.com) for local offline mode
+
+## License
+
+MIT — free to use, modify, and distribute commercially.
+
+---
+
+*By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*

neuroncli-2.1.0/README.md

@@ -0,0 +1,146 @@
+# NeuronCLI
+
+**Free AI Coding Agent** — Claude Code alternative powered by Kimi K2.5. Works on **Windows, Linux, macOS**.
+
+> Built by [zero-x Corporation](https://zero-x.live)
+
+---
+
+## Install
+
+```bash
+# From PyPI (all platforms)
+pip install neuroncli
+
+# Or from source
+git clone https://github.com/RAHUL-DevelopeRR/neuroncli.git
+cd neuroncli
+pip install -e .
+```
+
+```bash
+# Linux/macOS one-liner
+curl -fsSL https://raw.githubusercontent.com/RAHUL-DevelopeRR/neuroncli/master/install.sh | bash
+```
+
+## Quick Start
+
+```bash
+# Start interactive REPL
+neuron
+
+# One-shot task
+neuron "fix the bug in main.py"
+
+# YOLO mode — no permission prompts
+neuron --yolo "refactor src/ to use async"
+
+# Plan mode — think first, code later
+neuron --plan "add authentication to this API"
+
+# Use local Ollama instead
+neuron --provider ollama "explain this codebase"
+```
+
+## Zero Setup — First Run
+
+1. Type `neuron` in any project directory
+2. Browser opens to **OpenRouter** login (free account)
+3. API key auto-provisioned + saved to `~/.neuroncli/config.json`
+4. **Done.** No manual config, no copy-paste.
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Parallel Tool Execution** | Reads 5 files simultaneously, not one-by-one |
+| **Git Auto-Commit** | Every AI edit is auto-committed like Aider |
+| **Context Compression** | H2A-style compression prevents context bloat |
+| **3 Modes** | Standard (ask permission), Plan (think first), YOLO (full auto) |
+| **Session Persistence** | Resume previous conversations with `/resume` |
+| **Brand Color Output** | Clean terminal output with colored tables, headers |
+| **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
+| **Token Tracking** | Shows token usage per session |
+| **Dual Provider** | OpenRouter (cloud, free) + Ollama (local, offline) |
+
+## Modes
+
+```bash
+neuron                    # Standard — asks before writing/running
+neuron --plan             # Plan — generates plan, waits for approval
+neuron --yolo             # YOLO — full autonomous, no prompts
+```
+
+Switch at runtime: `/mode plan`, `/mode yolo`, `/mode standard`
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents with line numbers |
+| `write_file` | Create or overwrite a file |
+| `edit_file` | Surgical find-and-replace edit |
+| `list_directory` | Tree view of directory contents |
+| `run_command` | Execute shell commands |
+| `search_in_files` | Grep-style search across files |
+| `get_project_structure` | Full project overview |
+
+## REPL Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/init` | Create NEURON.md project context |
+| `/compact` | Compress context (free up memory) |
+| `/mode <mode>` | Switch: standard, plan, yolo |
+| `/model <name>` | Switch model |
+| `/provider <name>` | Switch: openrouter, ollama |
+| `/upgrade` | Info on faster response times |
+| `/clear` | Clear conversation history |
+| `/config` | Show current configuration |
+| `/exit` | Exit |
+
+## CLI Flags
+
+| Flag | Description |
+|------|-------------|
+| `--yolo` | Skip all permission prompts |
+| `--plan` | Plan mode — reason before coding |
+| `--model`, `-m` | Model to use |
+| `--provider`, `-p` | `openrouter` or `ollama` |
+| `--dir`, `-d` | Working directory |
+| `--no-stream` | Disable token streaming |
+
+## Architecture
+
+```
+neuroncli/
+  agent.py              # ReAct engine — parallel tools, context compression
+  auth.py               # OpenRouter OAuth auto-provisioning
+  cli.py                # REPL + slash commands
+  config.py             # Modes (standard/plan/yolo)
+  git_integration.py    # Auto-commit AI edits
+  session.py            # Save/resume conversations
+  prompts.py            # Mode-aware system prompt builder
+  tools.py              # Tool registry + 7 tool implementations
+  ui.py                 # Brand colors, startup screen
+  provider.py           # Provider abstraction layer
+  openrouter_client.py  # OpenRouter (Kimi K2.5)
+  ollama_client.py      # Local Ollama
+tests/
+  test_agent.py         # 18 unit tests
+```
+
+## Requirements
+
+- **Python 3.10+**
+- Internet connection (for Kimi K2.5 via OpenRouter)
+- **Optional:** [Ollama](https://ollama.com) for local offline mode
+
+## License
+
+MIT — free to use, modify, and distribute commercially.
+
+---
+
+*By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*

neuroncli-2.1.0/neuroncli/__init__.py

@@ -0,0 +1,18 @@
+"""NeuronCLI — AI Coding Agent powered by Kimi K2.5 + Ollama."""
+
+from .config import AgentConfig, APP_NAME, VERSION
+from .agent import Agent, AgentResult
+from .provider import ChatMessage, create_provider
+from .auth import ensure_api_key
+from .tools import registry as tool_registry
+
+__version__ = VERSION
+__all__ = [
+    "Agent",
+    "AgentConfig",
+    "AgentResult",
+    "ChatMessage",
+    "create_provider",
+    "ensure_api_key",
+    "tool_registry",
+]

neuroncli-2.1.0/neuroncli/__main__.py

@@ -0,0 +1,14 @@
+"""Allow running as: python -m neuroncli"""
+
+import sys
+import os
+
+# Fix Windows terminal encoding — MUST be before any print()
+if sys.platform == "win32":
+    os.system("")  # Enable ANSI escape codes on Windows
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+
+from neuroncli.cli import main
+
+raise SystemExit(main())