⚒️ AgentForge

Donde se forjan agentes de IA — orquestación para Claude Code y Codex

Mantenido por Soulcynics404 · Harsshh

Inicio Rápido · Instalación · Integración con Claude Code · Comandos de Enjambre · Servidor MCP · Documentación

Agente = Modelo + Arnés. El modelo escribe; el arnés le da herramientas, memoria, bucles, sandboxes y controles para que pueda trabajar de verdad. AgentForge es ese arnés — la capa de ejecución alrededor de Claude Code y Codex que añade más de 100 agentes especializados, enjambres coordinados, memoria de autoaprendizaje y salvaguardas empresariales. Así los agentes no solo se ejecutan, colaboran.

AgentForge es un fork mantenido activamente de Ruflo (anteriormente claude-flow) por rUv, renombrado y mantenido de forma independiente bajo la licencia MIT. Todo el crédito de la arquitectura original va para el proyecto upstream y sus contribuyentes.

✨ Lo que obtienes

User ──▶ AgentForge (CLI / MCP) ──▶ Router ──▶ Swarm ──▶ Agents ──▶ Memory ──▶ LLM Providers
                ▲                                                        │
                └────────────────── Learning Loop ◀──────────────────────┘

Related MCP server: Cognitive Core

📦 Instalación

Requisitos: Node.js ≥ 20 · npm ≥ 9 · Claude Code o Codex CLI instalados y autenticados (los agentes se ejecutan a través de estos harnesses — AgentForge coordina)

# Run directly (no install)
npx ruflo --version

# Or install globally
npm install -g ruflo

Nota: el nombre del paquete en tiempo de ejecución se hereda del upstream (ruflo en npm). La identidad del proyecto, la marca y el mantenimiento son de AgentForge.

🚀 Inicio Rápido

1️⃣ Inicializa en tu proyecto

cd my-project
npx ruflo init

Esto crea:

my-project/
├── .claude/            # Claude Code settings + hook configs
├── .agentforge/        # memory DB, session state
├── .agents/skills/     # cross-agent skill registry
└── CLAUDE.md           # project rules wired for orchestration

2️⃣ Comprobación de salud

npx ruflo doctor --fix      # verifies Node, MCP servers, memory DB, API keys

3️⃣ Lanza Claude Code y simplemente… habla

Después de init, abre Claude Code normalmente — los ganchos enrutan automáticamente las tareas a los enjambres, aprenden de patrones exitosos y coordinan agentes en segundo plano:

you: "Build a REST API with auth, tests, and docs"
     → planner agent breaks it down
     → coder agents build in parallel
     → reviewer agent checks output
     → memory stores what worked

🔗 Integración con Claude Code

Automática (recomendada)

npx ruflo init conecta todo: registro MCP, ganchos en .claude/settings.json, habilidades y CLAUDE.md.

Registro manual de MCP

Añade a tu configuración MCP de Claude Code (~/.claude.json o .mcp.json del proyecto):

{
  "mcpServers": {
    "agentforge": {
      "command": "npx",
      "args": ["ruflo", "mcp", "start"]
    }
  }
}

Luego, dentro de Claude Code puedes llamar a más de 300 herramientas directamente: memory_search, swarm_init, agent_spawn, task_orchestrate, neural_train y más.

Instalar como plugin de Claude Code

# From the Claude Code prompt:
/plugin marketplace add Soulcynics404/AgentForge
/plugin install agentforge@AgentForge

El plugin incluye comandos de barra (/forge-init, /forge-swarm, /forge-status) además del conjunto de habilidades principal de plugin/skills/.

Integración con otros agentes

🐝 Coordinación de enjambres

# Initialize a swarm with a topology
npx ruflo swarm init --topology hierarchical --max-agents 8

# Spawn specialist agents
npx ruflo agent spawn --type coder    --name backend-dev
npx ruflo agent spawn --type reviewer --name qa-bot
npx ruflo agent spawn --type architect --name system-design

# Orchestrate a task across them
npx ruflo task create --description "Build auth module with tests"
npx ruflo swarm start

# Watch progress
npx ruflo swarm status

Topologías: hierarchical (liderado por reina) · mesh (peer-to-peer) · adaptive (autoorganizado) · ring · star

Los comandos de AgentForge crean registros de coordinación — la construcción real la hacen tus agentes de Claude Code / Codex. El modelo mental correcto:

1. swarm init → configura el estado de coordinación

2. Tu sesión de Claude Code hace el trabajo (escribe código, ejecuta pruebas)

3. memory store → guarda lo que funcionó para la próxima vez

No te detengas después de llamar a un comando de enjambre — sigue trabajando; el harness coordina mientras construyes.

🧠 Sistema de memoria

# Store a pattern that worked
npx ruflo memory store --key "auth-pattern" --value "JWT+refresh rotation" --namespace patterns

# Search past learnings before starting new work
npx ruflo memory query "authentication best approach"

# Session persistence
npx ruflo session save && npx ruflo session resume --latest

La memoria usa búsqueda vectorial HNSW sobre un almacén SQLite/RVF — los patrones semánticamente similares aparecen incluso cuando las palabras clave difieren.

🖥️ Servidor MCP

Ejecuta AgentForge como un servidor MCP independiente que cualquier cliente MCP puede consumir:

npx ruflo mcp start              # stdio mode (default)
npx ruflo mcp start --port 3000  # HTTP/SSE mode
npx ruflo mcp tools              # list all exposed tools

Familias de herramientas: memory_*, swarm_*, agent_*, task_*, neural_*, hooks_*, policy_*, performance_* — catálogo completo.

📚 Documentación

🤝 Contribuciones

¡Issues y PRs bienvenidos! Para cambios significativos, abre un issue primero. Las contribuciones upstream deben ir a ruvnet/ruflo; este fork sigue al upstream y se centra en la marca, el empaquetado y el mantenimiento de la comunidad.

📄 Licencia

MIT — código original © 2024–2026 ruvnet. Mantenimiento y renombrado del fork © 2026 Harsshh (Soulcynics404).

⚒️ Forja más inteligente. Entrega en equipo.