neuroncli 4.0.1__tar.gz → 6.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 (37) hide show
  1. neuroncli-6.1.0/PKG-INFO +151 -0
  2. neuroncli-6.1.0/README.md +133 -0
  3. neuroncli-6.1.0/neuron_cli/__init__.py +43 -0
  4. {neuroncli-4.0.1/neuroncli/bin → neuroncli-6.1.0/neuron_cli}/neuron.exe +0 -0
  5. neuroncli-6.1.0/neuroncli.egg-info/PKG-INFO +151 -0
  6. neuroncli-6.1.0/neuroncli.egg-info/SOURCES.txt +10 -0
  7. neuroncli-6.1.0/neuroncli.egg-info/entry_points.txt +2 -0
  8. neuroncli-6.1.0/neuroncli.egg-info/top_level.txt +1 -0
  9. neuroncli-6.1.0/pyproject.toml +37 -0
  10. neuroncli-6.1.0/tests/test_porting_workspace.py +248 -0
  11. neuroncli-4.0.1/PKG-INFO +0 -132
  12. neuroncli-4.0.1/README.md +0 -107
  13. neuroncli-4.0.1/neuroncli/__init__.py +0 -18
  14. neuroncli-4.0.1/neuroncli/__main__.py +0 -14
  15. neuroncli-4.0.1/neuroncli/agent.py +0 -544
  16. neuroncli-4.0.1/neuroncli/auth.py +0 -385
  17. neuroncli-4.0.1/neuroncli/cli.py +0 -452
  18. neuroncli-4.0.1/neuroncli/config.py +0 -112
  19. neuroncli-4.0.1/neuroncli/git_integration.py +0 -86
  20. neuroncli-4.0.1/neuroncli/ollama_client.py +0 -150
  21. neuroncli-4.0.1/neuroncli/openrouter_client.py +0 -231
  22. neuroncli-4.0.1/neuroncli/prompts.py +0 -109
  23. neuroncli-4.0.1/neuroncli/provider.py +0 -45
  24. neuroncli-4.0.1/neuroncli/repo_map.py +0 -212
  25. neuroncli-4.0.1/neuroncli/session.py +0 -88
  26. neuroncli-4.0.1/neuroncli/tools.py +0 -413
  27. neuroncli-4.0.1/neuroncli/ui.py +0 -138
  28. neuroncli-4.0.1/neuroncli/validators.py +0 -169
  29. neuroncli-4.0.1/neuroncli.egg-info/PKG-INFO +0 -132
  30. neuroncli-4.0.1/neuroncli.egg-info/SOURCES.txt +0 -26
  31. neuroncli-4.0.1/neuroncli.egg-info/entry_points.txt +0 -2
  32. neuroncli-4.0.1/neuroncli.egg-info/requires.txt +0 -1
  33. neuroncli-4.0.1/neuroncli.egg-info/top_level.txt +0 -1
  34. neuroncli-4.0.1/pyproject.toml +0 -48
  35. neuroncli-4.0.1/tests/test_agent.py +0 -170
  36. {neuroncli-4.0.1 → neuroncli-6.1.0}/neuroncli.egg-info/dependency_links.txt +0 -0
  37. {neuroncli-4.0.1 → neuroncli-6.1.0}/setup.cfg +0 -0
