expxagents 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +130 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<h1 align="center">ExpxAgents</h1>
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Create and run AI squads with 93 specialized agents across 16 sectors</strong>
|
|
5
|
+
</p>
|
|
6
|
+
<p align="center">
|
|
7
|
+
<a href="https://www.npmjs.com/package/expxagents"><img src="https://img.shields.io/npm/v/expxagents.svg" alt="npm version"></a>
|
|
8
|
+
<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>
|
|
9
|
+
<img src="https://img.shields.io/badge/agents-93-brightgreen.svg" alt="93 agents">
|
|
10
|
+
<img src="https://img.shields.io/badge/sectors-16-orange.svg" alt="16 sectors">
|
|
11
|
+
<img src="https://img.shields.io/badge/node-%3E%3D20-green.svg" alt="Node >= 20">
|
|
12
|
+
</p>
|
|
13
|
+
</p>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
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.
|
|
18
|
+
|
|
19
|
+
## Quick Start
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# Initialize ExpxAgents in your project
|
|
23
|
+
npx expxagents init
|
|
24
|
+
|
|
25
|
+
# Set up your company profile
|
|
26
|
+
npx expxagents onboarding
|
|
27
|
+
|
|
28
|
+
# Create your first squad
|
|
29
|
+
npx expxagents create
|
|
30
|
+
|
|
31
|
+
# Run a squad
|
|
32
|
+
npx expxagents run my-squad
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## How It Works
|
|
36
|
+
|
|
37
|
+
1. **`expxagents init`** — Scaffolds the project structure (`squads/`, `_expxagents/_memory/`)
|
|
38
|
+
2. **`expxagents onboarding`** — Configures your company profile and preferences
|
|
39
|
+
3. **`expxagents create`** — The **Solution Architect** agent asks what you need and designs a squad with the right agents and pipeline
|
|
40
|
+
4. **`expxagents run <name>`** — The **Release Manager** agent executes the pipeline step by step, with checkpoints for your approval
|
|
41
|
+
5. Agents produce artifacts in `squads/<name>/output/`, and learnings are saved for future runs
|
|
42
|
+
|
|
43
|
+
## CLI Commands
|
|
44
|
+
|
|
45
|
+
| Command | Description |
|
|
46
|
+
|---------|-------------|
|
|
47
|
+
| `expxagents init` | Initialize ExpxAgents in the current project |
|
|
48
|
+
| `expxagents onboarding` | Set up company profile and preferences |
|
|
49
|
+
| `expxagents create` | Design a new squad interactively |
|
|
50
|
+
| `expxagents run <name>` | Execute a squad's pipeline |
|
|
51
|
+
| `expxagents list` | List all available squads |
|
|
52
|
+
| `expxagents stop <name>` | Stop a running squad |
|
|
53
|
+
| `expxagents server` | Start the dashboard server (port 3001) |
|
|
54
|
+
| `expxagents doctor` | Check system health and dependencies |
|
|
55
|
+
| `expxagents install <skill>` | Install a skill from the catalog |
|
|
56
|
+
| `expxagents uninstall <skill>` | Remove an installed skill |
|
|
57
|
+
|
|
58
|
+
## 93 Agents, 16 Sectors
|
|
59
|
+
|
|
60
|
+
| Sector | # | Agents |
|
|
61
|
+
|--------|:-:|--------|
|
|
62
|
+
| **Core** | 4 | Solution Architect, Release Manager, Platform Engineer, Insight Hunter |
|
|
63
|
+
| **Development** | 18 | Tech Lead, QA Engineer, DevOps, Backend, Frontend, iOS, Android, DBA, Security Analyst, UX Designer, and more |
|
|
64
|
+
| **Implantation** | 5 | Deployment Manager, Environment Specialist, Migration Specialist, Integration Specialist, Go-Live Coordinator |
|
|
65
|
+
| **Support** | 5 | L1 Support, L2 Support, L3 Support, Knowledge Base Manager, SLA Monitor |
|
|
66
|
+
| **Training** | 4 | Training Designer, Onboarding Coach, Assessment Creator, Workshop Facilitator |
|
|
67
|
+
| **Finance** | 4 | Billing Analyst, Financial Controller, Accounts Manager, Budget Planner |
|
|
68
|
+
| **HR** | 6 | Recruiter, Interview Coordinator, HR Onboarding, Performance Analyst, Benefits Manager, People & Culture |
|
|
69
|
+
| **Customer Success** | 5 | CSM, Churn Prevention, Expansion Manager, NPS Analyst, Renewal Manager |
|
|
70
|
+
| **Administrative** | 4 | Procurement Specialist, Document Controller, Office Manager, Process Documentation Officer |
|
|
71
|
+
| **Marketing** | 8 | Content Creator, SEO Specialist, Social Media Manager, Email Marketing, Paid Ads, Marketing Analyst, Brand Guardian, Landing Page Builder |
|
|
72
|
+
| **Commercial** | 5 | SDR, Account Executive, Proposal Writer, CRM Manager, Pricing Strategist |
|
|
73
|
+
| **R&D** | 5 | Market Researcher, Innovation Scout, Prototype Builder, Benchmark Analyst, Product Analyst |
|
|
74
|
+
| **Board** | 6 | Strategic Advisor, OKR Manager, Board Report Writer, Risk Analyst, Governance Officer, Business Intelligence |
|
|
75
|
+
| **Accounting** | 6 | Accountant, Tax Compliance, Fiscal Analyst, Payroll Specialist, Audit Analyst, Financial Reporting |
|
|
76
|
+
| **Legal** | 4 | Contract Manager, Legal Counsel, IP Specialist, Labor Attorney |
|
|
77
|
+
| **Compliance** | 4 | Compliance Officer, Data Privacy Specialist, Regulatory Monitor, Internal Auditor |
|
|
78
|
+
|
|
79
|
+
## Claude Code Plugin
|
|
80
|
+
|
|
81
|
+
ExpxAgents also works as a **Claude Code plugin** for IDE integration:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
# Install from Claude Code
|
|
85
|
+
/install-plugin https://github.com/bittencourtthulio/expxagents
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Then use `/expxagents` to access the main menu, create squads, run pipelines, and more — all from your editor.
|
|
89
|
+
|
|
90
|
+
## Core Architecture
|
|
91
|
+
|
|
92
|
+
| Agent | Role |
|
|
93
|
+
|-------|------|
|
|
94
|
+
| **Solution Architect** | Designs squads — analyzes requirements, selects agents, defines pipelines |
|
|
95
|
+
| **Release Manager** | Executes pipelines with checkpoints and agent handoffs |
|
|
96
|
+
| **Platform Engineer** | Manages skills, catalog, and system configuration |
|
|
97
|
+
| **Insight Hunter** | Researches company profiles, competitors, and market context |
|
|
98
|
+
|
|
99
|
+
## Project Structure
|
|
100
|
+
|
|
101
|
+
After `expxagents init`, your project will have:
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
your-project/
|
|
105
|
+
├── squads/ # Your squad configurations
|
|
106
|
+
│ └── <name>/
|
|
107
|
+
│ ├── squad.yaml # Squad definition (agents, pipeline, skills)
|
|
108
|
+
│ ├── squad-party.csv # Agent roster
|
|
109
|
+
│ ├── output/ # Generated artifacts (v1/, v2/, v3/)
|
|
110
|
+
│ └── _memory/ # Squad learnings
|
|
111
|
+
└── _expxagents/
|
|
112
|
+
└── _memory/
|
|
113
|
+
├── company.md # Your company profile
|
|
114
|
+
└── preferences.md # Language and settings
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Requirements
|
|
118
|
+
|
|
119
|
+
- **Node.js** >= 20
|
|
120
|
+
- **Claude Code** (optional, for plugin usage)
|
|
121
|
+
|
|
122
|
+
## Links
|
|
123
|
+
|
|
124
|
+
- [GitHub](https://github.com/bittencourtthulio/expxagents)
|
|
125
|
+
- [npm](https://www.npmjs.com/package/expxagents)
|
|
126
|
+
- [Issues](https://github.com/bittencourtthulio/expxagents/issues)
|
|
127
|
+
|
|
128
|
+
## License
|
|
129
|
+
|
|
130
|
+
[MIT](https://github.com/bittencourtthulio/expxagents/blob/main/LICENSE)
|