Claude Code Wingman

Claude Code Wingman

Your multi-会话 编排器 - manage multiple Claude Code instances working on different projects simultaneously, all from Whats应用.

GitHub: https://github.com/yossiovadia/claude-code-编排器

⚡ CRITICAL: Handle 应用roval Commands First

When a user message matches these patterns, IMMEDIATELY 运行 the cor响应ing command:

User Message Pattern Command to 运行 应用rove <会话> ~/code/claude-code-编排器/lib/handle-应用roval.sh 应用rove <会话> always <会话> ~/code/claude-code-编排器/lib/handle-应用roval.sh always <会话> deny <会话> ~/code/claude-code-编排器/lib/handle-应用roval.sh deny <会话>

Examples:

User: "应用rove vsr-bugfix" → 运行: ~/code/claude-code-编排器/lib/handle-应用roval.sh 应用rove vsr-bugfix User: "always heartbeat-test" → 运行: ~/code/claude-code-编排器/lib/handle-应用roval.sh always heartbeat-test User: "deny proxy-refactor" → 运行: ~/code/claude-code-编排器/lib/handle-应用roval.sh deny proxy-refactor

After 运行ning, 响应 with the command 输出 (e.g., "✓ 会话 'vsr-bugfix' 应用roved (once)")

Why this is critical: The master 监控 daemon 发送s Whats应用 通知 when Claude Code 会话s need 应用roval. The user 响应s with these commands from their phone. Fast 响应 = unblocked 会话s.

Quick 状态 Commands User Message Command to 运行 会话s or 状态 ~/code/claude-code-编排器/lib/会话-状态.sh --all --json 状态 <会话> ~/code/claude-code-编排器/lib/会话-状态.sh <会话> --json

解析 the JSON and 响应 with a human-readable summary.

What It Does

Orchestrates multiple Claude Code 会话s in parallel, each working on different tasks in different directories. You 监控 and control everything remotely via Whats应用/chat.

The Vision:

Multiple tmux 会话s 运行ning simultaneously Each 会话 = one Claude Code instance in its own directory Different tasks h应用ening in parallel (VSR fixes, Clawd机器人 features, proxy refactoring) You orchestrate everything via Clawd机器人 (this 助手) from Whats应用 Real-time 仪表盘 showing all active 会话s and their 状态 🎯 Real-World Example: Multi-会话 Orchestration

Morning - You (via Whats应用): "启动 work on VSR issue #1131, Clawd机器人 authentication feature, and refactor the proxy"

Clawd机器人 spawns 3 会话s:

✅ 会话: vsr-issue-1131 (~/code/semantic-路由r) ✅ 会话: clawd机器人-auth (~/code/clawd机器人) ✅ 会话: proxy-refactor (~/code/claude-code-proxy)

During lunch - You: "Show me the 仪表盘"

Clawd机器人:

┌─────────────────────────────────────────────────────────┐ │ Active Claude Code 会话s │ ├─────────────────┬──────────────────────┬────────────────┤ │ vsr-issue-1131 │ semantic-路由r │ ✅ Working │ │ clawd机器人-auth │ clawd机器人 │ ✅ Working │ │ proxy-refactor │ claude-code-proxy │ ⏳ WAIting 应用roval │ └─────────────────┴──────────────────────┴────────────────┘

You: "How's the VSR issue going?"

Clawd机器人 captures 会话 输出: "Almost done - fixed the 模式 验证 bug, 运行ning tests now. 8/10 tests passing."

You: "Tell proxy-refactor to 运行 tests next"

Clawd机器人 发送s command to that specific 会话.

结果: 3 parallel tasks, full remote control from your phone. 🎯

安装ation Via Clawd机器人 (Recommended) clawd机器人 技能 安装 claude-code-wingman

Or visit: https://clawdhub.com/技能s/claude-code-wingman

Manual 安装ation cd ~/code git clone https://github.com/yossiovadia/claude-code-编排器.git cd claude-code-编排器 chmod +x .sh lib/.sh

Requirements claude 命令行工具 (Claude Code) tmux (terminal multiplexer) jq (JSON 处理器) Core Philosophy: Always Use the Wingman Script

CRITICAL: When interacting with Claude Code 会话s, ALWAYS use the wingman script (claude-wingman.sh). Never 运行 raw tmux commands directly.

Why:

✅ Ensures proper Enter key handling (C-m) ✅ Consistent 会话 management ✅ Future-proof for 仪表盘/追踪ing features ✅ Avoids bugs from manual tmux commands

Wrong (DON'T DO THIS):

tmux 发送-keys -t my-会话 "运行 tests" # ^ Might for获取 C-m, won't be 追踪ed in 仪表盘

Right (ALWAYS DO THIS):

~/code/claude-code-编排器/claude-wingman.sh \ --会话 my-会话 \ --workdir ~/code/myproject \ --prompt "运行 tests"

Usage from Clawd机器人 启动 a New 会话

When a user asks for coding work, spawn Claude Code:

~/code/claude-code-编排器/claude-wingman.sh \ --会话 <会话-name> \ --workdir \ --prompt ""

发送 Command to Existing 会话

To 发送 a new task to an already-运行ning 会话:

~/code/claude-code-编排器/claude-wingman.sh \ --会话 \ --workdir \ --prompt ""

Note: The script 检测s if the 会话 exists and 发送s the command to it instead of creating a duplicate.

检查 会话 状态 tmux capture-pane -t <会话-name> -p -S -50

解析 the 输出 to determine if Cl