@@ -0,0 +1,151 @@
1
+ Metadata-Version: 2.4
2
+ Name: neuroncli
3
+ Version: 6.1.0
4
+ Summary: NeuronCLI - AI-powered terminal assistant
5
+ Author: RAHUL-DevelopeRR
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/RAHUL-DevelopeRR/neuron-v2
8
+ Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuron-v2
9
+ Classifier: Development Status :: 4 - Beta
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: License :: OSI Approved :: MIT License
12
+ Classifier: Operating System :: Microsoft :: Windows
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Rust
15
+ Classifier: Topic :: Software Development
16
+ Requires-Python: >=3.8
17
+ Description-Content-Type: text/markdown
18
+
19
+ # Claw Code
20
+
21
+ <p align="center">
22
+ <a href="https://github.com/ultraworkers/claw-code">ultraworkers/claw-code</a>
23
+ ·
24
+ <a href="./USAGE.md">Usage</a>
25
+ ·
26
+ <a href="./rust/README.md">Rust workspace</a>
27
+ ·
28
+ <a href="./PARITY.md">Parity</a>
29
+ ·
30
+ <a href="./ROADMAP.md">Roadmap</a>
31
+ ·
32
+ <a href="https://discord.gg/5TUQKqFWd">UltraWorkers Discord</a>
33
+ </p>
34
+
35
+ <p align="center">
36
+ <a href="https://star-history.com/#ultraworkers/claw-code&Date">
37
+ <picture>
38
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date&theme=dark" />
39
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" />
40
+ <img alt="Star history for ultraworkers/claw-code" src="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" width="600" />
41
+ </picture>
42
+ </a>
43
+ </p>
44
+
45
+ <p align="center">
46
+ <img src="assets/claw-hero.jpeg" alt="Claw Code" width="300" />
47
+ </p>
48
+
49
+ Claw Code is the public Rust implementation of the `claw` CLI agent harness.
50
+ The canonical implementation lives in [`rust/`](./rust), and the current source of truth for this repository is **ultraworkers/claw-code**.
51
+
52
+ > [!IMPORTANT]
53
+ > Start with [`USAGE.md`](./USAGE.md) for build, auth, CLI, session, and parity-harness workflows. Make `claw doctor` your first health check after building, use [`rust/README.md`](./rust/README.md) for crate-level details, read [`PARITY.md`](./PARITY.md) for the current Rust-port checkpoint, and see [`docs/container.md`](./docs/container.md) for the container-first workflow.
54
+ >
55
+ > **ACP / Zed status:** `claw-code` does not ship an ACP/Zed daemon entrypoint yet. Run `claw acp` (or `claw --acp`) for the current status instead of guessing from source layout; `claw acp serve` is currently a discoverability alias only, and real ACP support remains tracked separately in `ROADMAP.md`.
56
+
57
+ ## Current repository shape
58
+
59
+ - **`rust/`** — canonical Rust workspace and the `claw` CLI binary
60
+ - **`USAGE.md`** — task-oriented usage guide for the current product surface
61
+ - **`PARITY.md`** — Rust-port parity status and migration notes
62
+ - **`ROADMAP.md`** — active roadmap and cleanup backlog
63
+ - **`PHILOSOPHY.md`** — project intent and system-design framing
64
+ - **`src/` + `tests/`** — companion Python/reference workspace and audit helpers; not the primary runtime surface
65
+
66
+ ## Quick start
67
+
68
+ > [!NOTE]
69
+ > [!WARNING]
70
+ > **`cargo install claw-code` installs the wrong thing.** The `claw-code` crate on crates.io is a deprecated stub that places `claw-code-deprecated.exe` — not `claw`. Running it only prints `"claw-code has been renamed to agent-code"`. **Do not use `cargo install claw-code`.** Either build from source (this repo) or install the upstream binary:
71
+ > ```bash
72
+ > cargo install agent-code # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code'
73
+ > ```
74
+ > This repo (`ultraworkers/claw-code`) is **build-from-source only** — follow the steps below.
75
+
76
+ ```bash
77
+ # 1. Clone and build
78
+ git clone https://github.com/ultraworkers/claw-code
79
+ cd claw-code/rust
80
+ cargo build --workspace
81
+
82
+ # 2. Set your API key (Anthropic API key — not a Claude subscription)
83
+ export ANTHROPIC_API_KEY="sk-ant-..."
84
+
85
+ # 3. Verify everything is wired correctly
86
+ ./target/debug/claw doctor
87
+
88
+ # 4. Run a prompt
89
+ ./target/debug/claw prompt "say hello"
90
+ ```
91
+
92
+ > [!NOTE]
93
+ > **Windows (PowerShell):** the binary is `claw.exe`, not `claw`. Use `.\target\debug\claw.exe` or run `cargo run -- prompt "say hello"` to skip the path lookup.
94
+
95
+ ### Windows setup
96
+
97
+ **PowerShell is a supported Windows path.** Use whichever shell works for you. The common onboarding issues on Windows are:
98
+
99
+ 1. **Install Rust first** — download from <https://rustup.rs/> and run the installer. Close and reopen your terminal when it finishes.
100
+ 2. **Verify Rust is on PATH:**
101
+ ```powershell
102
+ cargo --version
103
+ ```
104
+ If this fails, reopen your terminal or run the PATH setup from the Rust installer output, then retry.
105
+ 3. **Clone and build** (works in PowerShell, Git Bash, or WSL):
106
+ ```powershell
107
+ git clone https://github.com/ultraworkers/claw-code
108
+ cd claw-code/rust
109
+ cargo build --workspace
110
+ ```
111
+ 4. **Run** (PowerShell — note `.exe` and backslash):
112
+ ```powershell
113
+ $env:ANTHROPIC_API_KEY = "sk-ant-..."
114
+ .\target\debug\claw.exe prompt "say hello"
115
+ ```
116
+
117
+ **Git Bash / WSL** are optional alternatives, not requirements. If you prefer bash-style paths (`/c/Users/you/...` instead of `C:\Users\you\...`), Git Bash (ships with Git for Windows) works well. In Git Bash, the `MINGW64` prompt is expected and normal — not a broken install.
118
+
119
+ > [!NOTE]
120
+ > **Auth:** claw requires an **API key** (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, etc.) — Claude subscription login is not a supported auth path.
121
+
122
+ Run the workspace test suite:
123
+
124
+ ```bash
125
+ cd rust
126
+ cargo test --workspace
127
+ ```
128
+
129
+ ## Documentation map
130
+
131
+ - [`USAGE.md`](./USAGE.md) — quick commands, auth, sessions, config, parity harness
132
+ - [`rust/README.md`](./rust/README.md) — crate map, CLI surface, features, workspace layout
133
+ - [`PARITY.md`](./PARITY.md) — parity status for the Rust port
134
+ - [`rust/MOCK_PARITY_HARNESS.md`](./rust/MOCK_PARITY_HARNESS.md) — deterministic mock-service harness details
135
+ - [`ROADMAP.md`](./ROADMAP.md) — active roadmap and open cleanup work
136
+ - [`PHILOSOPHY.md`](./PHILOSOPHY.md) — why the project exists and how it is operated
137
+
138
+ ## Ecosystem
139
+
140
+ Claw Code is built in the open alongside the broader UltraWorkers toolchain:
141
+
142
+ - [clawhip](https://github.com/Yeachan-Heo/clawhip)
143
+ - [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)
144
+ - [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)
145
+ - [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex)
146
+ - [UltraWorkers Discord](https://discord.gg/5TUQKqFWd)
147
+
148
+ ## Ownership / affiliation disclaimer
149
+
150
+ - This repository does **not** claim ownership of the original Claude Code source material.
151
+ - This repository is **not affiliated with, endorsed by, or maintained by Anthropic**.
@@ -0,0 +1,133 @@
1
+ # Claw Code
2
+
3
+ <p align="center">
4
+ <a href="https://github.com/ultraworkers/claw-code">ultraworkers/claw-code</a>
5
+ ·
6
+ <a href="./USAGE.md">Usage</a>
7
+ ·
8
+ <a href="./rust/README.md">Rust workspace</a>
9
+ ·
10
+ <a href="./PARITY.md">Parity</a>
11
+ ·
12
+ <a href="./ROADMAP.md">Roadmap</a>
13
+ ·
14
+ <a href="https://discord.gg/5TUQKqFWd">UltraWorkers Discord</a>
15
+ </p>
16
+
17
+ <p align="center">
18
+ <a href="https://star-history.com/#ultraworkers/claw-code&Date">
19
+ <picture>
20
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date&theme=dark" />
21
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" />
22
+ <img alt="Star history for ultraworkers/claw-code" src="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" width="600" />
23
+ </picture>
24
+ </a>
25
+ </p>
26
+
27
+ <p align="center">
28
+ <img src="assets/claw-hero.jpeg" alt="Claw Code" width="300" />
29
+ </p>
30
+
31
+ Claw Code is the public Rust implementation of the `claw` CLI agent harness.
32
+ The canonical implementation lives in [`rust/`](./rust), and the current source of truth for this repository is **ultraworkers/claw-code**.
33
+
34
+ > [!IMPORTANT]
35
+ > Start with [`USAGE.md`](./USAGE.md) for build, auth, CLI, session, and parity-harness workflows. Make `claw doctor` your first health check after building, use [`rust/README.md`](./rust/README.md) for crate-level details, read [`PARITY.md`](./PARITY.md) for the current Rust-port checkpoint, and see [`docs/container.md`](./docs/container.md) for the container-first workflow.
36
+ >
37
+ > **ACP / Zed status:** `claw-code` does not ship an ACP/Zed daemon entrypoint yet. Run `claw acp` (or `claw --acp`) for the current status instead of guessing from source layout; `claw acp serve` is currently a discoverability alias only, and real ACP support remains tracked separately in `ROADMAP.md`.
38
+
39
+ ## Current repository shape
40
+
41
+ - **`rust/`** — canonical Rust workspace and the `claw` CLI binary
42
+ - **`USAGE.md`** — task-oriented usage guide for the current product surface
43
+ - **`PARITY.md`** — Rust-port parity status and migration notes
44
+ - **`ROADMAP.md`** — active roadmap and cleanup backlog
45
+ - **`PHILOSOPHY.md`** — project intent and system-design framing
46
+ - **`src/` + `tests/`** — companion Python/reference workspace and audit helpers; not the primary runtime surface
47
+
48
+ ## Quick start
49
+
50
+ > [!NOTE]
51
+ > [!WARNING]
52
+ > **`cargo install claw-code` installs the wrong thing.** The `claw-code` crate on crates.io is a deprecated stub that places `claw-code-deprecated.exe` — not `claw`. Running it only prints `"claw-code has been renamed to agent-code"`. **Do not use `cargo install claw-code`.** Either build from source (this repo) or install the upstream binary:
53
+ > ```bash
54
+ > cargo install agent-code # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code'
55
+ > ```
56
+ > This repo (`ultraworkers/claw-code`) is **build-from-source only** — follow the steps below.
57
+
58
+ ```bash
59
+ # 1. Clone and build
60
+ git clone https://github.com/ultraworkers/claw-code
61
+ cd claw-code/rust
62
+ cargo build --workspace
63
+
64
+ # 2. Set your API key (Anthropic API key — not a Claude subscription)
65
+ export ANTHROPIC_API_KEY="sk-ant-..."
66
+
67
+ # 3. Verify everything is wired correctly
68
+ ./target/debug/claw doctor
69
+
70
+ # 4. Run a prompt
71
+ ./target/debug/claw prompt "say hello"
72
+ ```
73
+
74
+ > [!NOTE]
75
+ > **Windows (PowerShell):** the binary is `claw.exe`, not `claw`. Use `.\target\debug\claw.exe` or run `cargo run -- prompt "say hello"` to skip the path lookup.
76
+
77
+ ### Windows setup
78
+
79
+ **PowerShell is a supported Windows path.** Use whichever shell works for you. The common onboarding issues on Windows are:
80
+
81
+ 1. **Install Rust first** — download from <https://rustup.rs/> and run the installer. Close and reopen your terminal when it finishes.
82
+ 2. **Verify Rust is on PATH:**
83
+ ```powershell
84
+ cargo --version
85
+ ```
86
+ If this fails, reopen your terminal or run the PATH setup from the Rust installer output, then retry.
87
+ 3. **Clone and build** (works in PowerShell, Git Bash, or WSL):
88
+ ```powershell
89
+ git clone https://github.com/ultraworkers/claw-code
90
+ cd claw-code/rust
91
+ cargo build --workspace
92
+ ```
93
+ 4. **Run** (PowerShell — note `.exe` and backslash):
94
+ ```powershell
95
+ $env:ANTHROPIC_API_KEY = "sk-ant-..."
96
+ .\target\debug\claw.exe prompt "say hello"
97
+ ```
98
+
99
+ **Git Bash / WSL** are optional alternatives, not requirements. If you prefer bash-style paths (`/c/Users/you/...` instead of `C:\Users\you\...`), Git Bash (ships with Git for Windows) works well. In Git Bash, the `MINGW64` prompt is expected and normal — not a broken install.
100
+
101
+ > [!NOTE]
102
+ > **Auth:** claw requires an **API key** (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, etc.) — Claude subscription login is not a supported auth path.
103
+
104
+ Run the workspace test suite:
105
+
106
+ ```bash
107
+ cd rust
108
+ cargo test --workspace
109
+ ```
110
+
111
+ ## Documentation map
112
+
113
+ - [`USAGE.md`](./USAGE.md) — quick commands, auth, sessions, config, parity harness
114
+ - [`rust/README.md`](./rust/README.md) — crate map, CLI surface, features, workspace layout
115
+ - [`PARITY.md`](./PARITY.md) — parity status for the Rust port
116
+ - [`rust/MOCK_PARITY_HARNESS.md`](./rust/MOCK_PARITY_HARNESS.md) — deterministic mock-service harness details
117
+ - [`ROADMAP.md`](./ROADMAP.md) — active roadmap and open cleanup work
118
+ - [`PHILOSOPHY.md`](./PHILOSOPHY.md) — why the project exists and how it is operated
119
+
120
+ ## Ecosystem
121
+
122
+ Claw Code is built in the open alongside the broader UltraWorkers toolchain:
123
+
124
+ - [clawhip](https://github.com/Yeachan-Heo/clawhip)
125
+ - [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)
126
+ - [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)
127
+ - [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex)
128
+ - [UltraWorkers Discord](https://discord.gg/5TUQKqFWd)
129
+
130
+ ## Ownership / affiliation disclaimer
131
+
132
+ - This repository does **not** claim ownership of the original Claude Code source material.
133
+ - This repository is **not affiliated with, endorsed by, or maintained by Anthropic**.
@@ -0,0 +1,43 @@
1
+ """NeuronCLI - Python shim for the Rust binary."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import os
6
+ import subprocess
7
+ import sys
8
+ from pathlib import Path
9
+
10
+
11
+ def _find_binary() -> Path:
12
+ """Locate the embedded neuron binary inside the installed package."""
13
+ pkg_dir = Path(__file__).resolve().parent
14
+ binary_name = "neuron.exe" if sys.platform == "win32" else "neuron"
15
+ candidate = pkg_dir / binary_name
16
+ if candidate.exists():
17
+ return candidate
18
+ # Fallback: search PATH (useful during development)
19
+ for path_dir in os.get_exec_path():
20
+ candidate = Path(path_dir) / binary_name
21
+ if candidate.exists():
22
+ return candidate
23
+ raise RuntimeError(
24
+ f"NeuronCLI binary '{binary_name}' not found inside package or PATH. "
25
+ "Try reinstalling: pip install --force-reinstall neuroncli"
26
+ )
27
+
28
+
29
+ def main() -> None:
30
+ """Invoke the Rust neuron binary with forwarded argv."""
31
+ binary = _find_binary()
32
+ # Replace sys.argv[0] with the actual binary path so the Rust CLI
33
+ # sees correct program name in --version / help text.
34
+ args = [str(binary), *sys.argv[1:]]
35
+ # os.execv on Windows does not reliably inherit console std streams,
36
+ # which silently swallows output for --version / --help. Use
37
+ # subprocess.run instead and forward the child's exit code.
38
+ result = subprocess.run(args, check=False)
39
+ sys.exit(result.returncode)
40
+
41
+
42
+ if __name__ == "__main__":
43
+ main()
@@ -0,0 +1,151 @@
1
+ Metadata-Version: 2.4
2
+ Name: neuroncli
3
+ Version: 6.1.0
4
+ Summary: NeuronCLI - AI-powered terminal assistant
5
+ Author: RAHUL-DevelopeRR
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/RAHUL-DevelopeRR/neuron-v2
8
+ Project-URL: Repository, https://github.com/RAHUL-DevelopeRR/neuron-v2
9
+ Classifier: Development Status :: 4 - Beta
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: License :: OSI Approved :: MIT License
12
+ Classifier: Operating System :: Microsoft :: Windows
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Rust
15
+ Classifier: Topic :: Software Development
16
+ Requires-Python: >=3.8
17
+ Description-Content-Type: text/markdown
18
+
19
+ # Claw Code
20
+
21
+ <p align="center">
22
+ <a href="https://github.com/ultraworkers/claw-code">ultraworkers/claw-code</a>
23
+ ·
24
+ <a href="./USAGE.md">Usage</a>
25
+ ·
26
+ <a href="./rust/README.md">Rust workspace</a>
27
+ ·
28
+ <a href="./PARITY.md">Parity</a>
29
+ ·
30
+ <a href="./ROADMAP.md">Roadmap</a>
31
+ ·
32
+ <a href="https://discord.gg/5TUQKqFWd">UltraWorkers Discord</a>
33
+ </p>
34
+
35
+ <p align="center">
36
+ <a href="https://star-history.com/#ultraworkers/claw-code&Date">
37
+ <picture>
38
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date&theme=dark" />
39
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" />
40
+ <img alt="Star history for ultraworkers/claw-code" src="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" width="600" />
41
+ </picture>
42
+ </a>
43
+ </p>
44
+
45
+ <p align="center">
46
+ <img src="assets/claw-hero.jpeg" alt="Claw Code" width="300" />
47
+ </p>
48
+
49
+ Claw Code is the public Rust implementation of the `claw` CLI agent harness.
50
+ The canonical implementation lives in [`rust/`](./rust), and the current source of truth for this repository is **ultraworkers/claw-code**.
51
+
52
+ > [!IMPORTANT]
53
+ > Start with [`USAGE.md`](./USAGE.md) for build, auth, CLI, session, and parity-harness workflows. Make `claw doctor` your first health check after building, use [`rust/README.md`](./rust/README.md) for crate-level details, read [`PARITY.md`](./PARITY.md) for the current Rust-port checkpoint, and see [`docs/container.md`](./docs/container.md) for the container-first workflow.
54
+ >
55
+ > **ACP / Zed status:** `claw-code` does not ship an ACP/Zed daemon entrypoint yet. Run `claw acp` (or `claw --acp`) for the current status instead of guessing from source layout; `claw acp serve` is currently a discoverability alias only, and real ACP support remains tracked separately in `ROADMAP.md`.
56
+
57
+ ## Current repository shape
58
+
59
+ - **`rust/`** — canonical Rust workspace and the `claw` CLI binary
60
+ - **`USAGE.md`** — task-oriented usage guide for the current product surface
61
+ - **`PARITY.md`** — Rust-port parity status and migration notes
62
+ - **`ROADMAP.md`** — active roadmap and cleanup backlog
63
+ - **`PHILOSOPHY.md`** — project intent and system-design framing
64
+ - **`src/` + `tests/`** — companion Python/reference workspace and audit helpers; not the primary runtime surface
65
+
66
+ ## Quick start
67
+
68
+ > [!NOTE]
69
+ > [!WARNING]
70
+ > **`cargo install claw-code` installs the wrong thing.** The `claw-code` crate on crates.io is a deprecated stub that places `claw-code-deprecated.exe` — not `claw`. Running it only prints `"claw-code has been renamed to agent-code"`. **Do not use `cargo install claw-code`.** Either build from source (this repo) or install the upstream binary:
71
+ > ```bash
72
+ > cargo install agent-code # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code'
73
+ > ```
74
+ > This repo (`ultraworkers/claw-code`) is **build-from-source only** — follow the steps below.
75
+
76
+ ```bash
77
+ # 1. Clone and build
78
+ git clone https://github.com/ultraworkers/claw-code
79
+ cd claw-code/rust
80
+ cargo build --workspace
81
+
82
+ # 2. Set your API key (Anthropic API key — not a Claude subscription)
83
+ export ANTHROPIC_API_KEY="sk-ant-..."
84
+
85
+ # 3. Verify everything is wired correctly
86
+ ./target/debug/claw doctor
87
+
88
+ # 4. Run a prompt
89
+ ./target/debug/claw prompt "say hello"
90
+ ```
91
+
92
+ > [!NOTE]
93
+ > **Windows (PowerShell):** the binary is `claw.exe`, not `claw`. Use `.\target\debug\claw.exe` or run `cargo run -- prompt "say hello"` to skip the path lookup.
94
+
95
+ ### Windows setup
96
+
97
+ **PowerShell is a supported Windows path.** Use whichever shell works for you. The common onboarding issues on Windows are:
98
+
99
+ 1. **Install Rust first** — download from <https://rustup.rs/> and run the installer. Close and reopen your terminal when it finishes.
100
+ 2. **Verify Rust is on PATH:**
101
+ ```powershell
102
+ cargo --version
103
+ ```
104
+ If this fails, reopen your terminal or run the PATH setup from the Rust installer output, then retry.
105
+ 3. **Clone and build** (works in PowerShell, Git Bash, or WSL):
106
+ ```powershell
107
+ git clone https://github.com/ultraworkers/claw-code
108
+ cd claw-code/rust
109
+ cargo build --workspace
110
+ ```
111
+ 4. **Run** (PowerShell — note `.exe` and backslash):
112
+ ```powershell
113
+ $env:ANTHROPIC_API_KEY = "sk-ant-..."
114
+ .\target\debug\claw.exe prompt "say hello"
115
+ ```
116
+
117
+ **Git Bash / WSL** are optional alternatives, not requirements. If you prefer bash-style paths (`/c/Users/you/...` instead of `C:\Users\you\...`), Git Bash (ships with Git for Windows) works well. In Git Bash, the `MINGW64` prompt is expected and normal — not a broken install.
118
+
119
+ > [!NOTE]
120
+ > **Auth:** claw requires an **API key** (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, etc.) — Claude subscription login is not a supported auth path.
121
+
122
+ Run the workspace test suite:
123
+
124
+ ```bash
125
+ cd rust
126
+ cargo test --workspace
127
+ ```
128
+
129
+ ## Documentation map
130
+
131
+ - [`USAGE.md`](./USAGE.md) — quick commands, auth, sessions, config, parity harness
132
+ - [`rust/README.md`](./rust/README.md) — crate map, CLI surface, features, workspace layout
133
+ - [`PARITY.md`](./PARITY.md) — parity status for the Rust port
134
+ - [`rust/MOCK_PARITY_HARNESS.md`](./rust/MOCK_PARITY_HARNESS.md) — deterministic mock-service harness details
135
+ - [`ROADMAP.md`](./ROADMAP.md) — active roadmap and open cleanup work
136
+ - [`PHILOSOPHY.md`](./PHILOSOPHY.md) — why the project exists and how it is operated
137
+
138
+ ## Ecosystem
139
+
140
+ Claw Code is built in the open alongside the broader UltraWorkers toolchain:
141
+
142
+ - [clawhip](https://github.com/Yeachan-Heo/clawhip)
143
+ - [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)
144
+ - [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)
145
+ - [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex)
146
+ - [UltraWorkers Discord](https://discord.gg/5TUQKqFWd)
147
+
148
+ ## Ownership / affiliation disclaimer
149
+
150
+ - This repository does **not** claim ownership of the original Claude Code source material.
151
+ - This repository is **not affiliated with, endorsed by, or maintained by Anthropic**.
@@ -0,0 +1,10 @@
1
+ README.md
2
+ pyproject.toml
3
+ neuron_cli/__init__.py
4
+ neuron_cli/neuron.exe
5
+ neuroncli.egg-info/PKG-INFO
6
+ neuroncli.egg-info/SOURCES.txt
7
+ neuroncli.egg-info/dependency_links.txt
8
+ neuroncli.egg-info/entry_points.txt
9
+ neuroncli.egg-info/top_level.txt
10
+ tests/test_porting_workspace.py
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ neuron = neuron_cli:main
@@ -0,0 +1 @@
1
+ neuron_cli
@@ -0,0 +1,37 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "neuroncli"
7
+ version = "6.1.0"
8
+ description = "NeuronCLI - AI-powered terminal assistant"
9
+ readme = "README.md"
10
+ license = {text = "MIT"}
11
+ requires-python = ">=3.8"
12
+ authors = [
13
+ {name = "RAHUL-DevelopeRR"},
14
+ ]
15
+ classifiers = [
16
+ "Development Status :: 4 - Beta",
17
+ "Intended Audience :: Developers",
18
+ "License :: OSI Approved :: MIT License",
19
+ "Operating System :: Microsoft :: Windows",
20
+ "Programming Language :: Python :: 3",
21
+ "Programming Language :: Rust",
22
+ "Topic :: Software Development",
23
+ ]
24
+
25
+ [project.scripts]
26
+ neuron = "neuron_cli:main"
27
+
28
+ [project.urls]
29
+ Homepage = "https://github.com/RAHUL-DevelopeRR/neuron-v2"
30
+ Repository = "https://github.com/RAHUL-DevelopeRR/neuron-v2"
31
+
32
+ [tool.setuptools.packages.find]
33
+ where = ["."]
34
+ include = ["neuron_cli*"]
35
+
36
+ [tool.setuptools.package-data]
37
+ neuron_cli = ["neuron.exe"]