nex-code 0.3.0 → 0.3.1

package/README.md

@@ -13,6 +13,7 @@
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/nex-code"><img src="https://img.shields.io/npm/v/nex-code.svg" alt="npm version"></a>
   <a href="https://github.com/hybridpicker/nex-code/actions/workflows/ci.yml"><img src="https://github.com/hybridpicker/nex-code/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
   <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node >= 18">
@@ -25,10 +26,15 @@
 ## Quickstart
 
 ```bash
-git clone https://github.com/hybridpicker/nex-code.git
-cd nex-code && npm install
-cp .env.example .env       # add at least one API key
-npm start                   # or: npm link && nex-code
+npx nex-code
+```
+
+Or install globally:
+
+```bash
+npm install -g nex-code
+cd ~/your-project
+nex-code
 ```
 
 That's it. You'll see the banner, your project context, and the `>` prompt. Start typing.
@@ -55,10 +61,22 @@ That's it. You'll see the banner, your project context, and the `>` prompt. Star
 - Node.js 18+
 - At least one API key **or** a local [Ollama](https://ollama.com/download) server
 
-### Installation
+### Install from npm
+
+```bash
+npm install -g nex-code
+```
+
+Or run directly without installing:
 
 ```bash
-git clone git@github.com:hybridpicker/nex-code.git
+npx nex-code
+```
+
+### Install from source (for contributors)
+
+```bash
+git clone https://github.com/hybridpicker/nex-code.git
 cd nex-code
 npm install
 cp .env.example .env
@@ -68,7 +86,7 @@ npm run install-hooks
 
 ### Configure a Provider
 
-Add one or more API keys to `.env`:
+Create a `.env` file in your project directory (or set environment variables):
 
 ```bash
 # Pick any — only one is required
@@ -682,6 +700,13 @@ CI runs on GitHub Actions (Node 18/20/22).
 
 Everything else is Node.js built-in.
 
+## Installation
+
+```bash
+npm install -g nex-code    # global install
+npx nex-code               # or run without installing
+```
+
 ## License
 
 MIT

package/cli/index.js

@@ -914,18 +914,26 @@ function startREPL() {
         const { execSync } = require('child_process');
         execSync('curl -s --max-time 2 http://localhost:11434/api/tags', { encoding: 'utf-8', stdio: 'pipe' });
         setActiveModel('local:llama3');
-        console.log(`${C.green}Local Ollama detected — using local models${C.reset}`);
-        console.log(`${C.dim}Set API keys for cloud providers: OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY${C.reset}\n`);
+        console.log(`${C.green}✓ Local Ollama detected — using local models${C.reset}`);
+        console.log(`${C.dim}Tip: Set API keys for cloud providers for more model options (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)${C.reset}\n`);
         localDetected = true;
       } catch {
         // Local Ollama not available
       }
     }
     if (!localDetected) {
-      console.error(`${C.red}No provider configured and no local Ollama running.${C.reset}`);
-      console.error(`${C.gray}Options:${C.reset}`);
-      console.error(`${C.gray}  1. Install Ollama: https://ollama.com/download${C.reset}`);
-      console.error(`${C.gray}  2. Set an API key: OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, or OLLAMA_API_KEY${C.reset}`);
+      console.error(`\n${C.red}✗ No provider configured and no local Ollama detected.${C.reset}\n`);
+      console.error(`${C.white}nex-code needs at least one LLM provider to work.${C.reset}\n`);
+      console.error(`${C.white}Option 1 — Free local models (no API key needed):${C.reset}`);
+      console.error(`${C.gray}  Install Ollama:  ${C.cyan}https://ollama.com/download${C.reset}`);
+      console.error(`${C.gray}  Pull a model:    ${C.cyan}ollama pull qwen3-coder${C.reset}`);
+      console.error(`${C.gray}  Then restart:    ${C.cyan}nex-code${C.reset}\n`);
+      console.error(`${C.white}Option 2 — Cloud providers (set one in .env or as env var):${C.reset}`);
+      console.error(`${C.gray}  OLLAMA_API_KEY=...     ${C.dim}# Ollama Cloud (free tier available)${C.reset}`);
+      console.error(`${C.gray}  OPENAI_API_KEY=...     ${C.dim}# OpenAI${C.reset}`);
+      console.error(`${C.gray}  ANTHROPIC_API_KEY=...  ${C.dim}# Anthropic${C.reset}`);
+      console.error(`${C.gray}  GEMINI_API_KEY=...     ${C.dim}# Google Gemini${C.reset}\n`);
+      console.error(`${C.dim}Create a .env file in your project directory or export the variable.${C.reset}`);
       process.exit(1);
     }
   }

package/cli/sub-agent.js

@@ -48,6 +48,7 @@ function isRetryableError(err) {
   return false;
 }
 
+<<<<<<< Updated upstream
 async function callWithRetry(messages, tools, options) {
   let lastError;
   for (let attempt = 0; attempt <= MAX_CHAT_RETRIES; attempt++) {
@@ -55,6 +56,13 @@ async function callWithRetry(messages, tools, options) {
       // Use callStream (stream:true) — more reliable than callChat (stream:false)
       // with Ollama Cloud. Silently collect the full response via no-op onToken.
       return await callStream(messages, tools, { ...options, onToken: () => {} });
+=======
+async function callChatWithRetry(messages, tools, options) {
+  let lastError;
+  for (let attempt = 0; attempt <= MAX_CHAT_RETRIES; attempt++) {
+    try {
+      return await callChat(messages, tools, options);
+>>>>>>> Stashed changes
     } catch (err) {
       lastError = err;
       if (attempt < MAX_CHAT_RETRIES && isRetryableError(err)) {
@@ -216,7 +224,11 @@ ERROR RECOVERY:
 
   try {
     for (let i = 0; i < maxIter; i++) {
+<<<<<<< Updated upstream
       const result = await callWithRetry(messages, availableTools, chatOptions);
+=======
+      const result = await callChatWithRetry(messages, availableTools, chatOptions);
+>>>>>>> Stashed changes
 
       // Guard against null/undefined responses
       if (!result || typeof result !== 'object') {
@@ -422,4 +434,8 @@ async function executeSpawnAgents(args) {
   }
 }
 
+<<<<<<< Updated upstream
 module.exports = { runSubAgent, executeSpawnAgents, clearAllLocks, classifyTask, pickModelForTier, resolveSubAgentModel, isRetryableError, callWithRetry };
+=======
+module.exports = { runSubAgent, executeSpawnAgents, clearAllLocks, classifyTask, pickModelForTier, resolveSubAgentModel, isRetryableError, callChatWithRetry };
+>>>>>>> Stashed changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nex-code",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Nex Code — Agentic Coding CLI with Multi-Provider Support",
   "bin": {
     "nex-code": "./bin/nex-code.js"