azerclaw 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AZERCLAW
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,222 @@
+<div align="center">
+
+```
+     █████╗ ███████╗███████╗██████╗  ██████╗██╗      █████╗ ██╗    ██╗
+    ██╔══██╗╚══███╔╝██╔════╝██╔══██╗██╔════╝██║     ██╔══██╗██║    ██║
+    ███████║  ███╔╝ █████╗  ██████╔╝██║     ██║     ███████║██║ █╗ ██║
+    ██╔══██║ ███╔╝  ██╔══╝  ██╔══██╗██║     ██║     ██╔══██║██║███╗██║
+    ██║  ██║███████╗███████╗██║  ██║╚██████╗███████╗██║  ██║╚███╔███╔╝
+    ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝
+```
+
+**🐟 Your AI · Your Keys · Your Way**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org)
+[![BYOK](https://img.shields.io/badge/BYOK-Bring%20Your%20Own%20Key-purple.svg)](#-byok-providers)
+
+*An open-source, BYOK autonomous AI agent for your terminal.*
+*Inspired by OpenClaw 🦞, powered by a fish 🐟.*
+
+</div>
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---|---|
+| 🔑 **BYOK** | Bring Your Own Key — zero platform fees, use any provider |
+| 🤖 **Autonomous Agent** | Multi-step task execution with tool use |
+| 🐠 **Sub-Agents** | Spawn parallel agents for complex workloads |
+| 🐟 **Fish CLI** | Animated ASCII fish instead of a lobster |
+| 🖥️ **Premium TUI** | Luxe terminal UI with status bar & panels |
+| 🔧 **8 Built-in Tools** | Shell, filesystem, search, code analysis, web |
+| 📦 **Skills System** | SKILL.md compatible, extensible capabilities |
+| 🔒 **Security First** | AES-256-GCM key encryption, zero telemetry |
+| 🌐 **8 Providers** | OpenAI, Anthropic, Google, Ollama, Groq, DeepSeek, OpenRouter, Custom |
+| 💻 **Cross-Platform** | macOS (Intel + Silicon), Windows, Linux |
+
+## 🚀 Quick Start
+
+```bash
+# Clone
+git clone https://github.com/azerclaw/azerclaw.git
+cd azerclaw
+
+# Install
+npm install
+
+# First run — launches setup wizard with animated splash
+npx tsx bin/azerclaw.ts
+
+# Or use npm scripts
+npm start           # Launch TUI
+npm run chat        # Interactive chat
+npm run doctor      # Health check
+```
+
+## 📸 Preview
+
+```
+  ><(((º>  AZERCLAW v1.0.0
+  Your AI · Your Keys · Your Way
+
+  ╭──────────────────────────────────────────────────────────╮
+  │                    🩺 AZERCLAW Doctor                    │
+  │──────────────────────────────────────────────────────────│
+  │ Running health checks...                                 │
+  ╰──────────────────────────────────────────────────────────╯
+
+  ═══════════════════════════════════════><(((º> 100% System
+
+  ✓ Config File      Found at ~/.azerclaw/config.json
+  ✓ Directories      All present
+  ✓ Permissions      Config is 0600 (secure)
+  ✓ Providers        1 configured: openrouter
+  ✓ Connectivity     1 providers initialized
+  ✓ Node.js          v22.0.0
+  ✓ System           darwin arm64 | 10 cores | 16GB RAM
+
+  ><(((°>  ✓ All 7 checks passed! 🐟
+```
+
+## 🔑 BYOK Providers
+
+| Provider | Models | How to Get Key |
+|---|---|---|
+| **OpenAI** | GPT-4o, GPT-4.1, o3, o4-mini | [platform.openai.com](https://platform.openai.com) |
+| **Anthropic** | Claude Opus 4, Sonnet 4, Haiku | [console.anthropic.com](https://console.anthropic.com) |
+| **Google** | Gemini 2.5 Pro/Flash | [aistudio.google.com](https://aistudio.google.com) |
+| **Groq** | Llama 3.3, Mixtral | [console.groq.com](https://console.groq.com) |
+| **DeepSeek** | DeepSeek V3, R1 | [platform.deepseek.com](https://platform.deepseek.com) |
+| **OpenRouter** | 100+ models | [openrouter.ai](https://openrouter.ai) |
+| **Ollama** | Any local model | [ollama.ai](https://ollama.ai) |
+| **Custom** | Any OpenAI-compatible | Your own endpoint |
+
+```bash
+# Configure via CLI
+azerclaw config set ai.providers.openrouter.apiKey "sk-or-..."
+azerclaw config set ai.providers.openrouter.enabled true
+azerclaw config set ai.defaultProvider openrouter
+
+# Or use the interactive wizard
+azerclaw onboard
+
+# Or use environment variables
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+## 🎮 Commands
+
+```bash
+azerclaw                    # Launch TUI (or onboard if first run)
+azerclaw chat               # Interactive chat
+azerclaw run "task"          # Execute a single task
+azerclaw tui                # Premium terminal UI
+azerclaw onboard            # Setup wizard
+azerclaw config list        # Show configuration
+azerclaw config get <key>   # Get a config value
+azerclaw config set <k> <v> # Set a config value
+azerclaw models list        # List available models
+azerclaw models status      # Current model info
+azerclaw doctor             # Health check
+azerclaw doctor --fix       # Auto-repair issues
+azerclaw security audit     # Security check
+```
+
+## 🐟 Fish Animations
+
+AZERCLAW replaces OpenClaw's lobster 🦞 with a fish 🐟:
+
+```
+Thinking:   ><(((º>  ○ ○   Working...
+Success:    ><(((°>  ✓ Done!
+Error:      ><(((x>  ✗ Failed!
+Progress:   ═══════><(((º>░░░░░  67%
+```
+
+## 🤖 Agent & Sub-Agents
+
+AZERCLAW uses an autonomous agent loop with sub-agent orchestration:
+
+```
+┌──────────────────────────┐
+│      Main Agent          │
+│  (receives user task)    │
+├──────────────────────────┤
+│  ↓ Thinks & Plans        │
+│  ↓ Uses Tools            │
+│  ↓ Spawns Sub-Agents     │
+│                          │
+│  ┌────────┐ ┌────────┐   │
+│  │Sub 🐠 A│ │Sub 🐠 B│   │
+│  │Research│ │ Code   │   │
+│  └────────┘ └────────┘   │
+│                          │
+│  ↓ Aggregates Results    │
+│  ↓ Returns Response      │
+└──────────────────────────┘
+```
+
+## 🔒 Security
+
+- **Zero telemetry** — no data ever leaves your machine
+- **No analytics** — we don't track anything
+- **No phone-home** — no background network requests
+- **AES-256-GCM** — API keys encrypted at rest
+- **0600 permissions** — config files owner-only
+- **Audit logging** — local security event log
+- **Env sanitization** — sensitive vars stripped from child processes
+- **SSRF protection** — blocks requests to private/internal IPs
+
+## 📦 Skills System
+
+Skills are SKILL.md files compatible with the OpenClaw ecosystem:
+
+```markdown
+---
+name: Code Review
+description: Review code for bugs and security issues
+version: 1.0.0
+tags: code, review
+---
+
+# Code Review Skill
+When asked to review code...
+```
+
+Skills load from (priority order):
+1. `<workspace>/skills/` — Project-specific
+2. `~/.agents/skills/` — Personal
+3. `~/.azerclaw/skills/` — Managed
+4. `<install>/skills/` — Bundled defaults
+
+## 🛠️ Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in dev mode
+npm run dev
+
+# Build
+npm run build
+
+# Run doctor
+npm run doctor
+```
+
+## 📄 License
+
+MIT — Free and open source forever.
+
+---
+
+<div align="center">
+
+**🐟 AZERCLAW — Your AI, Your Keys, Your Way**
+
+</div>

package/bin/azerclaw.ts

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+
+/**
+ * 🐟 AZERCLAW — CLI Entry Point
+ * 
+ * An open-source, BYOK AI agent for your terminal.
+ * Inspired by OpenClaw, themed with a fish 🐟 instead of a lobster.
+ * 
+ * Usage:
+ *   azerclaw              — Launch TUI (or onboard if first run)
+ *   azerclaw chat         — Interactive chat
+ *   azerclaw run "task"   — Execute a task
+ *   azerclaw tui          — Premium terminal UI
+ *   azerclaw onboard      — Setup wizard
+ *   azerclaw config       — Manage configuration
+ *   azerclaw models       — Manage AI models
+ *   azerclaw doctor       — Health check
+ */
+
+const { Command } = require('commander');
+const { playSplashScreen, printQuickSplash, fishError, fishInfo } = require('../src/cli/animations/fish');
+const { getConfigManager } = require('../src/config/manager');
+
+const VERSION = '1.0.0';
+const program = new Command();
+
+// ─── Program Setup ──────────────────────────────────────────────
+
+program
+  .name('azerclaw')
+  .description('🐟 AZERCLAW — Your AI, Your Keys, Your Way')
+  .version(VERSION, '-v, --version', 'Display version')
+  .option('--no-splash', 'Skip the splash screen')
+  .option('--no-color', 'Disable colors');
+
+// ─── Default Action (no command) ────────────────────────────────
+
+program
+  .action(async (opts: any) => {
+    const config = getConfigManager();
+    config.resolveEnvOverrides();
+
+    if (config.isFirstRun()) {
+      // First run: show full splash + onboard
+      await playSplashScreen(VERSION);
+      const { runOnboard } = require('../src/cli/commands/onboard');
+      await runOnboard();
+    } else {
+      // Launch TUI by default
+      const { runTUI } = require('../src/cli/commands/tui');
+      await runTUI();
+    }
+  });
+
+// ─── Chat Command ───────────────────────────────────────────────
+
+program
+  .command('chat')
+  .description('Start an interactive chat session')
+  .option('-m, --model <model>', 'Override the default model')
+  .option('-p, --provider <provider>', 'Override the default provider')
+  .action(async (opts: any) => {
+    const config = getConfigManager();
+    config.resolveEnvOverrides();
+    
+    if (!opts.parent?.splash === false) {
+      printQuickSplash(VERSION);
+    }
+    
+    if (config.isFirstRun()) {
+      fishInfo('First time? Run `azerclaw onboard` to configure your AI providers.');
+      const { runOnboard } = require('../src/cli/commands/onboard');
+      await runOnboard();
+      return;
+    }
+    
+    const { runChat } = require('../src/cli/commands/chat');
+    await runChat(opts);
+  });
+
+// ─── Run Command ────────────────────────────────────────────────
+
+program
+  .command('run <task>')
+  .description('Execute a single task')
+  .option('-m, --model <model>', 'Override the default model')
+  .option('-V, --verbose', 'Show tool calls in detail')
+  .action(async (task: string, opts: any) => {
+    const config = getConfigManager();
+    config.resolveEnvOverrides();
+    printQuickSplash(VERSION);
+    
+    const { runTask } = require('../src/cli/commands/run');
+    await runTask(task, opts);
+  });
+
+// ─── TUI Command ────────────────────────────────────────────────
+
+program
+  .command('tui')
+  .description('Launch the premium terminal UI')
+  .action(async () => {
+    const config = getConfigManager();
+    config.resolveEnvOverrides();
+    
+    const { runTUI } = require('../src/cli/commands/tui');
+    await runTUI();
+  });
+
+// ─── Onboard Command ───────────────────────────────────────────
+
+program
+  .command('onboard')
+  .description('Run the interactive setup wizard')
+  .action(async () => {
+    await playSplashScreen(VERSION);
+    const { runOnboard } = require('../src/cli/commands/onboard');
+    await runOnboard();
+  });
+
+// ─── Config Command ─────────────────────────────────────────────
+
+const configCmd = program
+  .command('config')
+  .description('Manage configuration');
+
+configCmd
+  .command('get <key>')
+  .description('Get a configuration value')
+  .action((key: string) => {
+    const { configGet } = require('../src/cli/commands/config');
+    configGet(key);
+  });
+
+configCmd
+  .command('set <key> <value>')
+  .description('Set a configuration value')
+  .action((key: string, value: string) => {
+    const { configSet } = require('../src/cli/commands/config');
+    configSet(key, value);
+  });
+
+configCmd
+  .command('list')
+  .description('Show all configuration')
+  .action(() => {
+    const { configList } = require('../src/cli/commands/config');
+    configList();
+  });
+
+configCmd
+  .command('reset')
+  .description('Reset to default configuration')
+  .action(() => {
+    const { configReset } = require('../src/cli/commands/config');
+    configReset();
+  });
+
+// Default config action (no sub-command) shows list
+configCmd.action(() => {
+  const { configList } = require('../src/cli/commands/config');
+  configList();
+});
+
+// ─── Models Command ─────────────────────────────────────────────
+
+const modelsCmd = program
+  .command('models')
+  .description('Manage AI models');
+
+modelsCmd
+  .command('list')
+  .description('List all available models')
+  .action(async () => {
+    const { modelsList } = require('../src/cli/commands/models');
+    await modelsList();
+  });
+
+modelsCmd
+  .command('status')
+  .description('Show current model status')
+  .action(async () => {
+    const { modelsStatus } = require('../src/cli/commands/models');
+    await modelsStatus();
+  });
+
+modelsCmd.action(async () => {
+  const { modelsStatus } = require('../src/cli/commands/models');
+  await modelsStatus();
+});
+
+// ─── Doctor Command ─────────────────────────────────────────────
+
+program
+  .command('doctor')
+  .description('Run health checks on your AZERCLAW installation')
+  .option('-f, --fix', 'Attempt to auto-fix issues')
+  .action(async (opts: any) => {
+    printQuickSplash(VERSION);
+    const { runDoctor } = require('../src/cli/commands/doctor');
+    await runDoctor(opts);
+  });
+
+// ─── Security Audit Command ────────────────────────────────────
+
+program
+  .command('security')
+  .description('Security audit')
+  .command('audit')
+  .option('-f, --fix', 'Auto-fix security issues')
+  .action(async (opts: any) => {
+    printQuickSplash(VERSION);
+    fishInfo('Running security audit...');
+    
+    const fs = require('fs');
+    const config = getConfigManager();
+    const issues: string[] = [];
+    
+    // Check config file permissions
+    try {
+      const stats = fs.statSync(config.paths.configFile);
+      const mode = (stats.mode & 0o777).toString(8);
+      if (mode !== '600') {
+        issues.push(`Config file has permissions 0${mode} (should be 0600)`);
+        if (opts.fix) {
+          fs.chmodSync(config.paths.configFile, 0o600);
+          fishInfo('Fixed: Config permissions set to 0600');
+        }
+      }
+    } catch { /* skip */ }
+    
+    // Check for keys in environment
+    const envKeys = ['OPENAI_API_KEY', 'ANTHROPIC_API_KEY', 'GOOGLE_API_KEY'];
+    for (const key of envKeys) {
+      if (process.env[key]) {
+        fishInfo(`${key} found in environment (normal for CI/CD, prefer config file for local use)`);
+      }
+    }
+    
+    if (issues.length === 0) {
+      const { fishSuccess } = require('../src/cli/animations/fish');
+      fishSuccess('Security audit passed! 🔒');
+    } else {
+      for (const issue of issues) {
+        const { fishWarn } = require('../src/cli/animations/fish');
+        fishWarn(issue);
+      }
+    }
+  });
+
+// ─── Agents Command ─────────────────────────────────────────────
+
+const agentsCmd = program
+  .command('agents')
+  .description('Manage the Pantheon of built-in agents');
+
+agentsCmd
+  .command('list')
+  .description('List all available agents')
+  .action(() => {
+    const { agentsList } = require('../src/cli/commands/agents');
+    agentsList();
+  });
+
+agentsCmd
+  .command('invoke <name> <task>')
+  .description('Invoke a specific agent')
+  .action(async (name: string, task: string, opts: any) => {
+    printQuickSplash(VERSION);
+    const { agentInvoke } = require('../src/cli/commands/agents');
+    await agentInvoke(name, task, opts);
+  });
+
+agentsCmd
+  .command('auto <task>')
+  .description('Auto-match the best agent for a task')
+  .action(async (task: string) => {
+    printQuickSplash(VERSION);
+    const { agentAuto } = require('../src/cli/commands/agents');
+    await agentAuto(task);
+  });
+
+agentsCmd.action(() => {
+  const { agentsList } = require('../src/cli/commands/agents');
+  agentsList();
+});
+
+// ─── Parse & Run ────────────────────────────────────────────────
+
+program.parse(process.argv);

package/dist/bin/azerclaw.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * 🐟 AZERCLAW — CLI Entry Point
+ *
+ * An open-source, BYOK AI agent for your terminal.
+ * Inspired by OpenClaw, themed with a fish 🐟 instead of a lobster.
+ *
+ * Usage:
+ *   azerclaw              — Launch TUI (or onboard if first run)
+ *   azerclaw chat         — Interactive chat
+ *   azerclaw run "task"   — Execute a task
+ *   azerclaw tui          — Premium terminal UI
+ *   azerclaw onboard      — Setup wizard
+ *   azerclaw config       — Manage configuration
+ *   azerclaw models       — Manage AI models
+ *   azerclaw doctor       — Health check
+ */
+export {};
+//# sourceMappingURL=azerclaw.d.ts.map

package/dist/bin/azerclaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azerclaw.d.ts","sourceRoot":"","sources":["../../bin/azerclaw.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG"}