Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Checkpoint: File edits

rUvfda7948d0eef
diff --git a/package-lock.json b/package-lock.json
index 6f9d890fef..c2cdd7f516 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow",
- "version": "3.1.0-alpha.8",
+ "version": "3.1.0-alpha.9",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow",
- "version": "3.1.0-alpha.8",
+ "version": "3.1.0-alpha.9",
"license": "MIT",
"dependencies": {
"semver": "^7.6.0",
diff --git a/package.json b/package.json
index 3bcd4a1407..06a1aab070 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.1.0-alpha.8",
+ "version": "3.1.0-alpha.9",
"description": "Enterprise AI agent orchestration for Claude Code - Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
"main": "dist/index.js",
"type": "module",
diff --git a/v3/@claude-flow/cli/README.md b/v3/@claude-flow/cli/README.md
index 791381ac3d..3f9a8755cd 100644
--- a/v3/@claude-flow/cli/README.md
+++ b/v3/@claude-flow/cli/README.md
@@ -500,7 +500,7 @@ npm install -g claude-flow@alpha --omit=optional
<details>
<summary>πŸ€– <strong>OpenAI Codex CLI Support</strong> β€” Full Codex integration with self-learning</summary>
-Claude-Flow supports both **Claude Code** and **OpenAI Codex CLI** via the [@claude-flow/codex](https://www.npmjs.com/package/@claude-flow/codex) package.
+Claude-Flow supports both **Claude Code** and **OpenAI Codex CLI** via the [@claude-flow/codex](https://www.npmjs.com/package/@claude-flow/codex) package, following the [Agentics Foundation](https://agentics.org) standard.
### Quick Start for Codex
@@ -524,6 +524,7 @@ npx claude-flow@alpha init --dual
| Skill Syntax | `/skill-name` | `$skill-name` |
| Settings | `settings.json` | `config.toml` |
| MCP | Native | Via `codex mcp add` |
+| Default Model | claude-sonnet | gpt-5.3 |
### Key Concept: Execution Model
@@ -536,6 +537,35 @@ npx claude-flow@alpha init --dual
**Codex does the work. Claude-flow coordinates and learns.**
+### Dual-Mode Integration (Claude Code + Codex)
+
+Run Claude Code for interactive development and spawn headless Codex workers for parallel background tasks:
+
+```
+β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
+β”‚ CLAUDE CODE (interactive) ←→ CODEX WORKERS (headless) β”‚
+β”‚ - Main conversation - Parallel background execution β”‚
+β”‚ - Complex reasoning - Bulk code generation β”‚
+β”‚ - Architecture decisions - Test execution β”‚
+β”‚ - Final integration - File processing β”‚
+β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
+```
+
+```bash
+# Spawn parallel Codex workers from Claude Code
+claude -p "Analyze src/auth/ for security issues" --session-id "task-1" &
+claude -p "Write unit tests for src/api/" --session-id "task-2" &
+claude -p "Optimize database queries in src/db/" --session-id "task-3" &
+wait # Wait for all to complete
+```
+
+| Dual-Mode Feature | Benefit |
+|-------------------|---------|
+| Parallel Execution | 4-8x faster for bulk tasks |
+| Cost Optimization | Route simple tasks to cheaper workers |
+| Context Preservation | Shared memory across platforms |
+| Best of Both | Interactive + batch processing |
+
### MCP Integration for Codex
When you run `init --codex`, the MCP server is automatically registered:
@@ -567,34 +597,17 @@ codex mcp add claude-flow -- npx claude-flow mcp start
| `agent_spawn` | Register agent roles | Multi-agent workflows |
| `neural_train` | Train on patterns | Periodic improvement |
-### Example Prompt for Codex
-
-```
-Build an email validator using a learning-enabled swarm.
-
-STEP 1 - LEARN (use MCP tool):
-Use tool: memory_search
- query: "validation utility function patterns"
- namespace: "patterns"
-If score > 0.7, use that pattern as reference.
-
-STEP 2 - COORDINATE (use MCP tools):
-Use tool: swarm_init with topology="hierarchical", maxAgents=3
-Use tool: agent_spawn with type="coder", name="validator"
-
-STEP 3 - EXECUTE (YOU do this):
-Create /tmp/validator/email.js with validateEmail() function
-Create /tmp/validator/test.js with test cases
-Run the tests
-
-STEP 4 - REMEMBER (use MCP tool):
-Use tool: memory_store
- key: "pattern-email-validator"
- value: "Email validation: regex, returns boolean, test cases"
- namespace: "patterns"
-
-YOU execute all code. Use MCP tools for learning.
-```
+### 137+ Skills Available
+
+| Category | Examples |
+|----------|----------|
+| **V3 Core** | `$v3-security-overhaul`, `$v3-memory-unification`, `$v3-performance-optimization` |
+| **AgentDB** | `$agentdb-vector-search`, `$agentdb-optimization`, `$agentdb-learning` |
+| **Swarm** | `$swarm-orchestration`, `$swarm-advanced`, `$hive-mind-advanced` |
+| **GitHub** | `$github-code-review`, `$github-workflow-automation`, `$github-multi-repo` |
+| **SPARC** | `$sparc-methodology`, `$sparc:architect`, `$sparc:coder`, `$sparc:tester` |
+| **Flow Nexus** | `$flow-nexus-neural`, `$flow-nexus-swarm`, `$flow-nexus:workflow` |
+| **Dual-Mode** | `$dual-spawn`, `$dual-coordinate`, `$dual-collect` |
### Vector Search Details
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index d806aebb9b..e2f9c8f7db 100644
--- a/v3/@claude-flow/cli/package.json
+++ b/v3/@claude-flow/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@claude-flow/cli",
- "version": "3.1.0-alpha.8",
+ "version": "3.1.0-alpha.9",
"type": "module",
"description": "Claude Flow CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
"main": "dist/src/index.js",
diff --git a/v3/package-lock.json b/v3/package-lock.json
index c0ef50ecc2..0bf7e233a8 100644
--- a/v3/package-lock.json
+++ b/v3/package-lock.json
@@ -1789,7 +1789,7 @@
}
},
"@claude-flow/cli": {
- "version": "3.1.0-alpha.8",
+ "version": "3.1.0-alpha.9",
"license": "MIT",
"dependencies": {
"@claude-flow/aidefence": "^3.0.2",