neuroncli 2.1.0__py3-none-any.whl

neuroncli-2.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,19 @@
+neuroncli/__init__.py,sha256=1afqRe-VzP5fSHtV8ESg1NAkt8aIV-iwzPqpwizUsYY,459
+neuroncli/__main__.py,sha256=VhqmNxqxsB9O2dAYaKz45CKM2qF447F6uONVdj1bjSE,399
+neuroncli/agent.py,sha256=2gszfWFYLpcbvGy3Ncbgcghl5h0Owds5EjQSs9eS8M0,23031
+neuroncli/auth.py,sha256=CmY6P9Kn6faPIpbFwwPqDBWuPJoq3IDCajdSiWKwxDc,9212
+neuroncli/cli.py,sha256=KjaGTh5bnhzjC0X5bcd923xSEeow0weWAt1sFVa4EC0,14776
+neuroncli/config.py,sha256=8koejcyCgzmqI8th57heflUsmJrpLzZFgtdmFfsffw8,4990
+neuroncli/git_integration.py,sha256=0SQ9Z2K4n6pc1oSJuYU4gaJDiwodzqQ0ghxPXgubImM,2897
+neuroncli/ollama_client.py,sha256=Q5S0IqCsofZL8GaTnHg1f8T-eQ1gHYMOVmyy9PBPur8,5119
+neuroncli/openrouter_client.py,sha256=BC68wAd5djtrfVGZ7v-3Tu9hKjeHC_HBZFCdsJiiOzk,8073
+neuroncli/prompts.py,sha256=Mtmj30gquqCEJ0bMUNATnaKLnTKmxDDDVvPyyDqyVqU,3136
+neuroncli/provider.py,sha256=qI-qspxR-dE3MjTalTaMR0r902Pph5C9aq5awk6Lgwg,1360
+neuroncli/session.py,sha256=SM6-CH3yzUDymHg5XHoXTtuMa3X6Bu3NlFA1IwClvo8,2522
+neuroncli/tools.py,sha256=22cVKP4HTWFdRjKkA3PGfz5mtPDPvZKg4B8S4zCkEAU,15125
+neuroncli/ui.py,sha256=fzZlDo7gr1ZPL-DKOYZqmKqddhVkPXqZrWMHpKwvC2w,4841
+neuroncli-2.1.0.dist-info/METADATA,sha256=Fgp30SUQDQcl0XuB6Z14m9K4Z0beva6ElftycpYvo0o,5641
+neuroncli-2.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+neuroncli-2.1.0.dist-info/entry_points.txt,sha256=2RW-tomVKomWpuskPYGQ2Y2be7kHzYQPHlkvaAYtcLY,46
+neuroncli-2.1.0.dist-info/top_level.txt,sha256=g8s1HMMEb15Lqsh7mDEhca97w_asKRA5eJWV0rgKuHE,10
+neuroncli-2.1.0.dist-info/RECORD,,

neuroncli-2.1.0.dist-info/WHEEL

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

neuroncli-2.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+neuron = neuroncli.cli:main

neuroncli-2.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+neuroncli