⚒️ AgentForge

Здесь куются AI-агенты — оркестрация для Claude Code и Codex

Поддерживается Soulcynics404 · Harsshh

Быстрый старт · Установка · Интеграция с Claude Code · Команды роя · MCP-сервер · Документация

Агент = Модель + Обвязка (Harness). Модель пишет код; обвязка даёт ей инструменты, память, циклы, песочницы и средства контроля, чтобы она могла реально работать. AgentForge — это и есть такая обвязка — исполнительный слой вокруг Claude Code и Codex, добавляющий 100+ специализированных агентов, скоординированные рои, самообучающуюся память и корпоративные защитные механизмы. Агенты не просто запускаются — они сотрудничают.

AgentForge — активно поддерживаемый форк Ruflo (ранее claude-flow) от rUv, переименованный и поддерживаемый независимо под лицензией MIT. Вся заслуга за оригинальную архитектуру принадлежит вышестоящему проекту и его контрибьюторам.

✨ Что вы получаете

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

Related MCP server: Cognitive Core

📦 Установка

Требования: Node.js ≥ 20 · npm ≥ 9 · Claude Code или Codex CLI установлены и аутентифицированы (агенты выполняются через эти обвязки — AgentForge координирует)

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

# Or install globally
npm install -g ruflo

Примечание: имя пакета в рантайме унаследовано от вышестоящего проекта (ruflo на npm). Идентичность проекта, брендинг и сопровождение принадлежат AgentForge.

🚀 Быстрый старт

1️⃣ Инициализация в вашем проекте

cd my-project
npx ruflo init

Это создаёт:

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️⃣ Проверка работоспособности

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

3️⃣ Запустите Claude Code и просто… общайтесь

После init откройте Claude Code обычным образом — хуки автоматически маршрутизируют задачи в рои, учатся на успешных паттернах и координируют агентов в фоне:

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

🔗 Интеграция с Claude Code

Автоматически (рекомендуется)

npx ruflo init настраивает всё: регистрацию MCP, хуки в .claude/settings.json, навыки и CLAUDE.md.

Ручная регистрация MCP

Добавьте в конфиг MCP вашего Claude Code (~/.claude.json или проектный .mcp.json):

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

Затем внутри Claude Code вы можете напрямую вызывать 300+ инструментов: memory_search, swarm_init, agent_spawn, task_orchestrate, neural_train и другие.

Установка как плагин Claude Code

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

Плагин включает слэш-команды (/forge-init, /forge-swarm, /forge-status) плюс базовый набор навыков из plugin/skills/.

Интеграция с другими агентами

🐝 Координация роя

# 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

Топологии: hierarchical (под управлением королевы) · mesh (одноранговая) · adaptive (самоорганизующаяся) · ring · star

Команды AgentForge создают записи координации — фактическую работу выполняют ваши агенты Claude Code / Codex. Правильная ментальная модель:

1. swarm init → настраивает состояние координации

2. Ваша сессия Claude Code выполняет работу (пишет код, запускает тесты)

3. memory store → сохраняет, что сработало, для следующего раза

Не останавливайтесь после вызова команды роя — продолжайте работать; обвязка координирует пока вы строите.

🧠 Система памяти

# 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

Память использует векторный поиск HNSW по хранилищу SQLite/RVF — семантически похожие паттерны всплывают, даже если ключевые слова различаются.

🖥️ MCP-сервер

Запустите AgentForge как автономный MCP-сервер, который может использовать любой MCP-клиент:

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

Семейства инструментов: memory_*, swarm_*, agent_*, task_*, neural_*, hooks_*, policy_*, performance_* — полный каталог.

📚 Документация

🤝 Участие в разработке

Приветствуются issues и PR! Для значительных изменений сначала откройте issue. Вклад в вышестоящий проект следует направлять в ruvnet/ruflo; этот форк отслеживает вышестоящий проект и сосредоточен на брендинге, упаковке и поддержке сообщества.

📄 Лицензия

MIT — оригинальный код © 2024–2026 ruvnet. Сопровождение форка и ребрендинг © 2026 Harsshh (Soulcynics404).

⚒️ Куйте умнее. Создавайте вместе.