neuroncli 3.0.0__tar.gz → 3.1.0__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 (31) hide show
  1. neuroncli-3.1.0/PKG-INFO +132 -0
  2. neuroncli-3.1.0/README.md +107 -0
  3. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/bin/neuron.exe +0 -0
  4. neuroncli-3.1.0/neuroncli.egg-info/PKG-INFO +132 -0
  5. {neuroncli-3.0.0 → neuroncli-3.1.0}/pyproject.toml +1 -1
  6. neuroncli-3.0.0/PKG-INFO +0 -161
  7. neuroncli-3.0.0/README.md +0 -136
  8. neuroncli-3.0.0/neuroncli.egg-info/PKG-INFO +0 -161
  9. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/__init__.py +0 -0
  10. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/__main__.py +0 -0
  11. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/agent.py +0 -0
  12. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/auth.py +0 -0
  13. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/cli.py +0 -0
  14. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/config.py +0 -0
  15. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/git_integration.py +0 -0
  16. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/ollama_client.py +0 -0
  17. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/openrouter_client.py +0 -0
  18. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/prompts.py +0 -0
  19. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/provider.py +0 -0
  20. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/repo_map.py +0 -0
  21. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/session.py +0 -0
  22. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/tools.py +0 -0
  23. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/ui.py +0 -0
  24. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli/validators.py +0 -0
  25. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli.egg-info/SOURCES.txt +0 -0
  26. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli.egg-info/dependency_links.txt +0 -0
  27. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli.egg-info/entry_points.txt +0 -0
  28. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli.egg-info/requires.txt +0 -0
  29. {neuroncli-3.0.0 → neuroncli-3.1.0}/neuroncli.egg-info/top_level.txt +0 -0
  30. {neuroncli-3.0.0 → neuroncli-3.1.0}/setup.cfg +0 -0
  31. {neuroncli-3.0.0 → neuroncli-3.1.0}/tests/test_agent.py +0 -0
