🔧 Stigmergy CLI - Multi-Agents跨AI CLI工具协作系统

⚠️ 重要澄清：这不是一个独立的CLI工具，而是一个增强系统！

Stigmergy CLI 通过插件系统让现有的AI CLI工具能够相互协作，而不是替代它们。

🚀 快速开始

一键部署（推荐）

# 一键部署完整协作系统（检测+安装+配置）
npx -y git+https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git#main quick-deploy

或者，如果您已全局安装了stigmergy-cli：

# 通过已安装的CLI运行
npx stigmergy-cli quick-deploy

手动安装

# 通过NPM全局安装
npm install -g stigmergy-cli

# 初始化项目
stigmergy-cli init

# 智能部署（扫描环境+询问+自动安装）
stigmergy-cli deploy

# 或者使用npx（无需安装）
npx stigmergy-cli init
npx stigmergy-cli deploy

✨ 核心特性

🎯 跨CLI直接协作

• 自然语言调用: 在任何支持的CLI中直接调用其他AI工具
• 无缝集成: 不改变现有CLI工具的使用方式
• 智能路由: 自动识别协作意图并委派到合适的工具

📋 支持的CLI工具

核心工具（必需）

• Claude CLI - Anthropic Claude CLI工具
• Gemini CLI - Google Gemini CLI工具

扩展工具（可选）

• QwenCode CLI - 阿里云QwenCode CLI工具
• iFlow CLI - iFlow工作流CLI工具
• Qoder CLI - Qoder代码生成CLI工具
• CodeBuddy CLI - CodeBuddy编程助手CLI工具
• GitHub Copilot CLI - GitHub Copilot CLI工具
• Codex CLI - OpenAI Codex代码分析CLI工具

🧩 智能部署系统

# 智能部署（推荐）
stigmergy-cli deploy

# 输出示例：
🔍 扫描系统CLI工具状态...

  🔴 ❌ Claude CLI           | CLI: 未安装 | 集成: 未安装
  🟢 ✅ Gemini CLI          | CLI: 可用 | 集成: 已安装
  🔴 ❌ QwenCode CLI       | CLI: 未安装 | 集成: 未安装

📋 检测到以下未安装的工具:

🔴 未安装的CLI工具:
  - Claude CLI (必需) - Anthropic Claude CLI工具
  - QwenCode CLI (可选) - 阿里云QwenCode CLI工具

是否要尝试自动安装 2 个CLI工具？ (Y/n): Y

🎯 跨CLI协作示例

安装完成后，在任何支持的CLI中都可以直接调用其他工具：

在Claude CLI中

# 调用其他AI工具
请用gemini帮我翻译这段代码
调用qwen分析这个需求
用iflow创建工作流
让qoder生成Python代码
启动codebuddy助手

在Gemini CLI中

# 跨工具协作
用claude检查代码质量
让qwen帮我写文档
使用copilot生成代码片段

🛠️ 完整命令列表

# 基本命令
stigmergy-cli init          # 初始化项目
stigmergy-cli status        # 查看状态
stigmergy-cli scan          # 扫描环境

# 部署命令
stigmergy-cli deploy        # 智能部署（默认）
stigmergy-cli deploy-all    # 全量部署

# 项目管理
stigmergy-cli check-project # 检查项目
stigmergy-cli validate      # 验证配置
stigmergy-cli clean         # 清理环境

# 开发命令
npm run build              # 构建项目
npm run publish-to-npm     # 发布到NPM
npm run test               # 运行测试

📁 项目结构

stigmergy-CLI-Multi-Agents/
├── package.json          # NPM包配置
├── src/
│   ├── main.js          # 主入口文件
│   ├── deploy.js        # 智能部署脚本
│   ├── adapters/        # CLI适配器
│   │   ├── claude/
│   │   ├── gemini/
│   │   ├── qwencode/
│   │   └── ...
│   └── core/            # 核心模块
├── adapters/            # CLI安装脚本
│   ├── claude/install_claude_integration.py
│   ├── gemini/install_gemini_integration.py
│   └── ...
└── templates/           # 配置模板

🔧 自动安装CLI工具

智能部署脚本支持自动安装所有CLI工具：

核心工具

npm install -g @anthropic-ai/claude-code
npm install -g @google/gemini-cli

扩展工具

npm install -g @qwen-code/qwen-code@latest
npm install -g @iflow-ai/iflow-cli@latest
npm install -g @qoder-ai/qodercli
npm install -g @tencent-ai/codebuddy-code
npm install -g @github/copilot
npm i -g @openai/codex --registry=https://registry.npmmirror.com

🎯 使用场景

场景1：个人开发者环境

# 新开发环境快速配置
git clone my-project
cd my-project
stigmergy-cli deploy

# 现在可以在任何CLI中跨工具协作
claude-cli "请用gemini帮我优化这段代码的性能"

场景2：团队协作

# 团队共享项目配置
git clone team-project
cd team-project
stigmergy-cli init

# 所有团队成员使用相同的协作背景
gemini-cli "用claude检查这个模块的设计模式"

场景3：多语言开发

# 不同AI工具专长互补
qwen-cli "用copilot生成前端组件"
iflow-cli "让gemini创建API文档"

🔧 开发环境设置

# 克隆项目
git clone https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git
cd stigmergy-CLI-Multi-Agents

# 安装依赖
npm install

# 开发模式运行
npm run start
npm run status
npm run scan

# 构建和发布
npm run build
npm run publish-to-npm

🚀 发布新版本

# 更新版本号
npm version patch    # 补丁版本
npm version minor    # 次版本
npm version major    # 主版本

# 发布到NPM
npm run publish-to-npm

# 验证发布
npx stigmergy-cli --version

🛠️ 故障排除

常见问题

1. Node.js版本不兼容

   # 确保使用Node.js 16+
   node --version

2. 权限错误

   # 使用管理员权限
   sudo npm install -g stigmergy-cli

3. 网络连接问题

   # 设置NPM镜像
   npm config set registry https://registry.npmmirror.com

4. CLI工具安装失败

   # 手动安装特定工具
   npm install -g @anthropic-ai/claude-code

调试模式

# 详细调试输出
DEBUG=stigmergy:* stigmergy-cli deploy

# 仅扫描状态
stigmergy-cli scan

📚 更多信息

• GitHub: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents
• NPM: https://www.npmjs.com/package/stigmergy-cli
• 文档: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents#readme
• 问题反馈: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents/issues

🤝 贡献

欢迎提交 Pull Request 和 Issue！

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🎯 Stigmergy CLI - 真正的跨CLI协作，让每个AI工具都能发挥最大价值！