π 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
rUv29f5a503b08c
diff --git a/README.md b/README.mdindex e8b1f42138..791381ac3d 100644--- a/README.md+++ b/README.md@@ -497,25 +497,115 @@ bunx claude-flow@alpha initnpm install -g claude-flow@alpha --omit=optional```-#### OpenAI Codex CLI Support+<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.+### Quick Start for Codex+```bash# Initialize for Codex CLI (creates AGENTS.md instead of CLAUDE.md)npx claude-flow@alpha init --codex+# Full Codex setup with all 137+ skills+npx claude-flow@alpha init --codex --full+# Initialize for both platforms (dual mode)npx claude-flow@alpha init --dual+```-# Full Codex setup with all 137+ skills-npx claude-flow@alpha init --codex --full+### Platform Comparison++| Feature | Claude Code | OpenAI Codex |+|---------|-------------|--------------|+| Config File | `CLAUDE.md` | `AGENTS.md` |+| Skills Dir | `.claude/skills/` | `.agents/skills/` |+| Skill Syntax | `/skill-name` | `$skill-name` |+| Settings | `settings.json` | `config.toml` |+| MCP | Native | Via `codex mcp add` |++### Key Concept: Execution Model++```+βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+β CLAUDE-FLOW = ORCHESTRATOR (tracks state, stores memory) β+β CODEX = EXECUTOR (writes code, runs commands, implements) β+βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+```++**Codex does the work. Claude-flow coordinates and learns.**++### MCP Integration for Codex++When you run `init --codex`, the MCP server is automatically registered:++```bash+# Verify MCP is registered+codex mcp list++# If not present, add manually:+codex mcp add claude-flow -- npx claude-flow mcp start```-| Platform | Config File | Skills Dir | Skill Syntax |-|----------|-------------|------------|--------------|-| Claude Code | `CLAUDE.md` | `.claude/skills/` | `/skill-name` |-| OpenAI Codex | `AGENTS.md` | `.agents/skills/` | `$skill-name` |+### Self-Learning Workflow++```+1. LEARN: memory_search(query="task keywords") β Find similar patterns+2. COORD: swarm_init(topology="hierarchical") β Set up coordination+3. EXECUTE: YOU write code, run commands β Codex does real work+4. REMEMBER: memory_store(key, value, namespace="patterns") β Save for future+```++### MCP Tools for Learning++| Tool | Purpose | When to Use |+|------|---------|-------------|+| `memory_search` | Semantic vector search | BEFORE starting any task |+| `memory_store` | Save patterns with embeddings | AFTER completing successfully |+| `swarm_init` | Initialize coordination | Start of complex tasks |+| `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.+```++### Vector Search Details++- **Embedding Dimensions**: 384+- **Search Algorithm**: HNSW (150x-12,500x faster)+- **Similarity Scoring**: 0-1 (higher = better)+ - Score > 0.7: Strong match, use pattern+ - Score 0.5-0.7: Partial match, adapt+ - Score < 0.5: Weak match, create new++</details>### Basic Usagediff --git a/package-lock.json b/package-lock.jsonindex 8dec29d855..45e70b8918 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "claude-flow",- "version": "3.1.0-alpha.6",+ "version": "3.1.0-alpha.7","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "claude-flow",- "version": "3.1.0-alpha.6",+ "version": "3.1.0-alpha.7","license": "MIT","dependencies": {"semver": "^7.6.0",diff --git a/package.json b/package.jsonindex d29dcd7e75..65d8b8fcea 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "3.1.0-alpha.6",+ "version": "3.1.0-alpha.7","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/package.json b/v3/@claude-flow/cli/package.jsonindex 2db46bd5e7..b69b641489 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.6",+ "version": "3.1.0-alpha.7","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",