<p align="center">
  <h1 align="center">ExpxAgents</h1>
  <p align="center">
    <strong>Create and run AI squads with 93 specialized agents across 16 sectors</strong>
  </p>
  <p align="center">
    <a href="https://www.npmjs.com/package/expxagents"><img src="https://img.shields.io/npm/v/expxagents.svg" alt="npm version"></a>
    <a href="https://github.com/bittencourtthulio/expxagents/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
    <img src="https://img.shields.io/badge/agents-93-brightgreen.svg" alt="93 agents">
    <img src="https://img.shields.io/badge/sectors-16-orange.svg" alt="16 sectors">
    <img src="https://img.shields.io/badge/node-%3E%3D20-green.svg" alt="Node >= 20">
  </p>
</p>

---

ExpxAgents is a multi-agent orchestration platform that lets you create and run **AI squads** — teams of specialized agents that collaborate to execute complex workflows. Assemble squads for software development, marketing campaigns, financial analysis, HR processes, legal reviews, and much more.

## Quick Start

```bash
# Initialize ExpxAgents in your project
npx expxagents init

# Set up your company profile
npx expxagents onboarding

# Create your first squad
npx expxagents create

# Run a squad
npx expxagents run my-squad

# Open the virtual office (starts server if needed)
npx expxagents virtual-office
```

## How It Works

1. **`expxagents init`** — Scaffolds the project structure (`squads/`, `_expxagents/_memory/`)
2. **`expxagents onboarding`** — Configures your company profile and preferences
3. **`expxagents create`** — The **Solution Architect** agent asks what you need and designs a squad with the right agents and pipeline
4. **`expxagents run <name>`** — The **Release Manager** agent executes the pipeline step by step, with checkpoints for your approval
5. Agents produce artifacts in `squads/<name>/output/`, and learnings are saved for future runs

## CLI Commands

| Command | Description |
|---------|-------------|
| `expxagents init` | Initialize ExpxAgents in the current project |
| `expxagents onboarding` | Set up company profile and preferences |
| `expxagents create` | Design a new squad interactively |
| `expxagents run <name>` | Execute a squad's pipeline |
| `expxagents list` | List all available squads |
| `expxagents stop <name>` | Stop a running squad |
| `expxagents server` | Start the dashboard server (port 3001) |
| `expxagents virtual-office` | Open the virtual office in browser |
| `expxagents doctor` | Check system health and dependencies |
| `expxagents install <skill>` | Install a skill from the catalog |
| `expxagents uninstall <skill>` | Remove an installed skill |

## 93 Agents, 16 Sectors

| Sector | # | Agents |
|--------|:-:|--------|
| **Core** | 4 | Solution Architect, Release Manager, Platform Engineer, Insight Hunter |
| **Development** | 18 | Tech Lead, QA Engineer, DevOps, Backend, Frontend, iOS, Android, DBA, Security Analyst, UX Designer, and more |
| **Implantation** | 5 | Deployment Manager, Environment Specialist, Migration Specialist, Integration Specialist, Go-Live Coordinator |
| **Support** | 5 | L1 Support, L2 Support, L3 Support, Knowledge Base Manager, SLA Monitor |
| **Training** | 4 | Training Designer, Onboarding Coach, Assessment Creator, Workshop Facilitator |
| **Finance** | 4 | Billing Analyst, Financial Controller, Accounts Manager, Budget Planner |
| **HR** | 6 | Recruiter, Interview Coordinator, HR Onboarding, Performance Analyst, Benefits Manager, People & Culture |
| **Customer Success** | 5 | CSM, Churn Prevention, Expansion Manager, NPS Analyst, Renewal Manager |
| **Administrative** | 4 | Procurement Specialist, Document Controller, Office Manager, Process Documentation Officer |
| **Marketing** | 8 | Content Creator, SEO Specialist, Social Media Manager, Email Marketing, Paid Ads, Marketing Analyst, Brand Guardian, Landing Page Builder |
| **Commercial** | 5 | SDR, Account Executive, Proposal Writer, CRM Manager, Pricing Strategist |
| **R&D** | 5 | Market Researcher, Innovation Scout, Prototype Builder, Benchmark Analyst, Product Analyst |
| **Board** | 6 | Strategic Advisor, OKR Manager, Board Report Writer, Risk Analyst, Governance Officer, Business Intelligence |
| **Accounting** | 6 | Accountant, Tax Compliance, Fiscal Analyst, Payroll Specialist, Audit Analyst, Financial Reporting |
| **Legal** | 4 | Contract Manager, Legal Counsel, IP Specialist, Labor Attorney |
| **Compliance** | 4 | Compliance Officer, Data Privacy Specialist, Regulatory Monitor, Internal Auditor |

## Claude Code Plugin

ExpxAgents also works as a **Claude Code plugin** for IDE integration:

```bash
# Install from Claude Code
/install-plugin https://github.com/bittencourtthulio/expxagents
```

Then use `/expxagents` to access the main menu, create squads, run pipelines, open the virtual office, and more — all from your editor.

## Core Architecture

| Agent | Role |
|-------|------|
| **Solution Architect** | Designs squads — analyzes requirements, selects agents, defines pipelines |
| **Release Manager** | Executes pipelines with checkpoints and agent handoffs |
| **Platform Engineer** | Manages skills, catalog, and system configuration |
| **Insight Hunter** | Researches company profiles, competitors, and market context |

## Project Structure

After `expxagents init`, your project will have:

```
your-project/
├── squads/                    # Your squad configurations
│   └── <name>/
│       ├── squad.yaml         # Squad definition (agents, pipeline, skills)
│       ├── squad-party.csv    # Agent roster
│       ├── output/            # Generated artifacts (v1/, v2/, v3/)
│       └── _memory/           # Squad learnings
└── _expxagents/
    └── _memory/
        ├── company.md         # Your company profile
        └── preferences.md    # Language and settings
```

## Requirements

- **Node.js** >= 20
- **Claude Code** (optional, for plugin usage)

## Links

- [GitHub](https://github.com/bittencourtthulio/expxagents)
- [npm](https://www.npmjs.com/package/expxagents)
- [Issues](https://github.com/bittencourtthulio/expxagents/issues)

## License

[MIT](https://github.com/bittencourtthulio/expxagents/blob/main/LICENSE)
