The Invisible Power Addon for Vibe Coding CLI

AutomatosX transforms your AI coding assistant into a multi-agent enterprise platform - with 20+ specialized agents, persistent memory, and 80% cost savings through intelligent multi-provider routing. You keep using Claude Code or Codex exactly as before, but now with superpowers.

Status: ✅ Production Ready | v12.6.2 | Test Coverage Improvements

🎯 What AutomatosX Does: Adds 20+ specialized agents, persistent memory, workflow automation, and 80% cost savings to Claude Code/Codex - without changing how you work.

💡 No Learning Curve: Keep using Claude Code naturally. AutomatosX runs invisibly in the background, giving you enterprise capabilities automatically.

⚡ The Problem (Before AutomatosX)

Claude Code is amazing, but...

❌ Expensive: $150-300/mo API costs for heavy users
❌ No Memory: Loses context between sessions (wasted tokens)
❌ Single Agent: No specialized experts (backend, security, etc.)
❌ No Multi-Provider: Locked into one provider (no cost optimization)
❌ No Observability: Can't track what AI is doing (compliance issue)
❌ No Workflows: Manual coordination for complex tasks

Total Monthly Cost: $170-320/mo (Claude Pro + API usage)

✨ The Solution (After AutomatosX)

Same Claude Code experience, but with superpowers:

✅ 80% Cost Savings: $60/mo total (multi-provider routing)
✅ Perfect Memory: Remembers everything forever (SQLite FTS5)
✅ 20+ Specialized Agents: Backend, security, DevOps experts
✅ Multi-Provider: Auto-routes to Claude/Gemini/OpenAI optimally
✅ Complete Observability: JSONL trace logs for every decision
✅ Workflow Automation: YAML specs for complex multi-step tasks

Total Monthly Cost: $60/mo (same unlimited usage)

💰 Savings: $110-260/mo per developer | $1,320-3,120/year per developer

🎨 How It Works (The Magic)

┌────────────────────────────────────────────────────────────────┐
│                    You (Developer)                              │
│        "Build user authentication with security audit"          │
└────────────────────────────────────────────────────────────────┘
                              ↓
                      [Claude Code]
                   (Your familiar interface)
                              ↓
┌────────────────────────────────────────────────────────────────┐
│                       AutomatosX                                │
│              (Invisible Power Layer)                            │
│                                                                  │
│  • Routes to optimal provider (cost + performance)              │
│  • Delegates to specialized agents (backend → security)         │
│  • Saves everything to persistent memory (zero repetition)      │
│  • Logs all decisions (complete observability)                  │
└────────────────────────────────────────────────────────────────┘
                              ↓
        ┌─────────────────────┼─────────────────────┐
        ↓                     ↓                     ↓
  ┌──────────┐          ┌──────────┐          ┌──────────┐
  │  Claude  │          │  Gemini  │          │ OpenAI   │
  │ (Reason) │          │  (Code)  │          │  (Speed) │
  └──────────┘          └──────────┘          └──────────┘
        ↓                     ↓                     ↓
                      [MCP Servers]
              Filesystem • Git • Database

You: Talk to Claude Code naturally (no new commands!)

AutomatosX: Invisibly orchestrates multi-agent execution, optimizes costs, saves to memory

You Get: Better results, 80% lower costs, perfect context - automatically

🚀 Quick Start (60 Seconds)

Step 1: Install AutomatosX

npm install -g @defai.digital/automatosx

Step 2: Initialize in Your Project

Option A: With Claude Code Native Integration (Recommended)

cd your-project
ax setup --claude-code

What you get:

• ✅ 18 slash commands (/agent-backend, /agent-frontend, etc.)
• ✅ Multi-agent orchestration (/automatosx)
• ✅ MCP server with 17 tools
• ✅ Auto-generated manifests
• ✅ One-command diagnostics (ax doctor --claude-code)

Option B: Invisible Mode (Original)

cd your-project
ax setup

What you get:

• ✅ Invisible integration (no new commands)
• ✅ Automatic multi-agent delegation
• ✅ Persistent memory
• ✅ Cost optimization

