@mmmbuto/nexuscli 0.6.1 → 0.6.3

package/README.md

@@ -1,8 +1,48 @@
-# NexusCLI
+# NexusCLI — AI Terminal Cockpit
 
-**TRI CLI v0.4.0** - Termux Mobile First AI Control Plane
+<p align="center">
+  <img src=".github/header/header.png" width="900" />
+</p>
 
-Web UI for Claude Code, Codex CLI, and Gemini CLI.
+
+---
+
+## Overview
+
+NexusCLI is an experimental, ultra-light terminal cockpit designed for
+AI-assisted development workflows on Termux (Android).
+
+**v0.6.3** - Mobile-First AI Control Plane
+
+Web UI wrapper for Claude Code, Codex CLI, and Gemini CLI with voice input support.
+
+---
+
+[![npm](https://img.shields.io/npm/v/@mmmbuto/nexuscli?style=flat-square&logo=npm)](https://www.npmjs.com/package/@mmmbuto/nexuscli)
+[![downloads](https://img.shields.io/npm/dt/@mmmbuto/nexuscli?style=flat-square)](https://www.npmjs.com/package/@mmmbuto/nexuscli)
+[![ko-fi](https://img.shields.io/badge/☕_Support-Ko--fi-FF5E5B?style=flat-square&logo=ko-fi)](https://ko-fi.com/dionanos)
+
+---
+
+## Screenshots
+
+<p align="center">
+  <img src="docs/assets/screenshots/nexuscli-multilang-preview.png" width="45%" />
+  <img src="docs/assets/screenshots/nexuscli-mobile-terminal.png" width="45%" />
+</p>
+
+---
+
+## Features
+
+- Multi-engine support (Claude, Codex, Gemini)
+- **Voice input** (OpenAI Whisper STT)
+- **Auto HTTPS** for remote microphone access
+- Mobile-first responsive UI
+- SSE streaming responses
+- Workspace management
+- Conversation history
+- Model selector with think mode toggle
 
 ## Supported Engines
 
@@ -12,23 +52,16 @@ Web UI for Claude Code, Codex CLI, and Gemini CLI.
 | **Codex** | GPT-5.1, GPT-5.1 Codex (Mini/Max) | OpenAI |
 | **Gemini** | Gemini 3 Pro Preview | Google |
 
-## Install
+---
 
-**Private package** - Install via git:
+## Install
 
 ```bash
-# From VPS (recommended)
-npm install -g git+ssh://dag@cloud.alpacalibre.com/home/dag/git_repos/NexusCLI.git
+# From npm
+npm install -g @mmmbuto/nexuscli
 
-# From VPSHome backup
-npm install -g git+ssh://calner@192.168.10.10/home/calner/git_repos/NexusCLI.git
-
-# Local clone install
-cd ~/Dev/NexusCLI && npm install -g .
-
-# Termux manual install
-cd ~/Dev/NexusCLI
-./scripts/install-termux.sh
+# From GitHub
+npm install -g github:DioNanos/nexuscli
 ```
 
 ## Setup
@@ -43,19 +76,51 @@ nexuscli init
 nexuscli start
 ```
 
-Open browser: `http://localhost:41800`
+### Network Access
+
+| Protocol | Port | URL | Use Case |
+|----------|------|-----|----------|
+| **HTTP** | 41800 | `http://localhost:41800` | Local access |
+| **HTTPS** | 41801 | `https://<ip>:41801` | Remote access, voice input |
+
+> **Note**: HTTPS is required for microphone access from remote devices (browser security).
+> Self-signed certificates are auto-generated on first run.
+
+---
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `nexuscli init` | Setup wizard |
-| `nexuscli start` | Start server |
+| `nexuscli start` | Start server (HTTP:41800 + HTTPS:41801) |
 | `nexuscli stop` | Stop server |
-| `nexuscli status` | Show status |
+| `nexuscli status` | Show status, ports, and engines |
 | `nexuscli engines` | Manage AI engines |
 | `nexuscli workspaces` | Manage workspaces |
 | `nexuscli config` | Configuration |
+| `nexuscli api` | Manage API keys |
+| `nexuscli users` | User management |
+| `nexuscli setup-termux` | Bootstrap Termux + show network URLs |
+
+---
+
+## API Keys
+
+Configure API keys for additional providers:
+
+```bash
+nexuscli api list                     # List configured keys
+nexuscli api set deepseek <key>       # DeepSeek models
+nexuscli api set openai <key>         # Voice input (Whisper STT)
+nexuscli api set openrouter <key>     # Future: Multi-provider gateway
+nexuscli api delete <provider>        # Remove key
+```
+
+> **Note**: Claude/Codex/Gemini keys are managed by their respective CLIs.
+> OpenAI key enables voice input via Whisper. HTTPS auto-generated for remote mic access.
+
+---
 
 ## Requirements
 
@@ -64,7 +129,31 @@ Open browser: `http://localhost:41800`
   - Claude Code CLI (`claude`)
   - Codex CLI (`codex`)
   - Gemini CLI (`gemini`)
-- SSH access to git repos (for installation)
+
+---
+
+## Termux-First Architecture
+
+NexusCLI is designed primarily for **Termux** on Android devices.
+
+### Stack
+
+- **Termux** - primary runtime environment
+- **tmux** - session management
+- **Node.js + SSE** - lightweight backend
+- **React** - minimal UI
+
+### Purpose
+
+This project exists to study:
+
+- terminal-driven AI orchestration
+- ultra-light architectures for constrained devices
+- mobile development workflows
+
+It is a **research and learning tool**.
+
+---
 
 ## API Endpoints
 
@@ -76,12 +165,14 @@ Open browser: `http://localhost:41800`
 | `GET /api/v1/models` | All | List available models |
 | `GET /health` | - | Health check |
 
+---
+
 ## Development
 
 ```bash
 # Clone
-git clone dag@cloud.alpacalibre.com:git_repos/NexusCLI.git
-cd NexusCLI
+git clone https://github.com/DioNanos/nexuscli.git
+cd nexuscli
 
 # Install deps
 npm install
@@ -91,6 +182,9 @@ cd frontend && npm install && npm run build && cd ..
 npm run dev
 ```
 
+---
+
 ## License
 
-MIT
+MIT License.
+See `LICENSE` for details.

package/lib/cli/setup-termux.js

@@ -191,7 +191,8 @@ async function setupTermux() {
   } catch {
     config = { server: { port: 41800 } };
   }
-  const webPort = config.server?.port || 41800;
+  const httpPort = config.server?.port || 41800;
+  const httpsPort = parseInt(httpPort) + 1;
 
   // Output connection info
   console.log(chalk.bold('╔═══════════════════════════════════════════════════╗'));
@@ -201,10 +202,14 @@ async function setupTermux() {
   console.log(chalk.cyan('  SSH:'));
   console.log(chalk.white(`    ssh ${user}@${ip} -p ${sshPort}`));
   console.log('');
-  console.log(chalk.cyan('  NexusCLI:'));
-  console.log(chalk.white(`    https://${ip}:${webPort}`));
+  console.log(chalk.cyan('  NexusCLI (local):'));
+  console.log(chalk.white(`    http://localhost:${httpPort}`));
+  console.log('');
+  console.log(chalk.cyan('  NexusCLI (remote + voice):'));
+  console.log(chalk.white(`    https://${ip}:${httpsPort}`));
   console.log('');
   console.log(chalk.gray('  Note: Set password with: passwd'));
+  console.log(chalk.gray('  Note: HTTPS uses self-signed cert (accept in browser)'));
   console.log('');
 
   process.exit(0);

package/lib/cli/start.js

@@ -181,7 +181,10 @@ async function start(options) {
   const port = options.port || config.server.port;
   config.server.port = port;
 
-  const url = `http://localhost:${port}`;
+  const httpPort = port;
+  const httpsPort = parseInt(port) + 1;
+  const httpUrl = `http://localhost:${httpPort}`;
+  const httpsUrl = `https://localhost:${httpsPort}`;
 
   // Foreground mode (--foreground flag)
   if (options.foreground) {
@@ -198,7 +201,9 @@ async function start(options) {
   console.log(chalk.green(`  ✓ Server started (PID: ${pid})`));
   console.log(chalk.gray(`  Logs: ${PATHS.SERVER_LOG}`));
   console.log('');
-  console.log(chalk.bold(`  ${chalk.cyan(url)}`));
+  console.log(chalk.bold('  Network:'));
+  console.log(`    HTTP:  ${chalk.cyan(httpUrl)} (local)`);
+  console.log(`    HTTPS: ${chalk.cyan(httpsUrl)} (remote + voice)`);
   console.log('');
 
   // Ask to open browser (unless --no-browser)
@@ -206,7 +211,7 @@ async function start(options) {
     const shouldOpen = await askYesNo(`  Open browser? ${chalk.gray('(Y/n)')} `);
 
     if (shouldOpen) {
-      const opened = openBrowser(url);
+      const opened = openBrowser(httpUrl);
       if (opened) {
         console.log(chalk.green('  ✓ Browser opened'));
       } else {

package/lib/cli/status.js

@@ -121,7 +121,9 @@ async function status() {
     console.log(chalk.bold(`║  Server: ${chalk.red('✗ Stopped')}`));
   }
 
-  console.log(chalk.bold(`║  Port:   ${chalk.white(config.server.port)}`));
+  const httpPort = config.server.port;
+  const httpsPort = parseInt(config.server.port) + 1;
+  console.log(chalk.bold(`║  Ports:  HTTP ${chalk.white(httpPort)} / HTTPS ${chalk.white(httpsPort)}`));
   console.log(chalk.bold('║'));
 
   // Engines
@@ -183,9 +185,10 @@ async function status() {
   console.log(chalk.bold('╚═══════════════════════════════════════════╝'));
   console.log('');
 
-  // URL if running
+  // URLs if running
   if (serverStatus.running) {
-    console.log(chalk.cyan(`  http://localhost:${config.server.port}`));
+    console.log(`  HTTP:  ${chalk.cyan(`http://localhost:${httpPort}`)}`);
+    console.log(`  HTTPS: ${chalk.cyan(`https://localhost:${httpsPort}`)} (remote + voice)`);
     console.log('');
   }
 }

package/lib/server/services/session-manager.js

@@ -147,6 +147,15 @@ class SessionManager {
     return crypto.createHash('md5').update(workspacePath).digest('hex').substring(0, 8);
   }
 
+  /**
+   * Normalize workspace path (remove trailing slashes)
+   * Prevents duplicate entries like /path and /path/
+   */
+  _normalizePath(workspacePath) {
+    if (!workspacePath) return '';
+    return workspacePath.replace(/\/+$/, '');
+  }
+
   /**
    * Get or create session for conversation + engine
    *
@@ -164,16 +173,17 @@ class SessionManager {
    */
   async getOrCreateSession(conversationId, engine, workspacePath) {
     const normalizedEngine = this._normalizeEngine(engine);
+    const normalizedPath = this._normalizePath(workspacePath);
     const cacheKey = this._getCacheKey(conversationId, normalizedEngine);
 
-    console.log(`[SessionManager] getOrCreateSession(${conversationId}, ${normalizedEngine}, ${workspacePath})`);
+    console.log(`[SessionManager] getOrCreateSession(${conversationId}, ${normalizedEngine}, ${normalizedPath})`);
 
     // 1. Check RAM cache first (fastest path)
     if (this.sessionMap.has(cacheKey)) {
       const cachedId = this.sessionMap.get(cacheKey);
 
       // Verify it still exists on filesystem
-      if (this.sessionFileExists(cachedId, normalizedEngine, workspacePath)) {
+      if (this.sessionFileExists(cachedId, normalizedEngine, normalizedPath)) {
         this.lastAccess.set(cacheKey, Date.now());
         console.log(`[SessionManager] Cache hit: ${cachedId}`);
         return { sessionId: cachedId, isNew: false };
@@ -195,7 +205,7 @@ class SessionManager {
 
       if (row) {
         // 3. Verify session file exists on filesystem
-        if (this.sessionFileExists(row.id, normalizedEngine, row.workspace_path || workspacePath)) {
+        if (this.sessionFileExists(row.id, normalizedEngine, row.workspace_path || normalizedPath)) {
           // Valid session - update cache and return
           this.sessionMap.set(cacheKey, row.id);
           this.lastAccess.set(cacheKey, Date.now());
@@ -223,7 +233,7 @@ class SessionManager {
         VALUES (?, ?, ?, ?, ?, ?, ?)
       `);
       const title = 'New Chat'; // Will be updated after first response
-      insertStmt.run(sessionId, workspacePath, normalizedEngine, conversationId, title, now, now);
+      insertStmt.run(sessionId, normalizedPath, normalizedEngine, conversationId, title, now, now);
       saveDb();
       console.log(`[SessionManager] Saved to DB: ${sessionId}`);
     } catch (dbErr) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmmbuto/nexuscli",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "NexusCLI - TRI CLI Control Plane (Claude/Codex/Gemini)",
   "main": "lib/server/server.js",
   "bin": {