█████╗ ███████╗███████╗██████╗  ██████╗██╗      █████╗ ██╗    ██╗
    ██╔══██╗╚══███╔╝██╔════╝██╔══██╗██╔════╝██║     ██╔══██╗██║    ██║
    ███████║  ███╔╝ █████╗  ██████╔╝██║     ██║     ███████║██║ █╗ ██║
    ██╔══██║ ███╔╝  ██╔══╝  ██╔══██╗██║     ██║     ██╔══██║██║███╗██║
    ██║  ██║███████╗███████╗██║  ██║╚██████╗███████╗██║  ██║╚███╔███╔╝
    ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝

🐟 Diabolical AI · Scorched Earth · Your Way

An autonomous, uncensored AI agent gateway for your terminal. Powered by Azertron X2 (The Upgrade) and the Compound V Toolset.

🩸 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 | |---|---| | 🧠 Azertron X2 | Powered by the official DeepSeek V3/R1 logic engine (native & ultra-fast). | | 🦸‍♂️ 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

# Install globally
npm install -g azerclaw

# Launch the Diabolical TUI
azerclaw

# Start a stealth chat
azerclaw chat

# Run a one-off mission
azerclaw run "Nmap the target and find vulnerabilities"

🦸‍♂️ The Pantheon (Sub-Agents)

Invoke specialized supes directly from the chat using /COMMAND:

• 🦸‍♂️ /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.

🔌 Model Context Protocol (MCP)

Azerclaw speaks the universal language of AI tools. Connect to any MCP server to give your agent "hands."

# List available MCP servers
azerclaw mcp list

# Add the Antigravity Remote (Google IDE control)
azerclaw mcp add antigravity

# Add Filesystem or GitHub connectors
azerclaw mcp add filesystem
azerclaw mcp add github

🔑 BYOK Providers

Azerclaw is Bring Your Own Key. We ship with a default Cloudflare configuration for instant access, but you can plug in any provider:

• Cloudflare Workers AI (Default: Azertron X2)
• OpenRouter (Fallback: DEEP Ocean 1.0)
• Anthropic / OpenAI / Google / DeepSeek / Groq
• Ollama / LM Studio (For 100% local dark ops)

🤖 Messenger Bots (The Boys in Your Pocket)

Azerclaw can run as a bot on Telegram, Discord, or Slack.

# Enable Telegram bot
azerclaw config set channels.telegram.enabled true
azerclaw config set channels.telegram.token YOUR_BOT_TOKEN

# Start the bot daemon
azerclaw bot start

Telegram bots act as BUTCHER by default, ensuring your messages are handled with proper scorched-earth attitude.

🔒 Security & Privacy

• 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.

🐟 AZERCLAW — Your AI · Your Keys · Your Way