That's it! AutomatosX is now running. Keep using Claude Code naturally.

Step 3: Use Claude Code Naturally (No New Commands!)

Just talk to Claude Code like you always do:

"Build user authentication with JWT. Save the design to memory for future reference."

Behind the scenes, AutomatosX automatically:

• Routes to Gemini (cost-efficient for implementation)
• Delegates security audit to Claude (best reasoning)
• Saves everything to persistent memory (zero token waste)
• Logs all decisions (complete audit trail)

You see: Natural Claude Code response, but better and cheaper!

💬 Natural Language Examples (How You'll Use It)

Example 1: Multi-Agent Collaboration

You say to Claude Code:

"Work with AutomatosX agents to build a payment system.
Let the backend agent implement the API, security agent audit it,
and quality agent write tests. Save everything to memory."

What AutomatosX does automatically:

1. Product agent designs architecture
2. Backend agent implements API (routed to Gemini - cost-efficient)
3. Security agent audits code (routed to Claude - best reasoning)
4. Quality agent writes tests (routed to Gemini - fast)
5. Everything saved to memory for future tasks
6. Complete trace log for observability

Cost: $0 additional (using CLI subscriptions) Time: 60% faster (parallel execution) Quality: 3 specialized agents vs 1 generalist

Example 2: Persistent Memory

Day 1 - You say:

"Design a calculator app with add/subtract features.
Save the architecture to AutomatosX memory."

Day 7 - You say:

"Implement the calculator API we designed last week."

AutomatosX automatically:

• Searches memory for "calculator" design
• Injects full context into prompt (< 1ms search)
• Zero token waste (no repetition)
• Perfect continuity (like talking to same person)

Savings: 50-80% fewer tokens (no context repetition)

Example 3: Cost Optimization

You say:

"Review this 10,000-line codebase for bugs.
Use cost-efficient routing - this is routine analysis."

AutomatosX automatically:

• Routes to Gemini (routine task = cost-efficient)
• Uses Gemini Advanced unlimited plan ($20/mo)
• Instead of Claude API ($150-300/mo for this volume)
• Same quality, 80% cost savings

API Cost (without AutomatosX): ~$45 (10K lines × $15/1M tokens) CLI Cost (with AutomatosX): $0 (already paying $20/mo Gemini Advanced)

🎯 What You Get (Automatically)

1. 20+ Specialized Agents

No setup needed - just mention them in conversation:

• Backend Agent (Bob): Go/Rust systems, API design, databases
• Security Agent (Steve): Threat modeling, penetration testing, audits
• Frontend Agent (Frank): React/Next.js, UI/UX, responsive design
• DevOps Agent (Oliver): CI/CD, Kubernetes, infrastructure
• Quality Agent (Queenie): Test planning, QA automation
• Product Agent (Paris): Requirements, roadmaps, user stories
• Data Agent (Daisy): ETL pipelines, data warehouses
• ... 13 more agents

Example:

"Security agent, please audit this authentication code."
"Backend agent, optimize this database query."
"DevOps agent, set up the CI/CD pipeline."

2. Persistent Memory (Context That Never Expires)

Automatic - no configuration needed:

• ✅ < 1ms Search: SQLite FTS5 full-text search
• ✅ $0 Cost: No embedding APIs (pure local)
• ✅ 100% Private: Data never leaves your machine
• ✅ Forever: Infinite context window (not limited to session)
• ✅ Smart: Auto-injects relevant context from past conversations

Example:

Week 1: "Design microservices architecture"
       → Saved to memory automatically

Week 2: "Implement user service"
       → Memory auto-injects Week 1 architecture
       → Zero manual context passing

3. Multi-Provider Cost Optimization

Intelligent routing - completely automatic:

| Task Type | Routed To | Why | Cost | |-----------|-----------|-----|------| | Architecture design | Claude | Best reasoning | $20/mo unlimited | | Code implementation | Gemini | Cost-efficient | $20/mo unlimited | | Security audit | Claude | Critical accuracy | $20/mo unlimited | | Test generation | Gemini | Fast & reliable | $20/mo unlimited | | Quick questions | ChatGPT | Fastest response | $20/mo unlimited |

Total: $60/mo for unlimited usage across all providers

vs API-only: $150-300/mo with per-token billing

Savings: 80% monthly cost reduction

4. Complete Observability

Automatic trace logging - no setup:

• ✅ Who executed what task
• ✅ Which provider was used
• ✅ How much it cost (tokens)
• ✅ Delegation chains (agent → agent)
• ✅ Execution time and results

Perfect for: Compliance audits, debugging, optimization

5. Workflow Automation

Define complex workflows once, reuse forever:

# .automatosx/workflows/release.ax.yaml
metadata:
  name: Production Release Workflow

steps:
  - Quality agent runs full test suite (Gemini - fast)
  - Security agent audits for vulnerabilities (Claude - thorough)
  - DevOps agent deploys to staging (Gemini - routine)
  - Product agent validates requirements (Claude - critical)
  - DevOps agent deploys to production (Gemini - routine)

You say to Claude Code:

"Run the production release workflow"

AutomatosX executes everything automatically, with optimal provider routing.

6. Autonomous Bug Fixing (v12.4.0+)

Automatically detect and fix common bugs in your codebase:

# Scan and fix timer leaks, missing destroy(), and resource issues
ax bugfix

# Dry-run mode (preview fixes without applying)
ax bugfix --dry-run

# Focus on specific directory
ax bugfix --scope src/core/

# Fix specific bug types only
ax bugfix --types timer_leak,missing_destroy

What AutomatosX detects and fixes:

• Timer Leaks: setInterval/setTimeout without cleanup
• Missing Destroy: EventEmitters without destroy() method
• Promise Timeout Leaks: Timeouts not cleared in error paths
• Event Leaks: Event listeners without cleanup

Safe by default:

• Creates backups before any changes
• Runs TypeScript typecheck after each fix
• Runs tests to verify fixes don't break functionality
• Automatic rollback if verification fails

Example output:

[ax bugfix] Scanning src/ for bugs...
[ax bugfix] Found 18 potential issues:
  - 12 timer_leak (setInterval without .unref())
  - 4 missing_destroy (EventEmitter subclass)
  - 2 promise_timeout_leak

[ax bugfix] Fixing timer_leak in src/core/worker-pool.ts:447
  - Replaced setInterval with createSafeInterval
  - Verification: TypeScript ✓ Tests ✓

[ax bugfix] Complete: 15/18 bugs fixed, 3 require manual review

MCP Integration - Use bugfix via Quality agent from Claude Code:

# Via Quality agent (recommended - full context and orchestration)
run_agent({ agent: "quality", task: "scan src/ for code health issues" })
run_agent({ agent: "quality", task: "run bugfix workflow with dry-run" })

💰 Cost Comparison (Real Numbers)

Heavy User (100K tokens/day)

Before AutomatosX (Claude API only):

100K tokens/day × 30 days = 3M tokens/month
3M input × $3/1M = $9/mo
3M output × $15/1M = $45/mo
Claude Code Pro: $20/mo
Total: $74/mo (likely $150-300/mo in reality)

After AutomatosX (Multi-provider CLI):

Claude Code Pro: $20/mo (20% of tasks)
Gemini Advanced: $20/mo (70% of tasks)
ChatGPT Plus: $20/mo (10% of tasks)
Total: $60/mo (unlimited usage)

Savings: $90-240/mo (60-80% reduction)

Team of 5 Developers

Before: 5 × $200/mo average = $1,000/mo

After: 5 × $60/mo = $300/mo

Savings: $700/mo | $8,400/year

Enterprise (50 Developers)

Before: 50 × $200/mo = $10,000/mo

After: 50 × $60/mo + $500/mo Enterprise = $3,500/mo

Savings: $6,500/mo | $78,000/year

🏢 Enterprise Features (Invisible, Automatic)

Offline-Friendly & Compliance-Ready

Unlike cloud-dependent tools, AutomatosX works in air-gapped environments:

• ✅ 100% Local: All data stays on your machine
• ✅ Offline Mode: Works without internet (with Ollama)
• ✅ Audit Trails: Complete JSONL trace logging
• ✅ Data Sovereignty: No data leaves your infrastructure
• ✅ GDPR/HIPAA Ready: Built for regulated industries

Perfect for: Government, finance, healthcare

Secure & Sandboxed

Enterprise security controls (automatic):

• ✅ Filesystem Sandboxing: Agents can't access outside project directory
• ✅ Resource Limits: CPU/memory caps per agent
• ✅ Network Restrictions: Control API access
• ✅ Dangerous Operation Detection: Auto-blocks risky commands
• ✅ Audit Logging: Every file access, API call logged

Complete Observability

Transform AI agents into governable workforce:

• ✅ Real-time execution traces (JSONL)
• ✅ Token usage tracking (prevent budget overruns)
• ✅ Provider performance metrics
• ✅ Resource monitoring (CPU, memory)
• ✅ Delegation chains (full transparency)
• ✅ Cost attribution (per-agent, per-task)

📦 AutomatosX Editions

Edition Positioning

Pro – For teams that want priority support & stable releases

Enterprise – For organizations needing compliance, control, and confidence at scale

🔷 AutomatosX Pro

For startups, SMEs, and teams that want stability and support.

Feature Highlights

Core Platform:

• ✅ Priority email support & maintenance - Dedicated support with SLA
• ✅ Stable LTS releases - Long-term support for production
• ✅ Commercial use licensing - Clear licensing for business use

Advanced Workflows:

• ✅ Advanced workflow templates - SaaS, RAG, API orchestration, CI/CD
• ✅ Multi-project management - Switch contexts, reuse workflows
• ✅ Custom agent packs - Team-specific expertise

Provider & Configuration:

• ✅ Per-project provider profiles - Different Claude/Gemini configs per project
• ✅ Local memory encryption - Secure persistent memory
• ✅ Backup & restore - Export/import workflows and memory

Observability:

• ✅ Run history & usage dashboard - Track execution history
• ✅ MCP auto-install & hot-reload - Automatic server management

Perfect for: Startups, consultancies, product teams

🏢 AutomatosX Enterprise

For organizations where "Enterprises pay for compliance, convenience, and confidence - not just security."

Compliance & Governance

Audit & Control:

• ✅ Centralized control plane (self-hosted) - Org-wide management
• ✅ Org-wide workflow catalog with approvals - Governed library
• ✅ SSO (SAML/OIDC) & granular RBAC - Enterprise auth
• ✅ Audit-grade logs - Complete trail of who ran what
• ✅ Data retention & deletion policies - Lifecycle management

Data Protection:

• ✅ PII masking / DLP hooks - Data loss prevention
• ✅ Compliance-ready architecture - GDPR, HIPAA, SOC2

Convenience & Control

Infrastructure Management:

• ✅ Multi-node agent management - Manage across dev/CI/prod
• ✅ Central provider routing & failover - Org-wide policies
• ✅ Quota & rate limits - Control usage by team/project
• ✅ Central MCP registry - Health monitoring, versioning

Observability at Scale:

• ✅ Org dashboards - Real-time visibility (runs, success, latency, tokens)
• ✅ OpenTelemetry / SIEM integration - Prometheus, Splunk, Datadog
• ✅ Advanced analytics - Cost attribution, performance trends

Confidence & Support

Enterprise Infrastructure:

• ✅ Hardened, self-hosted deployment - Docker/Helm for air-gapped
• ✅ HA / backup & disaster recovery - Automated failover
• ✅ Multi-region support - Data sovereignty

Premium Support:

• ✅ Enterprise SLA & named technical contact - Guaranteed response times
• ✅ Onboarding workshops & playbooks - Expert guidance
• ✅ Optional design partnership - Influence roadmap

Perfect for: Regulated industries (finance, healthcare, government), enterprises with compliance requirements

🆚 Edition Comparison

| Feature | Open Source | Pro | Enterprise | |---------|-------------|-----|------------| | Core Orchestration | ✅ Full | ✅ Full | ✅ Full | | Multi-Provider Support | ✅ Yes | ✅ Yes | ✅ Yes | | Persistent Memory | ✅ Yes | ✅ Encrypted | ✅ Encrypted + DLP | | MCP Management | ✅ Local | ✅ Auto-install | ✅ Central registry | | Support | Community | Priority email | Enterprise SLA | | LTS Releases | ❌ No | ✅ Yes | ✅ Yes + backports | | Multi-Project | Manual | ✅ Managed | ✅ Org catalog | | Custom Agents | DIY | ✅ Agent packs | ✅ Org library | | Observability | Local logs | ✅ Dashboard | ✅ SIEM integration | | Deployment | Local only | Local only | ✅ Self-hosted cluster | | SSO / RBAC | ❌ No | ❌ No | ✅ Yes | | Audit Logs | Basic | Basic | ✅ Compliance-grade | | Data Governance | ❌ No | ❌ No | ✅ Full DLP + policies | | Pricing | Free (OSS) | Contact sales | Contact sales |

📞 Get Started with Pro or Enterprise

AutomatosX Pro: Perfect for commercial teams needing stability and support

• Email: [email protected]
• Subject: "AutomatosX Pro - Pricing Inquiry"

AutomatosX Enterprise: For organizations requiring compliance at scale

• Email: [email protected]
• Subject: "AutomatosX Enterprise - Compliance Discussion"

Questions about licensing? See COMMERCIAL-LICENSE.md

🏆 Why AutomatosX Wins

| Capability | AutomatosX | Claude Code | Gemini CLI | Cursor | |------------|------------|-------------|------------|--------| | Role | Power addon | AI assistant | AI assistant | AI editor | | Learning Curve | Zero (use naturally) | Low | Low | Medium | | Multi-Provider | ✅ Auto-routing | ⚠️ Claude only | ⚠️ Gemini only | ⚠️ Limited | | Cost Savings | ✅ 80% via routing | ❌ Pay-as-you-go | ❌ Pay-as-you-go | ❌ Pay-as-you-go | | Persistent Memory | ✅ Forever | ❌ Session-only | ❌ Session-only | ❌ Session-only | | Multi-Agent Teams | ✅ 20 specialists | ❌ Single agent | ❌ Single agent | ❌ Single agent | | Workflow Automation | ✅ YAML specs | ❌ | ❌ | ❌ | | Observability | ✅ Complete traces | ⚠️ Basic | ⚠️ Basic | ⚠️ Basic | | Offline-Friendly | ✅ 100% local | ⚠️ Hybrid | ⚠️ Hybrid | ⚠️ Cloud | | Compliance | ✅ GDPR-ready | ❌ | ❌ | ❌ |

Bottom Line: AutomatosX is the only power addon that gives you enterprise capabilities without changing your workflow.

📚 Real-World Use Cases

1. Startup Reducing AI Costs by 80%

Scenario: Small team, limited budget

"Build user authentication with security audit and tests.
Use cost-efficient routing - this is a standard feature."

What AutomatosX does:

• Routes implementation to Gemini ($20/mo unlimited)
• Routes security audit to Claude (critical accuracy)
• Generates tests with Gemini (fast)
• Saves design to memory (zero token waste in future)

Cost: $40/mo total (Claude Pro + Gemini Advanced) vs API-only: $200-300/mo Savings: $160-260/mo (80% reduction)

2. Enterprise Ensuring Compliance

Scenario: Finance company with GDPR requirements

"Review this payment processing code for vulnerabilities.
Log everything for compliance audit."

What AutomatosX does:

• Executes entirely offline (no data leaves company)
• Generates complete JSONL audit trail
• Uses local models via Ollama (air-gapped)
• Saves to encrypted local memory

Compliance: ✅ GDPR-ready, complete audit trail Security: ✅ Zero data exfiltration Cost: ✅ No cloud API costs

3. Team Coordinating Multi-Agent Workflows

Scenario: 5 developers building microservices

"Product agent, design payment service.
Backend agent, implement it.
Security agent, audit it.
Quality agent, write tests.
Save everything to shared memory."

What AutomatosX does:

• Product → Backend → Security → Quality (automatic delegation)
• Routes to optimal providers (cost + performance)
• Shared memory across team (perfect context)
• Parallel execution (3-5x faster)

Result: 5x productivity, 80% cost savings, zero manual coordination

🎓 Documentation

Getting Started (5 Minutes)

• Quick Start Guide - Get productive fast
• Installation - Detailed setup

Natural Language Usage (Recommended)

• Using with Claude Code - Best practices
• Using with Codex CLI - Natural language examples
• Agent Collaboration - Multi-agent workflows

Advanced Features

• Cost Optimization Strategies - Save 80%
• Persistent Memory Guide - Context management
• Workflow Automation - YAML workflows
• Observability - Trace logging

For Advanced Users (5% Who Need CLI)

• Full Features List - All CLI commands and capabilities
• CLI Command Reference - Complete CLI docs
• API Reference - Programmatic usage

Enterprise

• Security & Compliance - GDPR, HIPAA, SOC2
• Offline Deployment - Air-gapped environments
• Multi-Region Setup - Data sovereignty

💻 Installation

NPM (Recommended)

npm install -g @defai.digital/automatosx
ax --version  # v12.0.1

Initialize Your Project

cd your-project
ax setup

What ax setup does:

• ✅ Creates .automatosx/ directory
• ✅ Installs all 20 specialized agents
• ✅ Generates optimal configuration
• ✅ Initializes persistent memory database
• ✅ Sets up trace logging

That's it! Now just use Claude Code/Codex naturally - AutomatosX runs invisibly.

Requirements

• Node.js: >= 24.0.0
• At least one AI CLI (you probably already have):
  • Claude Code - Recommended (best reasoning)
  • Gemini CLI - Cost-efficient
  • Codex CLI - Fastest

Optional:

• ax-cli - GLM-first native CLI for Chinese models

🚦 Production Readiness

✅ v12.0.1 Released - Bug Fixes & Provider Architecture Improvements ✅ 2,512+ Tests Passing - Comprehensive coverage ✅ TypeScript Strict Mode - Type-safe codebase ✅ Zero Resource Leaks - Clean shutdown guaranteed ✅ Cross-Platform - macOS, Windows, Ubuntu ✅ 100% Local-First - No cloud dependencies ✅ Enterprise-Ready - Observability, governance, compliance

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md

Development Setup

git clone https://github.com/defai-digital/automatosx.git
cd automatosx
npm install
npm test

📦 Editions & Licensing

AutomatosX uses an open-core model with three editions:

| Edition | License | Price | Best For | |---------|---------|-------|----------| | Open Source | Apache 2.0 | Free Forever | Everyone (individuals, startups, enterprises) | | Pro | Commercial EULA | Contact Sales | Teams needing priority support + LTS | | Enterprise | Enterprise Agreement | Contact Sales | Regulated industries + compliance needs |

Open Source Edition (This Repo)

License: Apache License 2.0 - Free forever, no revenue limits

What's Included:

• ✅ Full source code on GitHub
• ✅ Core orchestration engine + 20+ AI agents
• ✅ Persistent memory system (SQLite FTS5)
• ✅ Multi-provider routing (Claude, Gemini, Codex CLI)
• ✅ Workflow specs and execution
• ✅ Community support (GitHub Issues)

Who Can Use: Anyone, for any purpose (personal, commercial, research)

Pro & Enterprise Editions

Additional Features: Advanced workflows, team collaboration, premium agent packs, SSO/RBAC, audit logging, self-hosted deployment, white-label options, priority support (1-day SLA), long-term support (LTS), custom SLA (24/7 available)

Get Started: Contact [email protected] for pricing

Learn More: See COMMERCIAL-LICENSE.md for detailed edition comparison

Copyright 2025 DEFAI Private Limited

Note: We removed revenue thresholds ($2M limit) and OpenRAIL-M references in v3.0 (November 2025). Open Source Edition is now truly free for everyone - no limits, no tracking. If you need extra features or guaranteed support, explore Pro/Enterprise editions.

🌟 Star Us on GitHub

If AutomatosX saves you 80% on AI costs without changing your workflow, give us a star! ⭐

⭐ Star on GitHub

📧 Support

• Issues: GitHub Issues
• Email: [email protected]
• Commercial Licenses: [email protected]