🌊 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
rUv65e18f70e207
diff --git a/CLAUDE.md b/CLAUDE.mdindex 423c1ac400..06a5c3521d 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -255,6 +255,79 @@ npx claude-flow@v3alpha security scan --depth fullnpx claude-flow@v3alpha performance benchmark --suite all```+## Headless Background Instances (claude -p)++Use `claude -p` (print/pipe mode) to spawn headless Claude instances for parallel background work. These run non-interactively and return results to stdout.++### Basic Usage++```bash+# Single headless task+claude -p "Analyze the authentication module for security issues"++# With model selection+claude -p --model haiku "Format this config file"+claude -p --model opus "Design the database schema for user management"++# With output format+claude -p --output-format json "List all TODO comments in src/"+claude -p --output-format stream-json "Refactor the error handling in api.ts"++# With budget limits+claude -p --max-budget-usd 0.50 "Run comprehensive security audit"++# With specific tools allowed+claude -p --allowedTools "Read,Grep,Glob" "Find all files that import the auth module"++# Skip permissions (sandboxed environments only)+claude -p --dangerously-skip-permissions "Fix all lint errors in src/"+```++### Parallel Background Execution++```bash+# Spawn multiple headless instances in parallel+claude -p "Analyze src/auth/ for vulnerabilities" &+claude -p "Write tests for src/api/endpoints.ts" &+claude -p "Review src/models/ for performance issues" &+wait # Wait for all to complete++# With results captured+SECURITY=$(claude -p "Security audit of auth module" &)+TESTS=$(claude -p "Generate test coverage report" &)+PERF=$(claude -p "Profile memory usage in workers" &)+wait+echo "$SECURITY" "$TESTS" "$PERF"+```++### Session Continuation++```bash+# Start a task, resume later+claude -p --session-id "abc-123" "Start analyzing the codebase"+claude -p --resume "abc-123" "Continue with the test files"++# Fork a session for parallel exploration+claude -p --resume "abc-123" --fork-session "Try approach A: event sourcing"+claude -p --resume "abc-123" --fork-session "Try approach B: CQRS pattern"+```++### Key Flags++| Flag | Purpose |+|------|---------|+| `-p, --print` | Non-interactive mode, print and exit |+| `--model <model>` | Select model (haiku, sonnet, opus) |+| `--output-format <fmt>` | Output: text, json, stream-json |+| `--max-budget-usd <amt>` | Spending cap per invocation |+| `--allowedTools <tools>` | Restrict available tools |+| `--append-system-prompt` | Add custom instructions |+| `--resume <id>` | Continue a previous session |+| `--fork-session` | Branch from resumed session |+| `--fallback-model <model>` | Auto-fallback if primary overloaded |+| `--permission-mode <mode>` | acceptEdits, bypassPermissions, plan, etc. |+| `--mcp-config <json>` | Load MCP servers from JSON |+## Available Agents (60+ Types)### Core Developmentdiff --git a/agents/architect.yaml b/agents/architect.yamlindex 4b7bf4af0a..14005dfa90 100644--- a/agents/architect.yaml+++ b/agents/architect.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- context-caching- memory-persistence-createdAt: "2026-02-02T04:24:59.852Z"+createdAt: "2026-02-02T04:35:20.324Z"diff --git a/agents/coder.yaml b/agents/coder.yamlindex 9039a0f96c..bf7072e128 100644--- a/agents/coder.yaml+++ b/agents/coder.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- flash-attention- token-reduction-createdAt: "2026-02-02T04:24:59.851Z"+createdAt: "2026-02-02T04:35:20.324Z"diff --git a/agents/reviewer.yaml b/agents/reviewer.yamlindex 9f9d89e1aa..6aca6a0f40 100644--- a/agents/reviewer.yaml+++ b/agents/reviewer.yaml@@ -7,4 +7,4 @@ capabilities:- best-practicesoptimizations:- incremental-analysis-createdAt: "2026-02-02T04:24:59.852Z"+createdAt: "2026-02-02T04:35:20.324Z"diff --git a/agents/security-architect.yaml b/agents/security-architect.yamlindex 4aed6963ac..65e98059c6 100644--- a/agents/security-architect.yaml+++ b/agents/security-architect.yaml@@ -7,4 +7,4 @@ capabilities:- security-reviewoptimizations:- pattern-matching-createdAt: "2026-02-02T04:24:59.852Z"+createdAt: "2026-02-02T04:35:20.324Z"diff --git a/agents/tester.yaml b/agents/tester.yamlindex 73679983a0..779fe0cb02 100644--- a/agents/tester.yaml+++ b/agents/tester.yaml@@ -7,4 +7,4 @@ capabilities:- coverageoptimizations:- parallel-execution-createdAt: "2026-02-02T04:24:59.852Z"+createdAt: "2026-02-02T04:35:20.324Z"