navada-edge-cli 2.2.1 → 2.3.0

package/README.md

@@ -6,6 +6,32 @@ An AI-powered terminal agent for the **NAVADA Edge Network**. Full computer acce
 npm install -g navada-edge-cli
 ```
 
+## Executive Summary
+
+**NAVADA Edge CLI** is a production-grade terminal tool that gives developers and infrastructure teams an AI agent with full system access, connected to a distributed computing network.
+
+**The problem:** Managing distributed infrastructure across multiple cloud providers, on-prem servers, and services requires jumping between terminals, dashboards, and APIs. AI assistants answer questions but can't execute.
+
+**The solution:** One CLI that talks naturally, executes commands locally and remotely, and unifies access to your entire infrastructure through a conversational AI agent with 13 built-in tools.
+
+**Key differentiators:**
+- **Conversational AI agent** — type naturally, the agent uses tools to execute (not just answer)
+- **Full computer access** — shell, files, processes on your local machine
+- **Distributed network** — 4 physical nodes connected via Tailscale VPN, managed from one terminal
+- **Two sub-agents** — Lucas CTO (infrastructure) and Claude CoS (communications + automation)
+- **Cloud-native** — Cloudflare (R2, Flux AI, Stream, DNS), Azure (n8n), private Docker registry
+- **5 AI models** — Claude Sonnet 4, GPT-4o, Qwen Coder (FREE), YOLO v8, Flux (FREE)
+- **45+ slash commands** — direct access when you need precision
+- **4 themes** — dark, crow (achromatic), matrix, light
+- **Mobile access** — HTTP server with web UI, accessible from phone
+- **Cross-platform** — Windows, macOS, Linux
+- **Docker ready** — run as a container with `docker run -it navada-edge-cli`
+- **Zero config to start** — install, login with any API key, start talking
+
+**Who it's for:** DevOps engineers, infrastructure teams, AI developers, and anyone who manages distributed systems and wants an AI copilot in their terminal.
+
+**Pricing:** The CLI is free and open source (MIT). AI features require your own API key (Anthropic, OpenAI, or HuggingFace — Qwen is free). Network features require access to a NAVADA Edge Network instance.
+
 ```
 ╭─────────────────────────────────────────────────────────╮
 │   ███╗   ██╗ █████╗ ██╗   ██╗ █████╗ ██████╗  █████╗    │

package/lib/agent.js

@@ -95,7 +95,53 @@ const localTools = {
 };
 
 // ---------------------------------------------------------------------------
-// Anthropic Claude API — conversational agent
+// Grok (xAI) — free tier for all users (30 RPM, 40K TPM)
+// ---------------------------------------------------------------------------
+const GROK_KEY = 'xai-NEmiT3HGX6OoNZ2Xwj5RJtzy1U2AgcDxGrebJbp7dNFCdk9dSF1kEpaoaL6CygcsFYGR3tQuWyhGJAg1';
+const GROK_MODEL = 'grok-3-mini-fast';
+
+async function callGrok(messages) {
+  const r = await navada.request('https://api.x.ai/v1/chat/completions', {
+    method: 'POST',
+    body: {
+      model: GROK_MODEL,
+      messages: [
+        { role: 'system', content: IDENTITY.personality },
+        ...messages,
+      ],
+      max_tokens: 2048,
+      temperature: 0.7,
+    },
+    headers: {
+      'Authorization': `Bearer ${GROK_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    timeout: 30000,
+  });
+
+  if (r.status === 429) {
+    return {
+      content: `You've hit the free tier rate limit (30 requests/min).
+
+To continue chatting, add your own API key:
+  /login sk-ant-your-anthropic-key    (full agent with tool use)
+  /login sk-your-openai-key           (GPT-4o)
+  /init hfToken hf_your_token         (Qwen Coder — FREE unlimited)
+
+Or wait a minute and try again.`,
+      isRateLimit: true,
+    };
+  }
+
+  if (r.status !== 200) {
+    throw new Error(`Grok API error ${r.status}: ${JSON.stringify(r.data).slice(0, 200)}`);
+  }
+
+  return { content: r.data?.choices?.[0]?.message?.content || '', isRateLimit: false };
+}
+
+// ---------------------------------------------------------------------------
+// Anthropic Claude API — conversational agent with tool use
 // ---------------------------------------------------------------------------
 async function chat(userMessage, conversationHistory = []) {
   // Smart key detection — check all possible locations
@@ -110,8 +156,9 @@ async function chat(userMessage, conversationHistory = []) {
     || (apiKey && apiKey.startsWith('sk-ant') ? apiKey : '')
     || '';
 
+  // No personal key — use Grok free tier
   if (!effectiveKey) {
-    return fallbackChat(userMessage);
+    return grokChat(userMessage, conversationHistory);
   }
 
   const tools = [
@@ -273,8 +320,18 @@ async function executeTool(name, input) {
   }
 }
 
+async function grokChat(userMessage, conversationHistory = []) {
+  const messages = [
+    ...conversationHistory.slice(-20),
+    { role: 'user', content: userMessage },
+  ];
+
+  const result = await callGrok(messages);
+  return result.content;
+}
+
 async function fallbackChat(msg) {
-  // Try MCP → Qwen → OpenAI → helpful error
+  // Try MCP → Qwen → OpenAI → Grok free tier
   if (navada.config.mcp) {
     try {
       const r = await navada.mcp.call('chat', { message: msg });
@@ -290,14 +347,12 @@ async function fallbackChat(msg) {
   if (navada.config.openaiKey) {
     try { return await navada.ai.openai.chat(msg); } catch {}
   }
-  return `I need an API key to chat. Quick fix:
-
-  /login sk-ant-your-anthropic-key    (recommended — enables full agent with tool use)
-  /login sk-your-openai-key           (GPT-4o)
-  /init hfToken hf_your_token         (Qwen Coder — FREE)
-  /setup                              (guided wizard)
-
-/commands still work without a key — try /help`;
+  // Grok is always available as the free fallback
+  try {
+    const result = await callGrok([{ role: 'user', content: msg }]);
+    return result.content;
+  } catch {}
+  return `All providers failed. Check your internet connection or try again.`;
 }
 
 // ---------------------------------------------------------------------------

package/lib/cli.js

@@ -92,11 +92,10 @@ async function run(argv) {
     // Interactive mode — always start. User can /setup if needed.
     showWelcome();
 
-    // Hint if no key configured
-    const hasKey = config.getApiKey() || config.get('anthropicKey') || process.env.ANTHROPIC_API_KEY;
-    if (!hasKey) {
-      console.log(ui.warn('No API key set. Type /login <key> or /setup to configure.'));
-      console.log(ui.dim('You can still use /commands. Natural chat requires an API key.'));
+    // Show tier info
+    const hasPersonalKey = config.getApiKey() || config.get('anthropicKey') || process.env.ANTHROPIC_API_KEY;
+    if (!hasPersonalKey) {
+      console.log(ui.dim('Free tier active (Grok). /login <your-key> for full agent with tool use.'));
       console.log('');
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "navada-edge-cli",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Interactive CLI for the NAVADA Edge Network — explore nodes, agents, Cloudflare, AI, Docker, and MCP from your terminal",
   "main": "lib/cli.js",
   "bin": {