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

feat(init): Add --settings flag to upgrade command for Agent Teams

rUv602dc95e68b8
diff --git a/package-lock.json b/package-lock.json
index 17b2a4bbaa..411bc23696 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow",
- "version": "3.1.0-alpha.10",
+ "version": "3.1.0-alpha.14",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow",
- "version": "3.1.0-alpha.10",
+ "version": "3.1.0-alpha.14",
"license": "MIT",
"dependencies": {
"semver": "^7.6.0",
diff --git a/package.json b/package.json
index c9cc837e3f..ddf4503183 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.1.0-alpha.13",
+ "version": "3.1.0-alpha.14",
"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 e686b34d91..38d7016ecc 100644
--- a/v3/@claude-flow/cli/README.md
+++ b/v3/@claude-flow/cli/README.md
@@ -489,8 +489,8 @@ bunx claude-flow@alpha init
| Profile | Size | Use Case |
|---------|------|----------|
-| `--omit=optional` | ~340MB | Core features only |
-| Default | ~340MB | Standard install |
+| `--omit=optional` | ~45MB | Core CLI only (fastest) |
+| Default | ~340MB | Full install with ML/embeddings |
```bash
# Minimal install (skip ML/embeddings)
@@ -1515,6 +1515,76 @@ npx claude-flow hive-mind sessions # List active sessions
</details>
+<details>
+<summary>👥 <strong>Agent Teams</strong> — Claude Code multi-instance coordination</summary>
+
+Native integration with Claude Code's experimental Agent Teams feature for spawning and coordinating multiple Claude instances.
+
+**Enable Agent Teams:**
+```bash
+# Automatically enabled with claude-flow init
+npx claude-flow@latest init
+
+# Or manually add to .claude/settings.json
+{
+ "env": {
+ "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+ }
+}
+```
+
+**Agent Teams Components:**
+
+| Component | Tool | Purpose |
+|-----------|------|---------|
+| **Team Lead** | Main Claude | Coordinates teammates, assigns tasks, reviews results |
+| **Teammates** | `Task` tool | Sub-agents spawned to work on specific tasks |
+| **Task List** | `TaskCreate/TaskList/TaskUpdate` | Shared todos visible to all team members |
+| **Mailbox** | `SendMessage` | Inter-agent messaging for coordination |
+
+**Quick Start:**
+```javascript
+// Create a team
+TeamCreate({ team_name: "feature-dev", description: "Building feature" })
+
+// Create shared tasks
+TaskCreate({ subject: "Design API", description: "..." })
+TaskCreate({ subject: "Implement endpoints", description: "..." })
+
+// Spawn teammates (parallel background work)
+Task({ prompt: "Work on task #1...", subagent_type: "architect",
+ team_name: "feature-dev", name: "architect", run_in_background: true })
+Task({ prompt: "Work on task #2...", subagent_type: "coder",
+ team_name: "feature-dev", name: "developer", run_in_background: true })
+
+// Message teammates
+SendMessage({ type: "message", recipient: "developer",
+ content: "Prioritize auth", summary: "Priority update" })
+
+// Cleanup when done
+SendMessage({ type: "shutdown_request", recipient: "developer" })
+TeamDelete()
+```
+
+**Agent Teams Hooks:**
+
+| Hook | Trigger | Purpose |
+|------|---------|---------|
+| `teammate-idle` | Teammate finishes turn | Auto-assign pending tasks |
+| `task-completed` | Task marked complete | Train patterns, notify lead |
+
+```bash
+# Handle idle teammate
+npx claude-flow@latest hooks teammate-idle --auto-assign true
+
+# Handle task completion
+npx claude-flow@latest hooks task-completed --task-id <id> --train-patterns
+```
+
+**Display Modes:** `auto` (default), `in-process`, `tmux` (split-pane)
+
+</details>
+
<details>
<summary>🔧 <strong>MCP Tools & Integration</strong> — 31+ tools across 7 categories</summary>
@@ -1527,7 +1597,7 @@ Full MCP server with tools for coordination, monitoring, memory, and GitHub inte
| **Memory & Neural** | `memory_usage`, `neural_status`, `neural_train`, `neural_patterns` | Memory operations and learning |
| **GitHub** | `github_swarm`, `repo_analyze`, `pr_enhance`, `issue_triage`, `code_review` | Repository integration |
| **Workers** | `worker/run`, `worker/status`, `worker/alerts`, `worker/history` | Background task management |
-| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/intelligence/*` | 31 lifecycle hooks |
+| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/teammate-*`, `hooks/task-*` | 33 lifecycle hooks |
| **Progress** | `progress/check`, `progress/sync`, `progress/summary`, `progress/watch` | V3 implementation tracking |
</details>
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index 0fee0504f6..b91f2418c6 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.13",
+ "version": "3.1.0-alpha.14",
"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",