@@ -0,0 +1,132 @@
1
+ Metadata-Version: 2.4
2
+ Name: neuroncli
3
+ Version: 3.1.0
4
+ Summary: AI Coding Agent — Free Claude Code alternative. Native Rust binary with plan mode, shell escapes, and Azure AI + OpenRouter support.
5
+ Author-email: Rahul S <rahultech72216@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://zero-x.live
8
+ Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuroncli
9
+ Project-URL: Issues, https://github.com/RAHUL-DevelopeRR/neuroncli/issues
10
+ Keywords: ai,coding,agent,cli,llm,claude-code,rust,code-assistant,neuron
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Topic :: Software Development
15
+ Classifier: Topic :: Software Development :: Code Generators
16
+ Classifier: License :: OSI Approved :: MIT License
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Operating System :: OS Independent
22
+ Requires-Python: >=3.10
23
+ Description-Content-Type: text/markdown
24
+ Requires-Dist: requests>=2.28.0
25
+
26
+ # NeuronCLI
27
+
28
+ **Free AI Coding Agent** — Claude Code alternative. Native Rust binary with Azure AI + OpenRouter support.
29
+
30
+ > Built by [zero-x Corporation](https://zero-x.live)
31
+
32
+ ---
33
+
34
+ ## Install
35
+
36
+ ```bash
37
+ # Windows / macOS / Cloud VMs
38
+ pip install neuroncli
39
+
40
+ # Debian / Ubuntu (Python 3.11+)
41
+ pip install neuroncli --break-system-packages
42
+
43
+ # Or use pipx (recommended for Debian)
44
+ pipx install neuroncli
45
+ ```
46
+
47
+ > **v3.0.0** ships a native Rust binary (14MB) for maximum performance.
48
+ > On systems without the binary, the Python implementation runs as fallback.
49
+
50
+ ## Quick Start
51
+
52
+ ```bash
53
+ # Start interactive REPL
54
+ neuron
55
+
56
+ # One-shot task
57
+ neuron "fix the bug in main.py"
58
+
59
+ # Plan mode — architecture first, execute later
60
+ neuron --plan "add authentication to this API"
61
+
62
+ # YOLO mode — no permission prompts
63
+ neuron --yolo "refactor src/ to use async"
64
+ ```
65
+
66
+ ## Zero Setup — First Run
67
+
68
+ 1. Type `neuron` in any project directory
69
+ 2. Browser opens to **OpenRouter** login (free account)
70
+ 3. API key auto-provisioned + encrypted in `~/.neuroncli/vault.enc`
71
+ 4. **Done.** No manual config, no copy-paste.
72
+
73
+ ## Features
74
+
75
+ | Feature | Description |
76
+ |---------|-------------|
77
+ | **Native Rust Binary** | 14MB single binary, instant startup |
78
+ | **Plan Mode** | `/plan` generates architecture plans, `/plan off` to execute |
79
+ | **? Shortcuts Panel** | Press `?` for Claude Code-style two-column cheatsheet |
80
+ | **Shell Escape** | `!git status`, `!ls` — run commands without burning tokens |
81
+ | **Dynamic Prompt** | Shows current mode: `>`, `[plan] >`, `[edit] >`, `[auto] >` |
82
+ | **Azure AI Foundry** | GPT-5.5 primary (44K tokens/day free quota) |
83
+ | **OpenRouter Fallback** | Free-tier model when Azure quota is exhausted |
84
+ | **Directory Trust** | Interactive security prompt on first use per directory |
85
+ | **Session Persistence** | Resume previous conversations with `/resume` |
86
+ | **Git Auto-Commit** | Every AI edit is auto-committed |
87
+ | **Context Compression** | `/compact` prevents context bloat |
88
+ | **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
89
+
90
+ ## Shortcuts (press `?` in REPL)
91
+
92
+ | Key | Action | Key | Action |
93
+ |-----|--------|-----|--------|
94
+ | `?` | Shortcuts panel | `/help` | Full command list |
95
+ | `!cmd` | Shell command | `/plan` | Toggle plan mode |
96
+ | `Up/Down` | History | `/compact` | Compress context |
97
+ | `Ctrl+C` | Cancel | `/clear` | Reset session |
98
+ | `Ctrl+D` | Exit | `/model` | Switch model |
99
+
100
+ ## Plan Mode
101
+
102
+ ```
103
+ > /plan ← Enter plan mode
104
+ [plan] > add user authentication ← Agent generates architecture plan
105
+ [plan] > /plan off ← Exit plan mode
106
+ > execute the plan ← Agent implements with full access
107
+ ```
108
+
109
+ ## CLI Flags
110
+
111
+ | Flag | Description |
112
+ |------|-------------|
113
+ | `--yolo` | Skip all permission prompts |
114
+ | `--plan` | Plan mode — reason before coding |
115
+ | `--model`, `-m` | Model to use |
116
+ | `--provider`, `-p` | `openrouter` or `ollama` |
117
+ | `--dir`, `-d` | Working directory |
118
+ | `--no-stream` | Disable token streaming |
119
+
120
+ ## Requirements
121
+
122
+ - **Windows:** Works out of the box (native Rust binary)
123
+ - **Linux/macOS:** Python 3.10+ (Python fallback), or install Rust binary separately
124
+ - Internet connection for Azure AI / OpenRouter
125
+
126
+ ## License
127
+
128
+ MIT — free to use, modify, and distribute commercially.
129
+
130
+ ---
131
+
132
+ *By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*
@@ -0,0 +1,107 @@
1
+ # NeuronCLI
2
+
3
+ **Free AI Coding Agent** — Claude Code alternative. Native Rust binary with Azure AI + OpenRouter support.
4
+
5
+ > Built by [zero-x Corporation](https://zero-x.live)
6
+
7
+ ---
8
+
9
+ ## Install
10
+
11
+ ```bash
12
+ # Windows / macOS / Cloud VMs
13
+ pip install neuroncli
14
+
15
+ # Debian / Ubuntu (Python 3.11+)
16
+ pip install neuroncli --break-system-packages
17
+
18
+ # Or use pipx (recommended for Debian)
19
+ pipx install neuroncli
20
+ ```
21
+
22
+ > **v3.0.0** ships a native Rust binary (14MB) for maximum performance.
23
+ > On systems without the binary, the Python implementation runs as fallback.
24
+
25
+ ## Quick Start
26
+
27
+ ```bash
28
+ # Start interactive REPL
29
+ neuron
30
+
31
+ # One-shot task
32
+ neuron "fix the bug in main.py"
33
+
34
+ # Plan mode — architecture first, execute later
35
+ neuron --plan "add authentication to this API"
36
+
37
+ # YOLO mode — no permission prompts
38
+ neuron --yolo "refactor src/ to use async"
39
+ ```
40
+
41
+ ## Zero Setup — First Run
42
+
43
+ 1. Type `neuron` in any project directory
44
+ 2. Browser opens to **OpenRouter** login (free account)
45
+ 3. API key auto-provisioned + encrypted in `~/.neuroncli/vault.enc`
46
+ 4. **Done.** No manual config, no copy-paste.
47
+
48
+ ## Features
49
+
50
+ | Feature | Description |
51
+ |---------|-------------|
52
+ | **Native Rust Binary** | 14MB single binary, instant startup |
53
+ | **Plan Mode** | `/plan` generates architecture plans, `/plan off` to execute |
54
+ | **? Shortcuts Panel** | Press `?` for Claude Code-style two-column cheatsheet |
55
+ | **Shell Escape** | `!git status`, `!ls` — run commands without burning tokens |
56
+ | **Dynamic Prompt** | Shows current mode: `>`, `[plan] >`, `[edit] >`, `[auto] >` |
57
+ | **Azure AI Foundry** | GPT-5.5 primary (44K tokens/day free quota) |
58
+ | **OpenRouter Fallback** | Free-tier model when Azure quota is exhausted |
59
+ | **Directory Trust** | Interactive security prompt on first use per directory |
60
+ | **Session Persistence** | Resume previous conversations with `/resume` |
61
+ | **Git Auto-Commit** | Every AI edit is auto-committed |
62
+ | **Context Compression** | `/compact` prevents context bloat |
63
+ | **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
64
+
65
+ ## Shortcuts (press `?` in REPL)
66
+
67
+ | Key | Action | Key | Action |
68
+ |-----|--------|-----|--------|
69
+ | `?` | Shortcuts panel | `/help` | Full command list |
70
+ | `!cmd` | Shell command | `/plan` | Toggle plan mode |
71
+ | `Up/Down` | History | `/compact` | Compress context |
72
+ | `Ctrl+C` | Cancel | `/clear` | Reset session |
73
+ | `Ctrl+D` | Exit | `/model` | Switch model |
74
+
75
+ ## Plan Mode
76
+
77
+ ```
78
+ > /plan ← Enter plan mode
79
+ [plan] > add user authentication ← Agent generates architecture plan
80
+ [plan] > /plan off ← Exit plan mode
81
+ > execute the plan ← Agent implements with full access
82
+ ```
83
+
84
+ ## CLI Flags
85
+
86
+ | Flag | Description |
87
+ |------|-------------|
88
+ | `--yolo` | Skip all permission prompts |
89
+ | `--plan` | Plan mode — reason before coding |
90
+ | `--model`, `-m` | Model to use |
91
+ | `--provider`, `-p` | `openrouter` or `ollama` |
92
+ | `--dir`, `-d` | Working directory |
93
+ | `--no-stream` | Disable token streaming |
94
+
95
+ ## Requirements
96
+
97
+ - **Windows:** Works out of the box (native Rust binary)
98
+ - **Linux/macOS:** Python 3.10+ (Python fallback), or install Rust binary separately
99
+ - Internet connection for Azure AI / OpenRouter
100
+
101
+ ## License
102
+
103
+ MIT — free to use, modify, and distribute commercially.
104
+
105
+ ---
106
+
107
+ *By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*
@@ -0,0 +1,132 @@
1
+ Metadata-Version: 2.4
2
+ Name: neuroncli
3
+ Version: 3.1.0
4
+ Summary: AI Coding Agent — Free Claude Code alternative. Native Rust binary with plan mode, shell escapes, and Azure AI + OpenRouter support.
5
+ Author-email: Rahul S <rahultech72216@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://zero-x.live
8
+ Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuroncli
9
+ Project-URL: Issues, https://github.com/RAHUL-DevelopeRR/neuroncli/issues
10
+ Keywords: ai,coding,agent,cli,llm,claude-code,rust,code-assistant,neuron
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Topic :: Software Development
15
+ Classifier: Topic :: Software Development :: Code Generators
16
+ Classifier: License :: OSI Approved :: MIT License
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Operating System :: OS Independent
22
+ Requires-Python: >=3.10
23
+ Description-Content-Type: text/markdown
24
+ Requires-Dist: requests>=2.28.0
25
+
26
+ # NeuronCLI
27
+
28
+ **Free AI Coding Agent** — Claude Code alternative. Native Rust binary with Azure AI + OpenRouter support.
29
+
30
+ > Built by [zero-x Corporation](https://zero-x.live)
31
+
32
+ ---
33
+
34
+ ## Install
35
+
36
+ ```bash
37
+ # Windows / macOS / Cloud VMs
38
+ pip install neuroncli
39
+
40
+ # Debian / Ubuntu (Python 3.11+)
41
+ pip install neuroncli --break-system-packages
42
+
43
+ # Or use pipx (recommended for Debian)
44
+ pipx install neuroncli
45
+ ```
46
+
47
+ > **v3.0.0** ships a native Rust binary (14MB) for maximum performance.
48
+ > On systems without the binary, the Python implementation runs as fallback.
49
+
50
+ ## Quick Start
51
+
52
+ ```bash
53
+ # Start interactive REPL
54
+ neuron
55
+
56
+ # One-shot task
57
+ neuron "fix the bug in main.py"
58
+
59
+ # Plan mode — architecture first, execute later
60
+ neuron --plan "add authentication to this API"
61
+
62
+ # YOLO mode — no permission prompts
63
+ neuron --yolo "refactor src/ to use async"
64
+ ```
65
+
66
+ ## Zero Setup — First Run
67
+
68
+ 1. Type `neuron` in any project directory
69
+ 2. Browser opens to **OpenRouter** login (free account)
70
+ 3. API key auto-provisioned + encrypted in `~/.neuroncli/vault.enc`
71
+ 4. **Done.** No manual config, no copy-paste.
72
+
73
+ ## Features
74
+
75
+ | Feature | Description |
76
+ |---------|-------------|
77
+ | **Native Rust Binary** | 14MB single binary, instant startup |
78
+ | **Plan Mode** | `/plan` generates architecture plans, `/plan off` to execute |
79
+ | **? Shortcuts Panel** | Press `?` for Claude Code-style two-column cheatsheet |
80
+ | **Shell Escape** | `!git status`, `!ls` — run commands without burning tokens |
81
+ | **Dynamic Prompt** | Shows current mode: `>`, `[plan] >`, `[edit] >`, `[auto] >` |
82
+ | **Azure AI Foundry** | GPT-5.5 primary (44K tokens/day free quota) |
83
+ | **OpenRouter Fallback** | Free-tier model when Azure quota is exhausted |
84
+ | **Directory Trust** | Interactive security prompt on first use per directory |
85
+ | **Session Persistence** | Resume previous conversations with `/resume` |
86
+ | **Git Auto-Commit** | Every AI edit is auto-committed |
87
+ | **Context Compression** | `/compact` prevents context bloat |
88
+ | **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
89
+
90
+ ## Shortcuts (press `?` in REPL)
91
+
92
+ | Key | Action | Key | Action |
93
+ |-----|--------|-----|--------|
94
+ | `?` | Shortcuts panel | `/help` | Full command list |
95
+ | `!cmd` | Shell command | `/plan` | Toggle plan mode |
96
+ | `Up/Down` | History | `/compact` | Compress context |
97
+ | `Ctrl+C` | Cancel | `/clear` | Reset session |
98
+ | `Ctrl+D` | Exit | `/model` | Switch model |
99
+
100
+ ## Plan Mode
101
+
102
+ ```
103
+ > /plan ← Enter plan mode
104
+ [plan] > add user authentication ← Agent generates architecture plan
105
+ [plan] > /plan off ← Exit plan mode
106
+ > execute the plan ← Agent implements with full access
107
+ ```
108
+
109
+ ## CLI Flags
110
+
111
+ | Flag | Description |
112
+ |------|-------------|
113
+ | `--yolo` | Skip all permission prompts |
114
+ | `--plan` | Plan mode — reason before coding |
115
+ | `--model`, `-m` | Model to use |
116
+ | `--provider`, `-p` | `openrouter` or `ollama` |
117
+ | `--dir`, `-d` | Working directory |
118
+ | `--no-stream` | Disable token streaming |
119
+
120
+ ## Requirements
121
+
122
+ - **Windows:** Works out of the box (native Rust binary)
123
+ - **Linux/macOS:** Python 3.10+ (Python fallback), or install Rust binary separately
124
+ - Internet connection for Azure AI / OpenRouter
125
+
126
+ ## License
127
+
128
+ MIT — free to use, modify, and distribute commercially.
129
+
130
+ ---
131
+
132
+ *By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "neuroncli"
7
- version = "3.0.0"
7
+ version = "3.1.0"
8
8
  description = "AI Coding Agent — Free Claude Code alternative. Native Rust binary with plan mode, shell escapes, and Azure AI + OpenRouter support."
9
9
  readme = "README.md"
10
10
  license = {text = "MIT"}
neuroncli-3.0.0/PKG-INFO DELETED
@@ -1,161 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: neuroncli
3
- Version: 3.0.0
4
- Summary: AI Coding Agent — Free Claude Code alternative. Native Rust binary with plan mode, shell escapes, and Azure AI + OpenRouter support.
5
- Author-email: Rahul S <rahultech72216@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://zero-x.live
8
- Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuroncli
9
- Project-URL: Issues, https://github.com/RAHUL-DevelopeRR/neuroncli/issues
10
- Keywords: ai,coding,agent,cli,llm,claude-code,rust,code-assistant,neuron
11
- Classifier: Development Status :: 4 - Beta
12
- Classifier: Environment :: Console
13
- Classifier: Intended Audience :: Developers
14
- Classifier: Topic :: Software Development
15
- Classifier: Topic :: Software Development :: Code Generators
16
- Classifier: License :: OSI Approved :: MIT License
17
- Classifier: Programming Language :: Python :: 3.10
18
- Classifier: Programming Language :: Python :: 3.11
19
- Classifier: Programming Language :: Python :: 3.12
20
- Classifier: Programming Language :: Python :: 3.13
21
- Classifier: Operating System :: OS Independent
22
- Requires-Python: >=3.10
23
- Description-Content-Type: text/markdown
24
- Requires-Dist: requests>=2.28.0
25
-
26
- # NeuronCLI
27
-
28
- **Free AI Coding Agent** — Claude Code alternative powered by Kimi K2.5. Works on **Windows, Linux, macOS**.
29
-
30
- > Built by [zero-x Corporation](https://zero-x.live)
31
-
32
- ---
33
-
34
- ## Install
35
-
36
- ```bash
37
- pip install neuroncli # Windows / macOS / Cloud VMs
38
- pip install neuroncli --break-system-packages # Linux (Ubuntu 23+, Debian 12+, Fedora 38+)
39
- ```
40
-
41
- ## Quick Start
42
-
43
- ```bash
44
- # Start interactive REPL
45
- neuron
46
-
47
- # One-shot task
48
- neuron "fix the bug in main.py"
49
-
50
- # YOLO mode — no permission prompts
51
- neuron --yolo "refactor src/ to use async"
52
-
53
- # Plan mode — think first, code later
54
- neuron --plan "add authentication to this API"
55
-
56
- # Use local Ollama instead
57
- neuron --provider ollama "explain this codebase"
58
- ```
59
-
60
- ## Zero Setup — First Run
61
-
62
- 1. Type `neuron` in any project directory
63
- 2. Browser opens to **OpenRouter** login (free account)
64
- 3. API key auto-provisioned + saved to `~/.neuroncli/config.json`
65
- 4. **Done.** No manual config, no copy-paste.
66
-
67
- ## Features
68
-
69
- | Feature | Description |
70
- |---------|-------------|
71
- | **Parallel Tool Execution** | Reads 5 files simultaneously, not one-by-one |
72
- | **Git Auto-Commit** | Every AI edit is auto-committed like Aider |
73
- | **Context Compression** | H2A-style compression prevents context bloat |
74
- | **3 Modes** | Standard (ask permission), Plan (think first), YOLO (full auto) |
75
- | **Session Persistence** | Resume previous conversations with `/resume` |
76
- | **Brand Color Output** | Clean terminal output with colored tables, headers |
77
- | **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
78
- | **Token Tracking** | Shows token usage per session |
79
- | **Dual Provider** | OpenRouter (cloud, free) + Ollama (local, offline) |
80
-
81
- ## Modes
82
-
83
- ```bash
84
- neuron # Standard — asks before writing/running
85
- neuron --plan # Plan — generates plan, waits for approval
86
- neuron --yolo # YOLO — full autonomous, no prompts
87
- ```
88
-
89
- Switch at runtime: `/mode plan`, `/mode yolo`, `/mode standard`
90
-
91
- ## Available Tools
92
-
93
- | Tool | Description |
94
- |------|-------------|
95
- | `read_file` | Read file contents with line numbers |
96
- | `write_file` | Create or overwrite a file |
97
- | `edit_file` | Surgical find-and-replace edit |
98
- | `list_directory` | Tree view of directory contents |
99
- | `run_command` | Execute shell commands |
100
- | `search_in_files` | Grep-style search across files |
101
- | `get_project_structure` | Full project overview |
102
-
103
- ## REPL Commands
104
-
105
- | Command | Description |
106
- |---------|-------------|
107
- | `/help` | Show all commands |
108
- | `/init` | Create NEURON.md project context |
109
- | `/compact` | Compress context (free up memory) |
110
- | `/mode <mode>` | Switch: standard, plan, yolo |
111
- | `/model <name>` | Switch model |
112
- | `/provider <name>` | Switch: openrouter, ollama |
113
- | `/upgrade` | Info on faster response times |
114
- | `/clear` | Clear conversation history |
115
- | `/config` | Show current configuration |
116
- | `/exit` | Exit |
117
-
118
- ## CLI Flags
119
-
120
- | Flag | Description |
121
- |------|-------------|
122
- | `--yolo` | Skip all permission prompts |
123
- | `--plan` | Plan mode — reason before coding |
124
- | `--model`, `-m` | Model to use |
125
- | `--provider`, `-p` | `openrouter` or `ollama` |
126
- | `--dir`, `-d` | Working directory |
127
- | `--no-stream` | Disable token streaming |
128
-
129
- ## Architecture
130
-
131
- ```
132
- neuroncli/
133
- agent.py # ReAct engine — parallel tools, context compression
134
- auth.py # OpenRouter OAuth auto-provisioning
135
- cli.py # REPL + slash commands
136
- config.py # Modes (standard/plan/yolo)
137
- git_integration.py # Auto-commit AI edits
138
- session.py # Save/resume conversations
139
- prompts.py # Mode-aware system prompt builder
140
- tools.py # Tool registry + 7 tool implementations
141
- ui.py # Brand colors, startup screen
142
- provider.py # Provider abstraction layer
143
- openrouter_client.py # OpenRouter (Kimi K2.5)
144
- ollama_client.py # Local Ollama
145
- tests/
146
- test_agent.py # 18 unit tests
147
- ```
148
-
149
- ## Requirements
150
-
151
- - **Python 3.10+**
152
- - Internet connection (for Kimi K2.5 via OpenRouter)
153
- - **Optional:** [Ollama](https://ollama.com) for local offline mode
154
-
155
- ## License
156
-
157
- MIT — free to use, modify, and distribute commercially.
158
-
159
- ---
160
-
161
- *By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*
neuroncli-3.0.0/README.md DELETED
@@ -1,136 +0,0 @@
1
- # NeuronCLI
2
-
3
- **Free AI Coding Agent** — Claude Code alternative powered by Kimi K2.5. Works on **Windows, Linux, macOS**.
4
-
5
- > Built by [zero-x Corporation](https://zero-x.live)
6
-
7
- ---
8
-
9
- ## Install
10
-
11
- ```bash
12
- pip install neuroncli # Windows / macOS / Cloud VMs
13
- pip install neuroncli --break-system-packages # Linux (Ubuntu 23+, Debian 12+, Fedora 38+)
14
- ```
15
-
16
- ## Quick Start
17
-
18
- ```bash
19
- # Start interactive REPL
20
- neuron
21
-
22
- # One-shot task
23
- neuron "fix the bug in main.py"
24
-
25
- # YOLO mode — no permission prompts
26
- neuron --yolo "refactor src/ to use async"
27
-
28
- # Plan mode — think first, code later
29
- neuron --plan "add authentication to this API"
30
-
31
- # Use local Ollama instead
32
- neuron --provider ollama "explain this codebase"
33
- ```
34
-
35
- ## Zero Setup — First Run
36
-
37
- 1. Type `neuron` in any project directory
38
- 2. Browser opens to **OpenRouter** login (free account)
39
- 3. API key auto-provisioned + saved to `~/.neuroncli/config.json`
40
- 4. **Done.** No manual config, no copy-paste.
41
-
42
- ## Features
43
-
44
- | Feature | Description |
45
- |---------|-------------|
46
- | **Parallel Tool Execution** | Reads 5 files simultaneously, not one-by-one |
47
- | **Git Auto-Commit** | Every AI edit is auto-committed like Aider |
48
- | **Context Compression** | H2A-style compression prevents context bloat |
49
- | **3 Modes** | Standard (ask permission), Plan (think first), YOLO (full auto) |
50
- | **Session Persistence** | Resume previous conversations with `/resume` |
51
- | **Brand Color Output** | Clean terminal output with colored tables, headers |
52
- | **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
53
- | **Token Tracking** | Shows token usage per session |
54
- | **Dual Provider** | OpenRouter (cloud, free) + Ollama (local, offline) |
55
-
56
- ## Modes
57
-
58
- ```bash
59
- neuron # Standard — asks before writing/running
60
- neuron --plan # Plan — generates plan, waits for approval
61
- neuron --yolo # YOLO — full autonomous, no prompts
62
- ```
63
-
64
- Switch at runtime: `/mode plan`, `/mode yolo`, `/mode standard`
65
-
66
- ## Available Tools
67
-
68
- | Tool | Description |
69
- |------|-------------|
70
- | `read_file` | Read file contents with line numbers |
71
- | `write_file` | Create or overwrite a file |
72
- | `edit_file` | Surgical find-and-replace edit |
73
- | `list_directory` | Tree view of directory contents |
74
- | `run_command` | Execute shell commands |
75
- | `search_in_files` | Grep-style search across files |
76
- | `get_project_structure` | Full project overview |
77
-
78
- ## REPL Commands
79
-
80
- | Command | Description |
81
- |---------|-------------|
82
- | `/help` | Show all commands |
83
- | `/init` | Create NEURON.md project context |
84
- | `/compact` | Compress context (free up memory) |
85
- | `/mode <mode>` | Switch: standard, plan, yolo |
86
- | `/model <name>` | Switch model |
87
- | `/provider <name>` | Switch: openrouter, ollama |
88
- | `/upgrade` | Info on faster response times |
89
- | `/clear` | Clear conversation history |
90
- | `/config` | Show current configuration |
91
- | `/exit` | Exit |
92
-
93
- ## CLI Flags
94
-
95
- | Flag | Description |
96
- |------|-------------|
97
- | `--yolo` | Skip all permission prompts |
98
- | `--plan` | Plan mode — reason before coding |
99
- | `--model`, `-m` | Model to use |
100
- | `--provider`, `-p` | `openrouter` or `ollama` |
101
- | `--dir`, `-d` | Working directory |
102
- | `--no-stream` | Disable token streaming |
103
-
104
- ## Architecture
105
-
106
- ```
107
- neuroncli/
108
- agent.py # ReAct engine — parallel tools, context compression
109
- auth.py # OpenRouter OAuth auto-provisioning
110
- cli.py # REPL + slash commands
111
- config.py # Modes (standard/plan/yolo)
112
- git_integration.py # Auto-commit AI edits
113
- session.py # Save/resume conversations
114
- prompts.py # Mode-aware system prompt builder
115
- tools.py # Tool registry + 7 tool implementations
116
- ui.py # Brand colors, startup screen
117
- provider.py # Provider abstraction layer
118
- openrouter_client.py # OpenRouter (Kimi K2.5)
119
- ollama_client.py # Local Ollama
120
- tests/
121
- test_agent.py # 18 unit tests
122
- ```
123
-
124
- ## Requirements
125
-
126
- - **Python 3.10+**
127
- - Internet connection (for Kimi K2.5 via OpenRouter)
128
- - **Optional:** [Ollama](https://ollama.com) for local offline mode
129
-
130
- ## License
131
-
132
- MIT — free to use, modify, and distribute commercially.
133
-
134
- ---
135
-
136
- *By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*
@@ -1,161 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: neuroncli
3
- Version: 3.0.0
4
- Summary: AI Coding Agent — Free Claude Code alternative. Native Rust binary with plan mode, shell escapes, and Azure AI + OpenRouter support.
5
- Author-email: Rahul S <rahultech72216@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://zero-x.live
8
- Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuroncli
9
- Project-URL: Issues, https://github.com/RAHUL-DevelopeRR/neuroncli/issues
10
- Keywords: ai,coding,agent,cli,llm,claude-code,rust,code-assistant,neuron
11
- Classifier: Development Status :: 4 - Beta
12
- Classifier: Environment :: Console
13
- Classifier: Intended Audience :: Developers
14
- Classifier: Topic :: Software Development
15
- Classifier: Topic :: Software Development :: Code Generators
16
- Classifier: License :: OSI Approved :: MIT License
17
- Classifier: Programming Language :: Python :: 3.10
18
- Classifier: Programming Language :: Python :: 3.11
19
- Classifier: Programming Language :: Python :: 3.12
20
- Classifier: Programming Language :: Python :: 3.13
21
- Classifier: Operating System :: OS Independent
22
- Requires-Python: >=3.10
23
- Description-Content-Type: text/markdown
24
- Requires-Dist: requests>=2.28.0
25
-
26
- # NeuronCLI
27
-
28
- **Free AI Coding Agent** — Claude Code alternative powered by Kimi K2.5. Works on **Windows, Linux, macOS**.
29
-
30
- > Built by [zero-x Corporation](https://zero-x.live)
31
-
32
- ---
33
-
34
- ## Install
35
-
36
- ```bash
37
- pip install neuroncli # Windows / macOS / Cloud VMs
38
- pip install neuroncli --break-system-packages # Linux (Ubuntu 23+, Debian 12+, Fedora 38+)
39
- ```
40
-
41
- ## Quick Start
42
-
43
- ```bash
44
- # Start interactive REPL
45
- neuron
46
-
47
- # One-shot task
48
- neuron "fix the bug in main.py"
49
-
50
- # YOLO mode — no permission prompts
51
- neuron --yolo "refactor src/ to use async"
52
-
53
- # Plan mode — think first, code later
54
- neuron --plan "add authentication to this API"
55
-
56
- # Use local Ollama instead
57
- neuron --provider ollama "explain this codebase"
58
- ```
59
-
60
- ## Zero Setup — First Run
61
-
62
- 1. Type `neuron` in any project directory
63
- 2. Browser opens to **OpenRouter** login (free account)
64
- 3. API key auto-provisioned + saved to `~/.neuroncli/config.json`
65
- 4. **Done.** No manual config, no copy-paste.
66
-
67
- ## Features
68
-
69
- | Feature | Description |
70
- |---------|-------------|
71
- | **Parallel Tool Execution** | Reads 5 files simultaneously, not one-by-one |
72
- | **Git Auto-Commit** | Every AI edit is auto-committed like Aider |
73
- | **Context Compression** | H2A-style compression prevents context bloat |
74
- | **3 Modes** | Standard (ask permission), Plan (think first), YOLO (full auto) |
75
- | **Session Persistence** | Resume previous conversations with `/resume` |
76
- | **Brand Color Output** | Clean terminal output with colored tables, headers |
77
- | **NEURON.md** | Project context file (like Claude's CLAUDE.md) |
78
- | **Token Tracking** | Shows token usage per session |
79
- | **Dual Provider** | OpenRouter (cloud, free) + Ollama (local, offline) |
80
-
81
- ## Modes
82
-
83
- ```bash
84
- neuron # Standard — asks before writing/running
85
- neuron --plan # Plan — generates plan, waits for approval
86
- neuron --yolo # YOLO — full autonomous, no prompts
87
- ```
88
-
89
- Switch at runtime: `/mode plan`, `/mode yolo`, `/mode standard`
90
-
91
- ## Available Tools
92
-
93
- | Tool | Description |
94
- |------|-------------|
95
- | `read_file` | Read file contents with line numbers |
96
- | `write_file` | Create or overwrite a file |
97
- | `edit_file` | Surgical find-and-replace edit |
98
- | `list_directory` | Tree view of directory contents |
99
- | `run_command` | Execute shell commands |
100
- | `search_in_files` | Grep-style search across files |
101
- | `get_project_structure` | Full project overview |
102
-
103
- ## REPL Commands
104
-
105
- | Command | Description |
106
- |---------|-------------|
107
- | `/help` | Show all commands |
108
- | `/init` | Create NEURON.md project context |
109
- | `/compact` | Compress context (free up memory) |
110
- | `/mode <mode>` | Switch: standard, plan, yolo |
111
- | `/model <name>` | Switch model |
112
- | `/provider <name>` | Switch: openrouter, ollama |
113
- | `/upgrade` | Info on faster response times |
114
- | `/clear` | Clear conversation history |
115
- | `/config` | Show current configuration |
116
- | `/exit` | Exit |
117
-
118
- ## CLI Flags
119
-
120
- | Flag | Description |
121
- |------|-------------|
122
- | `--yolo` | Skip all permission prompts |
123
- | `--plan` | Plan mode — reason before coding |
124
- | `--model`, `-m` | Model to use |
125
- | `--provider`, `-p` | `openrouter` or `ollama` |
126
- | `--dir`, `-d` | Working directory |
127
- | `--no-stream` | Disable token streaming |
128
-
129
- ## Architecture
130
-
131
- ```
132
- neuroncli/
133
- agent.py # ReAct engine — parallel tools, context compression
134
- auth.py # OpenRouter OAuth auto-provisioning
135
- cli.py # REPL + slash commands
136
- config.py # Modes (standard/plan/yolo)
137
- git_integration.py # Auto-commit AI edits
138
- session.py # Save/resume conversations
139
- prompts.py # Mode-aware system prompt builder
140
- tools.py # Tool registry + 7 tool implementations
141
- ui.py # Brand colors, startup screen
142
- provider.py # Provider abstraction layer
143
- openrouter_client.py # OpenRouter (Kimi K2.5)
144
- ollama_client.py # Local Ollama
145
- tests/
146
- test_agent.py # 18 unit tests
147
- ```
148
-
149
- ## Requirements
150
-
151
- - **Python 3.10+**
152
- - Internet connection (for Kimi K2.5 via OpenRouter)
153
- - **Optional:** [Ollama](https://ollama.com) for local offline mode
154
-
155
- ## License
156
-
157
- MIT — free to use, modify, and distribute commercially.
158
-
159
- ---
160
-
161
- *By [zero-x Corporation](https://zero-x.live) — Tamil Nadu, India*
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes