npm package: @madeinvibecoding/opensquad
Description: Multi-agent orchestration framework — create AI squads that work together
Author: Renato Asse
Latest version: 0.1.17

# @madeinvibecoding/opensquad

MCP Server para o framework [opensquad](https://github.com/renatoasse/opensquad) — use squads de agentes de IA em qualquer ferramenta MCP-compativel.

---

## O que e este pacote?

Este pacote e um **MCP Server** (Model Context Protocol) construido sobre o [opensquad](https://github.com/renatoasse/opensquad), o framework open source de orquestracao multi-agente criado por [Renato Asse](https://github.com/renatoasse).

O opensquad original funciona via slash commands dentro do Claude Code. Este MCP server **expoe as funcionalidades do framework como tools MCP**, permitindo que qualquer ferramenta compativel consiga listar, gerenciar e consultar squads, skills e agentes — sem depender do Claude Code.

### Ferramentas compativeis

- **Qwen Code**
- **Gemini CLI**
- **Cursor**
- **VS Code + Copilot**
- **Windsurf**
- **Claude Desktop**
- Qualquer cliente que suporte o protocolo MCP via stdio

---

## Instalacao e Configuracao

**Pre-requisito:** Node.js >= 20

### 1. Inicialize um projeto opensquad

```bash
npx @madeinvibecoding/opensquad init
```

### 2. Configure o MCP na sua ferramenta

Adicione ao arquivo de configuracao MCP da sua ferramenta:

```json
{
  "mcpServers": {
    "opensquad": {
      "command": "npx",
      "args": ["@madeinvibecoding/opensquad", "mcp"],
      "env": {
        "OPENSQUAD_PROJECT_DIR": "/caminho/absoluto/do/seu/projeto"
      }
    }
  }
}
```

### Onde colocar o JSON

| Ferramenta | Arquivo |
|------------|---------|
| Claude Code / Claude Desktop | `.mcp.json` na raiz do projeto |
| Cursor | `.cursor/mcp.json` |
| VS Code + Copilot | `.vscode/mcp.json` |
| Windsurf | `~/.windsurf/mcp.json` |
| Qwen Code | Settings > MCP Servers |
| Gemini CLI | `~/.gemini/settings.json` |

Pronto. A ferramenta vai conectar automaticamente e as 12 tools estarao disponiveis.

---

## Tools Disponiveis (12)

### Consulta

| Tool | O que faz |
|------|-----------|
| `get_project_status` | Status geral do projeto (versao, contagens) |
| `list_squads` | Lista todos os squads com status |
| `get_squad_detail` | Detalhes completos de um squad |
| `list_runs` | Historico de execucoes |
| `list_skills` | Skills instaladas no projeto |
| `list_available_skills` | Catalogo de skills disponiveis |
| `list_agents` | Agentes instalados no projeto |
| `list_available_agents` | Catalogo de agentes disponiveis |

### Acoes

| Tool | O que faz |
|------|-----------|
| `install_skill` | Instala uma skill do catalogo |
| `uninstall_skill` | Remove uma skill instalada |
| `install_agent` | Instala um agente do catalogo |
| `uninstall_agent` | Remove um agente instalado |

---

## Exemplos de Uso

Depois de configurar, basta pedir ao LLM da sua ferramenta:

- "Qual o status do meu projeto opensquad?"
- "Quais squads eu tenho?"
- "Me mostra os detalhes do squad carrossel-news"
- "Quais skills posso instalar?"
- "Instala a skill resend"
- "Mostra o historico de execucoes"

O LLM vai chamar as tools MCP automaticamente.

---

## O que o opensquad faz?

O opensquad e um framework que cria **squads de agentes de IA** que trabalham juntos. Cada squad e uma equipe com papeis definidos (pesquisador, redator, designer, revisor) que executa em pipeline com checkpoints de aprovacao humana.

Casos de uso:
- Producao de conteudo para redes sociais (carrosseis, posts, artigos)
- Campanhas de marketing e lancamentos
- Analise de dados e relatorios
- Tutoriais com screenshots automaticos
- Cortes de video automaticos
- E muito mais

Para saber mais sobre o framework completo, visite o [repositorio original](https://github.com/renatoasse/opensquad).

---

## Criar e executar squads via MCP

Embora o MCP server tenha sido projetado inicialmente apenas para consulta e gerenciamento, na pratica **LLMs como Qwen Code conseguem criar e executar squads completos** usando as tools MCP para entender a estrutura do projeto e replicar o formato dos squads existentes.

Testado e funcionando no Qwen Code: criacao de squad com 5 agentes, pipeline de 13 steps com checkpoints de aprovacao humana, propostas visuais e execucao completa.

## Limitacoes atuais

- **Transporte HTTP** — o server usa stdio (suficiente para clientes locais). HTTP pode vir em v2

---

## Creditos

### Projeto opensquad

Criado e mantido por [Renato Asse](https://github.com/renatoasse), fundador da [Comunidade Sem Codar](https://semcodar.com.br) — Escola de IA com mais de 25 mil alunos.

Repositorio original: [github.com/renatoasse/opensquad](https://github.com/renatoasse/opensquad)

### MCP Server

Desenvolvido por [Giovani Junior](https://github.com/giovani-junior-dev) ([@madeinvibecoding](https://www.npmjs.com/~madeinvibecoding)) para tornar o opensquad acessivel em qualquer ferramenta MCP-compativel, como Qwen Code, Gemini CLI, Cursor e VS Code.

---

## Licenca

MIT — use como quiser.