π 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
rUvda2e24179d6c
diff --git a/.claude/agents/dual-mode/README.md b/.claude/agents/dual-mode/README.mdindex 9746c5b954..46dd0b133c 100644--- a/.claude/agents/dual-mode/README.md+++ b/.claude/agents/dual-mode/README.md@@ -1,62 +1,94 @@# Dual-Mode Agents (Claude Code + Codex)-Optional agent configurations for running Claude Code interactively alongside headless Codex workers.+Optional agents for orchestrating hybrid workflows combining Claude Code (interactive) and Codex (headless) execution.++## Available Agents++| Agent | File | Platform | Purpose |+|-------|------|----------|---------|+| `dual-orchestrator` | dual-orchestrator.md | dual | Orchestrate hybrid Claude+Codex workflows |+| `codex-coordinator` | codex-coordinator.md | dual | Coordinate multiple headless Codex workers |+| `codex-worker` | codex-worker.md | codex | Headless background worker with self-learning |## Architecture```-βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ-β CLAUDE CODE (Interactive) CODEX (Headless Background) β-β ββββββββββββββββββββββββ ββββββββββββββββββββββββββββ β-β Direct conversation claude -p "task" & β-β Real-time feedback Parallel execution β-β Complex reasoning Batch processing β-β β-β CLAUDE-FLOW (Shared Orchestrator) β-β β’ MCP tools shared by both β-β β’ Vector memory persists across sessions β-β β’ Patterns learned and reused β-βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+βββββββββββββββββββββββββββββββββββββββββββββββββββ+β CLAUDE CODE (Interactive) β+β ββ Complex reasoning β+β ββ Architecture decisions β+β ββ Real-time review β+βββββββββββββββββββββββββββββββββββββββββββββββββββ€+β dual-orchestrator β+β ββ Routes tasks to appropriate platform β+β ββ Coordinates hybrid workflows β+βββββββββββββββββββββββββββββββββββββββββββββββββββ€+β codex-coordinator β+β ββ Spawns headless workers β+β ββ Tracks progress via memory β+β ββ Aggregates results β+βββββββββββββββββββββββββββββββββββββββββββββββββββ€+β CODEX (Headless) β+β ββ codex-worker instances β+β ββ Run in parallel via `claude -p` β+β ββ Store results in shared memory β+βββββββββββββββββββββββββββββββββββββββββββββββββββ```-## Available Agents--| Agent | File | Purpose |-|-------|------|---------|-| `codex-worker` | codex-worker.yaml | Headless background worker |-| `codex-coordinator` | codex-coordinator.yaml | Coordinates headless swarm |-| `dual-orchestrator` | dual-orchestrator.yaml | Claude+Codex coordination |--## Usage+## Quick Start-### Spawn Headless Workers from Claude Code+### 1. Hybrid Development Workflow+```bash+# Interactive design β Parallel implementation β Interactive review+# Use dual-orchestrator agent+```+### 2. Spawn Parallel Workers```bash-# Spawn parallel Codex workers-claude -p "Implement feature X" --session-id task-1 &-claude -p "Write tests for X" --session-id task-2 &-claude -p "Document feature X" --session-id task-3 &+# Initialize coordination+npx claude-flow@v3alpha swarm init --topology hierarchical --max-agents 4++# Spawn workers+claude -p "Implement auth service" --session-id auth-1 &+claude -p "Write auth tests" --session-id auth-2 &wait++# Collect results+npx claude-flow@v3alpha memory list --namespace results```-### Coordinate via Shared Memory+## When to Use Each Agent-```bash-# Initialize shared coordination-npx claude-flow swarm init --topology hierarchical+### dual-orchestrator+- Starting a new feature that needs both design and implementation+- Deciding whether a task needs interactive reasoning or can run headlessly+- Coordinating end-to-end hybrid workflows-# Workers store results-npx claude-flow memory store --key "task-1-result" --value "..." --namespace results+### codex-coordinator+- Spawning multiple parallel workers for batch execution+- Managing worker lifecycle and result aggregation+- When the task is already well-defined and can be parallelized-# Interactive Claude Code reads results-npx claude-flow memory list --namespace results-```+### codex-worker+- Individual headless execution units+- Self-learning workers that check memory before/after tasks+- Background implementation tasks-## Installation+## Related Skills-These agents are optional. To use them:+See `.claude/skills/dual-mode/` for skill commands:+- `/dual-spawn` - Spawn headless workers+- `/dual-coordinate` - Full hybrid workflow+- `/dual-collect` - Collect worker results-```bash-# Already included in .claude/agents/dual-mode/-# Reference in your workflows as needed-```+## Platform Routing++| Task Type | Platform | Agent |+|-----------|----------|-------|+| Design/Architecture | Claude Code | dual-orchestrator |+| Debugging | Claude Code | - |+| Implementation | Codex | codex-worker |+| Testing | Codex | codex-worker |+| Documentation | Codex | codex-worker |+| Code Review | Claude Code | - |+| Hybrid Feature | Both | dual-orchestrator |