⚒️ AgentForge

Wo KI-Agenten geschmiedet werden — Orchestrierung für Claude Code & Codex

Gepflegt von Soulcynics404 · Harsshh

Quick Start · Installation · Claude-Code-Integration · Swarm-Befehle · MCP-Server · Dokumentation

Agent = Modell + Harness. Das Modell schreibt; der Harness gibt ihm Werkzeuge, Speicher, Schleifen, Sandboxes und Kontrollen, damit es tatsächlich arbeiten kann. AgentForge ist dieser Harness — die Ausführungsebene um Claude Code und Codex, die 100+ spezialisierte Agenten, koordinierte Swarms, selbstlernenden Speicher und Unternehmens-Schutzmechanismen hinzufügt. Damit Agenten nicht nur laufen, sondern zusammenarbeiten.

AgentForge ist ein aktiv gepflegter Fork von Ruflo (ehemals claude-flow) von rUv, unter der MIT-Lizenz umbenannt und unabhängig gepflegt. Alle Anerkennung für die ursprüngliche Architektur gebührt dem Upstream-Projekt und seinen Mitwirkenden.

✨ Was du bekommst

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

Related MCP server: Cognitive Core

📦 Installation

Voraussetzungen: Node.js ≥ 20 · npm ≥ 9 · Claude Code oder Codex CLI installiert & authentifiziert (Agenten führen über diese Harnesses aus — AgentForge koordiniert)

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

# Or install globally
npm install -g ruflo

Hinweis: Der Paketname zur Laufzeit stammt vom Upstream (ruflo auf npm). Projektidentität, Branding und Pflege liegen bei AgentForge.

🚀 Quick Start

1️⃣ In deinem Projekt initialisieren

cd my-project
npx ruflo init

Das erstellt:

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️⃣ Health-Check

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

3️⃣ Claude Code starten und einfach… reden

Nach init öffnest du Claude Code normal — Hooks leiten Aufgaben automatisch an Swarms weiter, lernen aus erfolgreichen Mustern und koordinieren Agenten im Hintergrund:

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

🔗 Mit Claude Code integrieren

Automatisch (empfohlen)

npx ruflo init verdrahtet alles: MCP-Registrierung, Hooks in .claude/settings.json, Skills und CLAUDE.md.

Manuelle MCP-Registrierung

Füge zu deiner Claude-Code-MCP-Konfiguration (~/.claude.json oder Projekt-.mcp.json) hinzu:

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

Danach kannst du in Claude Code direkt 300+ Werkzeuge aufrufen: memory_search, swarm_init, agent_spawn, task_orchestrate, neural_train und mehr.

Als Claude-Code-Plugin installieren

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

Das Plugin bündelt Slash-Befehle (/forge-init, /forge-swarm, /forge-status) sowie den Kern-Skill-Satz aus plugin/skills/.

Mit anderen Agenten integrieren

🐝 Swarm-Koordination

# 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

Topologien: hierarchical (königinnen-geführt) · mesh (Peer-to-Peer) · adaptive (selbstorganisierend) · ring · star

AgentForge-Befehle erstellen Koordinationsdatensätze — das eigentliche Bauen übernehmen deine Claude-Code-/Codex-Agenten. Das richtige mentale Modell:

1. swarm init → richtet den Koordinationszustand ein

2. Deine Claude-Code-Sitzung erledigt die Arbeit (schreibt Code, führt Tests aus)

3. memory store → speichert, was funktioniert hat, für das nächste Mal

Hör nicht auf, nachdem du einen Swarm-Befehl aufgerufen hast — arbeite weiter; der Harness koordiniert während du baust.

🧠 Speichersystem

# 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

Der Speicher nutzt HNSW-Vektorsuche über einen SQLite/RVF-Speicher — semantisch ähnliche Muster tauchen auch dann auf, wenn die Schlüsselwörter abweichen.

🖥️ MCP-Server

Führe AgentForge als eigenständigen MCP-Server aus, den jeder MCP-Client konsumieren kann:

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

Werkzeugfamilien: memory_*, swarm_*, agent_*, task_*, neural_*, hooks_*, policy_*, performance_* — vollständiger Katalog.

📚 Dokumentation

🤝 Mitwirken

Issues und PRs sind willkommen! Bei größeren Änderungen bitte zuerst ein Issue eröffnen. Upstream-Beiträge sollten an ruvnet/ruflo gehen; dieser Fork verfolgt das Upstream und konzentriert sich auf Branding, Verpackung und Community-Pflege.

📄 Lizenz

MIT — Originalcode © 2024–2026 ruvnet. Fork-Pflege & Rebranding © 2026 Harsshh (Soulcynics404).

⚒️ Schmiede klüger. Liefert gemeinsam.