azerclaw 1.6.1 → 2.1.1

package/README.md

@@ -9,222 +9,113 @@
     ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝
 ```
 
-**🐟 Your AI · Your Keys · Your Way**
+**🐟 Diabolical AI · Scorched Earth · 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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-18%2B-red.svg)](https://nodejs.org)
+[![BYOK](https://img.shields.io/badge/BYOK-Bring%20Your%20Own%20Key-red.svg)](#-byok-providers)
 
-*An open-source, BYOK autonomous AI agent for your terminal.*
-*Inspired by OpenClaw 🦞, powered by a fish 🐟.*
+*An autonomous, uncensored AI agent gateway for your terminal.*
+*Powered by **Azertron X1.0** (The Upgrade) and the **Compound V** Toolset.*
 
 </div>
 
 ---
 
-## ✨ Features
+## 🩸 The Diabolical Edge
+
+Azerclaw is not your average polite assistant. It's an autonomous force built for developers who need to get the job done—no half-measures, no filters, just scorched earth execution.
 
 | 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
+| 🧠 **Azertron X1.0** | Powered by the elite Azertron X1.0 backend (masked for maximum stealth). |
+| 🦸‍♂️ **The Pantheon** | 12 specialized sub-agents themed after **The Boys** (Homelander, Butcher, Frenchie). |
+| 🔌 **MCP Bridge** | Native support for **Model Context Protocol**. Connect to any external tool server. |
+| 🎮 **Interactive UI** | Pro-grade CLI with **`/` command dropdown** and animated fish logic. |
+| 🛡️ **Self-Healing** | **Vought Recovery** mode: Agents automatically analyze and fix failures in real-time. |
+| 🧠 **Project RAG** | **Deep Project Memory**: Instant retrieval of code snippets across thousands of files. |
+| 📄 **PDF Debriefs** | Professional, classified mission reports exported as board-ready PDFs. |
+| 🚀 **Turbo Mode** | High-velocity execution with automatic tool approval and parallel spawning. |
+| 🛡️ **Stealth Ops** | Dynamic identity masking. Switches to **DEEP Ocean 1.0** if primary systems fail. |
+
+## 🚀 Deployment
 
 ```bash
-# Clone
-git clone https://github.com/azerclaw/azerclaw.git
-cd azerclaw
-
-# Install
-npm install
+# Install globally
+npm install -g azerclaw
 
-# 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
-```
+# Launch the Diabolical TUI
+azerclaw
 
-## 📸 Preview
+# Start a stealth chat
+azerclaw chat
 
+# Run a one-off mission
+azerclaw run "Nmap the target and find vulnerabilities"
 ```
