Checkpoint: File edits

Automatic checkpoint created by Claude Code
- Branch: main
- Timestamp: 2026-02-07T22:53:47Z
- Changes: 3 file(s)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: ruvnet

README.md

@@ -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>
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.1.0-alpha.12",
+  "version": "3.1.0-alpha.13",
   "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",

v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.1.0-alpha.12",
+  "version": "3.1.0-alpha.13",
   "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",