@mmmbuto/nexuscrew 0.1.0-beta.1 → 0.2.0

package/README.md

@@ -1,69 +1,34 @@
-## Overview
+# NexusCrew — tmux AI Cockpit
 
-NexusCrew is a **tmux-based** AI cockpit that orchestrates Claude Code, Codex CLI, Gemini CLI, and Qwen Code through persistent tmux sessions.
-
-This is a **study project** exploring an alternative approach to AI CLI orchestration, based on experience with [NexusCLI](https://www.npmjs.com/package/@mmmbuto/nexuscli). Instead of managing PTY processes in-memory, NexusCrew delegates session lifecycle to **tmux** — sessions survive server restarts, can be accessed directly from the terminal, and extend to remote hosts via SSH.
-
-> **Status**: Beta — experimental, API may change
-
----
-
-## Why tmux?
-
-| Problem | NexusCLI (PTY) | NexusCrew (tmux) |
-|---------|---------------|-------------------|
-| Server crash | All sessions die | Sessions survive |
-| Direct access | Web UI only | Web UI + `tmux attach` |
-| Remote machines | Not supported | SSH to any host |
-| Native deps | node-pty required | Zero native deps |
-| Session recovery | Manual | Automatic |
-
----
+**Mobile-first** web cockpit for AI CLI tools. Persistent sessions via tmux.
 
 ## Features
 
 - **Persistent sessions** — tmux windows survive server restarts
-- **Multi-engine** — Claude Code, Codex CLI, Gemini CLI, Qwen Code
-- **Auto-discovery** — detects installed CLIs + parses shell aliases/functions from `providers.zsh`
-- **Remote hosts** — manage tmux sessions on any machine via SSH
-- **Unified web UI** — same interface across all engines and hosts
-- **SSE streaming** — real-time output from tmux sessions
-- **Zero native deps** — no node-pty, no compilation required
-- **Cross-platform** — Linux, macOS, Termux (Android)
-
----
-
-## Engine Discovery
-
-NexusCrew automatically detects:
-
-1. **Standard CLIs** — `claude`, `codex`, `gemini`, `qwen` via PATH and common install paths
-2. **Shell aliases** — parses `~/Dev/providers.zsh` (or configured path) for wrapper functions like:
-   - `claude-glm-a`, `codex-alibaba-qwen35`, `claude-minimax27`, etc.
-   - Each alias becomes available as a custom lane in the model selector
-
----
+- **4 engines** — Claude Code, Codex CLI, Gemini CLI, Qwen Code
+- **Mobile-first** — Termux (Android) primary target, then Linux/Mac
+- **Zero native deps** — sql.js (WASM SQLite), no compilation needed
+- **Auth** — JWT with localhost auto-bypass
+- **Dark/Light theme** — CSS variables, instant toggle
+- **i18n** — 6 languages (en, it, es, ja, ru, zh)
+- **STT/TTS** — Speech-to-text (Web Speech API + OpenAI Whisper) + Read aloud
+- **File upload** — 50MB attachments
+- **Session dots** — Green (alive), Yellow (idle), Red (dead) tmux state
+- **Lane-aware models** — Native + Custom per engine
+- **Shell discovery** — Scans .zshrc, .bashrc, providers.zsh for aliases
+- **Remote hosts** — SSH to any machine
+- **SSE streaming** — Real-time AI output
+- **6 languages UI** — Auto-detects browser language
 
 ## Install
 
 ```bash
 npm install -g @mmmbuto/nexuscrew
-```
-
-Then initialize:
-
-```bash
 nexuscrew init
-```
-
-And start:
-
-```bash
 nexuscrew start
+# Open http://localhost:41820
 ```
 
-Open `http://localhost:41820` in your browser.
-
 ### Termux (Android)
 
 ```bash
@@ -73,103 +38,72 @@ nexuscrew init
 nexuscrew start
 ```
 
----
-
-## Remote Hosts
-
-Add SSH hosts to manage tmux sessions on remote machines:
+## Quick Start
 
 ```bash
-nexuscrew hosts add --name vps1 --host example.com --user user
-nexuscrew hosts add --name vps2 --host 192.168.1.10 --user admin --port 2222
+nexuscrew init      # First-time setup
+nexuscrew start     # Start server + tmux
+nexuscrew status    # Check server + sessions
+nexuscrew attach    # Attach to tmux directly
+nexuscrew engines   # Discover AI CLIs
 ```
 
-Hosts appear in the UI's model selector. Sessions created on a remote host open a tmux window there via SSH.
-
----
-
-## Commands
+## Architecture
 
-| Command | Description |
-|---------|-------------|
-| `nexuscrew init` | First-time setup (config, hosts, tmux check) |
-| `nexuscrew start` | Start server + tmux session |
-| `nexuscrew stop` | Stop server |
-| `nexuscrew status` | Server + tmux + hosts status |
-| `nexuscrew engines` | Discover available AI CLIs and aliases |
-| `nexuscrew sessions` | List tmux windows |
-| `nexuscrew attach` | Attach to tmux session directly |
-| `nexuscrew config` | View/edit configuration |
-| `nexuscrew hosts list` | List configured hosts |
-| `nexuscrew hosts add` | Add remote SSH host |
-| `nexuscrew hosts remove` | Remove a host |
+```
+Browser/WebView ←SSE/REST→ Express :41820 ←tmux→ CLI AI processes
+                                    |
+                                sql.js DB (WASM)
+                                JWT Auth
+```
 
----
+Each AI session = one tmux window. Output captured via `tee`, streamed to UI via SSE.
 
 ## Configuration
 
-Config stored in `~/.nexuscrew/config.json`:
-
+`~/.nexuscrew/config.json`:
 ```json
 {
   "port": 41820,
   "tmuxSession": "nexuscrew",
-  "logDir": "~/.nexuscrew/logs",
-  "autoDiscovery": true,
-  "providersPath": "~/Dev/providers.zsh"
+  "autoDiscovery": true
 }
 ```
 
-Hosts stored in `~/.nexuscrew/hosts.json`:
-
-```json
-[
-  { "name": "local", "type": "local", "default": true },
-  { "name": "vps1", "type": "ssh", "host": "example.com", "user": "user", "port": "22" }
-]
-```
-
----
-
-## Network
-
-| Protocol | Default Port | Use Case |
-|----------|--------------|----------|
-| HTTP | `41820` | Local access |
-
----
+## Commands
 
-## Architecture
+| Command | Description |
+|---------|-------------|
+| `nexuscrew init` | First-time setup |
+| `nexuscrew start` | Start server + tmux |
+| `nexuscrew stop` | Stop server |
+| `nexuscrew status` | Server + tmux + hosts |
+| `nexuscrew engines` | Discover CLIs + aliases |
+| `nexuscrew sessions` | List tmux windows |
+| `nexuscrew attach` | Attach to tmux |
+| `nexuscrew config` | View/edit config |
+| `nexuscrew hosts add` | Add SSH host |
 
-```
-Browser ←SSE→ Express Server ←tmux→ tmux session "nexuscrew"
-                                      ├─ window: nc-abc12345 (claude)
-                                      ├─ window: nc-def67890 (codex)
-                                      └─ window: nc-ghi11111 (gemini)
-```
+## API
 
-Each AI session = one tmux window. Output captured via `tee` to log files, parsed by engine-specific parsers, and streamed to the UI via SSE.
+Public: `/health`, `/api/v1/auth/login`, `/api/v1/models`, `/api/v1/runtimes`
+Protected (JWT/localhost): `/api/v1/send`, `/api/v1/sessions`, `/api/v1/upload`, `/api/v1/workspaces`
 
----
+Default login: `admin` / `admin` (change after first login)
 
 ## Development
 
 ```bash
-git clone https://github.com/dionanos/nexuscrew
-cd nexuscrew
-npm install
+git clone https://github.com/DioNanos/nexuscrew
+cd nexuscrew && npm install
 cd frontend && npm install && npm run build && cd ..
 npm run dev
 ```
 
----
-
-## Relation to NexusCLI
-
-NexusCrew is a **study branch** inspired by [NexusCLI](https://www.npmjs.com/package/@mmmbuto/nexuscli). It shares the same web UI but replaces the PTY-based process management with tmux-based persistent sessions. The goal is to explore whether tmux provides a simpler, more robust foundation for AI CLI orchestration — especially for remote hosts and crash recovery.
+## Related
 
----
+- [NexusCLI](https://www.npmjs.com/package/@mmmbuto/nexuscli) — PTY-based variant
 
 ## License
 
-MIT License. See [LICENSE](LICENSE).
+MIT

package/bin/nexuscrew.js

@@ -16,15 +16,16 @@ const program = new Command();
 program
   .name('nexuscrew')
   .description('tmux-based AI cockpit')
-  .version('0.1.0');
+  .version('0.2.0');
 
 // --- init ---
 program.command('init')
   .description('First-time setup')
-  .action(() => {
+  .option('-s, --silent', 'Silent mode (no output)')
+  .action((opts) => {
     if (!fs.existsSync(CONFIG_DIR)) {
       fs.mkdirSync(CONFIG_DIR, { recursive: true });
-      console.log('Created ~/.nexuscrew/');
+      if (!opts.silent) console.log('Created ~/.nexuscrew/');
     }
 
     // Default config
@@ -36,7 +37,7 @@ program.command('init')
         autoDiscovery: true,
         providersPath: ''
       }, null, 2));
-      console.log('Created config.json');
+      if (!opts.silent) console.log('Created config.json');
     }
 
     // Default hosts
@@ -44,7 +45,7 @@ program.command('init')
       fs.writeFileSync(HOSTS_PATH, JSON.stringify([
         { name: 'local', type: 'local', default: true }
       ], null, 2));
-      console.log('Created hosts.json');
+      if (!opts.silent) console.log('Created hosts.json');
     }
 
     // Log dir
@@ -56,12 +57,12 @@ program.command('init')
     // Check tmux
     try {
       execSync('which tmux', { stdio: 'pipe' });
-      console.log('tmux: OK');
+      if (!opts.silent) console.log('tmux: OK');
     } catch {
-      console.error('tmux not found! Install: apt install tmux (or pkg install tmux)');
+      if (!opts.silent) console.error('tmux not found! Install: apt install tmux (or pkg install tmux)');
     }
 
-    console.log('\nDone! Run: nexuscrew start');
+    if (!opts.silent) console.log('\nDone! Run: nexuscrew start');
   });
 
 // --- start ---