π 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUv337b24cbb5cc
diff --git a/README.md b/README.mdindex 791381ac3d..3f9a8755cd 100644--- a/README.md+++ b/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 CodexWhen 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 Detailsdiff --git a/v3/@claude-flow/codex/package.json b/v3/@claude-flow/codex/package.jsonindex 58166b478c..76478e23bd 100644--- a/v3/@claude-flow/codex/package.json+++ b/v3/@claude-flow/codex/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/codex",- "version": "3.0.0-alpha.3",+ "version": "3.0.0-alpha.4","description": "Codex CLI integration for Claude Flow - OpenAI Codex platform adapter","type": "module","main": "./dist/index.js",diff --git a/v3/package-lock.json b/v3/package-lock.jsonindex d803aff6b1..c7f7c28058 100644--- a/v3/package-lock.json+++ b/v3/package-lock.json@@ -1789,7 +1789,7 @@}},"@claude-flow/cli": {- "version": "3.1.0-alpha.4",+ "version": "3.1.0-alpha.8","license": "MIT","dependencies": {"@claude-flow/aidefence": "^3.0.2",@@ -1818,7 +1818,7 @@}},"@claude-flow/codex": {- "version": "3.0.0-alpha.1",+ "version": "3.0.0-alpha.4","license": "MIT","dependencies": {"@iarna/toml": "^2.2.5",