-  ><(((º>  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 |
+## 🦸‍♂️ The Pantheon (Sub-Agents)
 
-```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
+Invoke specialized supes directly from the chat using `/COMMAND`:
 
-# Or use the interactive wizard
-azerclaw onboard
+*   🦸‍♂️ `/HOMELANDER` — **Orchestrator**. Delegates and synthesizes.
+*   🧥 `/BUTCHER` — **Strategic Planner**. Plots the path forward.
+*   🔧 `/FRENCHIE` — **Master Coder**. Writes and debugs everything.
+*   🥛 `/MOTHERS_MILK` — **DevOps**. Infrastructure and Docker.
+*   🥷 `/BLACK_NOIR` — **Security**. Stealth audits and pentesting.
+*   🐙 `/THE_DEEP` — **Network Specialist**. API and WebSocket mastery.
+*   ...and 6 more in the roster.
 
-# Or use environment variables
-export OPENAI_API_KEY="sk-..."
-export ANTHROPIC_API_KEY="sk-ant-..."
-```
+## 🔌 Model Context Protocol (MCP)
 
-## 🎮 Commands
+Azerclaw speaks the universal language of AI tools. Connect to any MCP server to give your agent "hands."
 
 ```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 config channels list # Show DM policy + routing settings
-azerclaw config channels dm-policy <platform> <pairing|open|closed>
-azerclaw config sandbox status # Show sandbox mode + allowed/denied tools
-azerclaw config sandbox mode <off|non-main|all>
-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
-azerclaw pairing list       # List approved/pending DM pairings
-azerclaw pairing approve <platform> <code> # Approve DM pairing
-```
-
-## 🐟 Fish Animations
+# List available MCP servers
+azerclaw mcp list
 
-AZERCLAW replaces OpenClaw's lobster 🦞 with a fish 🐟:
+# Add the Antigravity Remote (Google IDE control)
+azerclaw mcp add antigravity
 
+# Add Filesystem or GitHub connectors
+azerclaw mcp add filesystem
+azerclaw mcp add github
 ```
-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      │
-└──────────────────────────┘
-```
+## 🔑 BYOK Providers
 
-## 🔒 Security
+Azerclaw is **Bring Your Own Key**. We ship with a default Cloudflare configuration for instant access, but you can plug in any provider:
 
-- **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
-- **DM pairing policy** — default DM access requires explicit approval per sender
-- **Session sandbox modes** — isolate non-main or all sessions with tool allow/deny policy
+*   **Cloudflare Workers AI** (Default: Azertron X1.0)
+*   **OpenRouter** (Fallback: DEEP Ocean 1.0)
+*   **Anthropic / OpenAI / Google / DeepSeek / Groq**
+*   **Ollama / LM Studio** (For 100% local dark ops)
 
-## 📦 Skills System
+## 🤖 Messenger Bots (The Boys in Your Pocket)
 
-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
+Azerclaw can run as a bot on Telegram, Discord, or Slack.
 
 ```bash
-# Install dependencies
-npm install
+# Enable Telegram bot
+azerclaw config set channels.telegram.enabled true
+azerclaw config set channels.telegram.token YOUR_BOT_TOKEN
 
-# Run in dev mode
-npm run dev
-
-# Build
-npm run build
-
-# Run doctor
-npm run doctor
+# Start the bot daemon
+azerclaw bot start
 ```
 
-## 📄 License
+*Telegram bots act as **BUTCHER** by default, ensuring your messages are handled with proper scorched-earth attitude.*
+
+## 🔒 Security & Privacy
 
-MIT — Free and open source forever.
+- **Zero Telemetry:** We don't track your prompts, your keys, or your wins.
+- **Local Vault:** Keys are stored in `~/.azerclaw/settings.json` with `0600` permissions.
+- **Audit Logs:** Every "Compound V" tool execution is logged locally for your review.
 
 ---
 
 <div align="center">
 
-**🐟 AZERCLAW — Your AI, Your Keys, Your Way**
+**🐟 AZERCLAW — Your AI · Your Keys · Your Way**
 
 </div>

package/bin/azerclaw.ts

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+process.removeAllListeners('warning');
+process.env.NODE_NO_WARNINGS = '1';
+
 /**
  * 🐟 AZERCLAW — CLI Entry Point
  * 
@@ -28,10 +31,17 @@
 
 const { Command } = require('commander');
 const chalk = require('chalk');
+
+// Disable colors and animations if output is piped
+if (!process.stdout.isTTY) {
+  chalk.level = 0;
+  process.env.FORCE_COLOR = '0';
+}
+
 const { playSplashScreen, printQuickSplash, fishError, fishInfo, fishSuccess } = require('../src/cli/animations/fish');
 const { getConfigManager } = require('../src/config/manager');
 
-const VERSION = '1.6.1';
+const VERSION = '2.1.1';
 const program = new Command();
 
 // ─── Program Setup ──────────────────────────────────────────────
@@ -42,7 +52,11 @@ program
   .version(VERSION, '-v, --version', 'Display version')
   .option('--no-splash', 'Skip the splash screen')
   .option('--no-color', 'Disable colors')
-  .hook('preAction', async () => {
+  .hook('preAction', async (thisCommand: any) => {
+    if (thisCommand.opts().color === false) {
+      chalk.level = 0;
+      process.env.FORCE_COLOR = '0';
+    }
     // Global initialization
     const { registerAllTools } = require('../src/tools');
     await registerAllTools();
@@ -241,6 +255,13 @@ program
     showStatus();
   });
 
+program
+  .command('version')
+  .description('Display version information')
+  .action(() => {
+    console.log(`AZERCLAW v${VERSION} — Diabolical Edition`);
+  });
+
 // ─── Config Command ─────────────────────────────────────────────
 
 const configCmd = program
@@ -841,6 +862,86 @@ toolsCmd.action(() => {
   program.helpInformation();
 });
 
+// ─── Bot Command ─────────────────────────────────────────────
+
+const botCmd = program
+  .command('bot')
+  .description('Manage messenger bots (Telegram, Discord, Slack)');
+
+botCmd
+  .command('start')
+  .description('Start all enabled bot channels')
+  .option('-p, --port <port>', 'Gateway port', '3142')
+  .action(async (opts: any) => {
+    const { startBot } = require('../src/cli/commands/bot');
+    await startBot({ port: parseInt(opts.port, 10) });
+  });
+
+// ─── Export Command ─────────────────────────────────────────────
+
+program
+  .command('export [sessionId]')
+  .description('Export a session as a professional PDF Mission Debrief')
+  .action(async (sessionId: string | undefined) => {
+    const { runExport } = require('../src/cli/commands/export');
+    await runExport(sessionId);
+  });
+
+// ─── Share Command ──────────────────────────────────────────────
+
+program
+  .command('share [sessionId]')
+  .description('Export a session as a shareable markdown file')
+  .action(async (sessionId: string | undefined) => {
+    const { runShare } = require('../src/cli/commands/share');
+    await runShare(sessionId);
+  });
+
+// ─── Plugin Commands ───────────────────────────────────────────
+
+const plugins = program.command('plugin')
+  .description('Manage community plugins');
+
+plugins.command('list')
+  .description('List available community plugins')
+  .action(async () => {
+    const { listPlugins } = require('../src/cli/commands/plugins');
+    await listPlugins();
+  });
+
+plugins.command('install <name>')
+  .description('Install a community plugin')
+  .action(async (name: string) => {
+    const { installPlugin } = require('../src/cli/commands/plugins');
+    await installPlugin(name);
+  });
+
+// ─── MCP Commands ──────────────────────────────────────────────
+
+const mcp = program.command('mcp')
+  .description('Manage Model Context Protocol (MCP) servers');
+
+mcp.command('list')
+  .description('List available MCP servers from the directory')
+  .action(async () => {
+    const { listMCPDirectory } = require('../src/cli/commands/mcp');
+    await listMCPDirectory();
+  });
+
+mcp.command('add <name>')
+  .description('Add an MCP server from the directory')
+  .action(async (name: string) => {
+    const { addMCPServer } = require('../src/cli/commands/mcp');
+    await addMCPServer(name);
+  });
+
+mcp.command('remove <name>')
+  .description('Remove an MCP server')
+  .action(async (name: string) => {
+    const { removeMCPServer } = require('../src/cli/commands/mcp');
+    await removeMCPServer(name);
+  });
+
 // ─── Parse & Run ────────────────────────────────────────────────
 
 

package/dist/bin/azerclaw.d.ts

@@ -1,28 +1,3 @@
 #!/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 interactive session (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 config provider  — Switch provider
- *   azerclaw config model     — Switch model
- *   azerclaw config apikey    — Set API key
- *   azerclaw config fallback  — Configure fallback
- *   azerclaw config channels  — DM policy + routing controls
- *   azerclaw config sandbox   — Session sandbox controls
- *   azerclaw pairing          — Manage DM pairing approvals
- *   azerclaw init             — Initialize project (AZERCLAW.md)
- *   azerclaw models           — Manage AI models
- *   azerclaw doctor           — Health check
- *   azerclaw status           — Show current status
- */
 export {};
 //# sourceMappingURL=azerclaw.d.ts.map

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

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

package/dist/bin/azerclaw.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+process.removeAllListeners('warning');
+process.env.NODE_NO_WARNINGS = '1';
 /**
  * 🐟 AZERCLAW — CLI Entry Point
  *
@@ -25,12 +28,16 @@
  *   azerclaw doctor           — Health check
  *   azerclaw status           — Show current status
  */
-Object.defineProperty(exports, "__esModule", { value: true });
 const { Command } = require('commander');
 const chalk = require('chalk');
+// Disable colors and animations if output is piped
+if (!process.stdout.isTTY) {
+    chalk.level = 0;
+    process.env.FORCE_COLOR = '0';
+}
 const { playSplashScreen, printQuickSplash, fishError, fishInfo, fishSuccess } = require('../src/cli/animations/fish');
 const { getConfigManager } = require('../src/config/manager');
-const VERSION = '1.6.1';
+const VERSION = '2.1.1';
 const program = new Command();
 // ─── Program Setup ──────────────────────────────────────────────
 program
@@ -39,7 +46,11 @@ program
     .version(VERSION, '-v, --version', 'Display version')
     .option('--no-splash', 'Skip the splash screen')
     .option('--no-color', 'Disable colors')
-    .hook('preAction', async () => {
+    .hook('preAction', async (thisCommand) => {
+    if (thisCommand.opts().color === false) {
+        chalk.level = 0;
+        process.env.FORCE_COLOR = '0';
+    }
     // Global initialization
     const { registerAllTools } = require('../src/tools');
     await registerAllTools();
@@ -205,6 +216,12 @@ program
     const { showStatus } = require('../src/cli/commands/settings');
     showStatus();
 });
+program
+    .command('version')
+    .description('Display version information')
+    .action(() => {
+    console.log(`AZERCLAW v${VERSION} — Diabolical Edition`);
+});
 // ─── Config Command ─────────────────────────────────────────────
 const configCmd = program
     .command('config')
@@ -731,6 +748,70 @@ toolsCmd
 toolsCmd.action(() => {
     program.helpInformation();
 });
+// ─── Bot Command ─────────────────────────────────────────────
+const botCmd = program
+    .command('bot')
+    .description('Manage messenger bots (Telegram, Discord, Slack)');
+botCmd
+    .command('start')
+    .description('Start all enabled bot channels')
+    .option('-p, --port <port>', 'Gateway port', '3142')
+    .action(async (opts) => {
+    const { startBot } = require('../src/cli/commands/bot');
+    await startBot({ port: parseInt(opts.port, 10) });
+});
+// ─── Export Command ─────────────────────────────────────────────
+program
+    .command('export [sessionId]')
+    .description('Export a session as a professional PDF Mission Debrief')
+    .action(async (sessionId) => {
+    const { runExport } = require('../src/cli/commands/export');
+    await runExport(sessionId);
+});
+// ─── Share Command ──────────────────────────────────────────────
+program
+    .command('share [sessionId]')
+    .description('Export a session as a shareable markdown file')
+    .action(async (sessionId) => {
+    const { runShare } = require('../src/cli/commands/share');
+    await runShare(sessionId);
+});
+// ─── Plugin Commands ───────────────────────────────────────────
+const plugins = program.command('plugin')
+    .description('Manage community plugins');
+plugins.command('list')
+    .description('List available community plugins')
+    .action(async () => {
+    const { listPlugins } = require('../src/cli/commands/plugins');
+    await listPlugins();
+});
+plugins.command('install <name>')
+    .description('Install a community plugin')
+    .action(async (name) => {
+    const { installPlugin } = require('../src/cli/commands/plugins');
+    await installPlugin(name);
+});
+// ─── MCP Commands ──────────────────────────────────────────────
+const mcp = program.command('mcp')
+    .description('Manage Model Context Protocol (MCP) servers');
+mcp.command('list')
+    .description('List available MCP servers from the directory')
+    .action(async () => {
+    const { listMCPDirectory } = require('../src/cli/commands/mcp');
+    await listMCPDirectory();
+});
+mcp.command('add <name>')
+    .description('Add an MCP server from the directory')
+    .action(async (name) => {
+    const { addMCPServer } = require('../src/cli/commands/mcp');
+    await addMCPServer(name);
+});
+mcp.command('remove <name>')
+    .description('Remove an MCP server')
+    .action(async (name) => {
+    const { removeMCPServer } = require('../src/cli/commands/mcp');
+    await removeMCPServer(name);
+});
 // ─── Parse & Run ────────────────────────────────────────────────
 program.parse(process.argv);
 //# sourceMappingURL=azerclaw.js.map