# 🔧 Stigmergy CLI - Система сотрудничества инструментов ИИ с несколькими агентами

> **⚠️ Важное уточнение: Это не самостоятельный инструмент CLI, а система расширения!**
>
> Stigmergy CLI позволяет существующим инструментам ИИ CLI сотрудничать друг с другом через систему плагинов, а не заменять их.

[![Node.js](https://img.shields.io/badge/node-16+-green.svg)](https://nodejs.org)
[![NPM](https://img.shields.io/badge/npm-stigmergy-cli-blue.svg)](https://www.npmjs.com/package/stigmergy-cli)
[![Лицензия](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Платформа](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()

## 🚀 Быстрый старт

### Развертывание в один клик (Рекомендуется)

```bash
# Развертывание полной системы сотрудничества в один клик (обнаружение + установка + настройка)
npx -y git+https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git#main quick-deploy
```

Или, если вы уже установили stigmergy-cli глобально:

```bash
# Запуск через установленный CLI
npx stigmergy-cli quick-deploy
```

### Ручная установка

```bash
# Глобальная установка через NPM
npm install -g stigmergy-cli

# Инициализация проекта
stigmergy-cli init

# Интеллектуальное развертывание (сканирование среды + запрос + автоматическая установка)
stigmergy-cli deploy

# Или использовать npx (без необходимости установки)
npx stigmergy-cli init
npx stigmergy-cli deploy
```

## ✨ Основные функции

### 🎯 Прямое сотрудничество между CLI
- **Вызов на естественном языке**: Прямой вызов других инструментов ИИ в любом поддерживаемом CLI
- **Бесшовная интеграция**: Не изменяет существующее использование инструментов CLI
- **Интеллектуальная маршрутизация**: Автоматически определяет намерение сотрудничества и делегирует подходящему инструменту

### 📋 Поддерживаемые инструменты CLI

#### Основные инструменты (Обязательные)
- **Claude CLI** - Инструмент CLI Anthropic Claude
- **Gemini CLI** - Инструмент CLI Google Gemini

#### Расширенные инструменты (Опциональные)
- **QwenCode CLI** - Инструмент CLI Alibaba Cloud QwenCode
- **iFlow CLI** - Инструмент CLI рабочих процессов iFlow
- **Qoder CLI** - Инструмент CLI генерации кода Qoder
- **CodeBuddy CLI** - Инструмент CLI программистского помощника CodeBuddy
- **GitHub Copilot CLI** - Инструмент CLI GitHub Copilot
- **Codex CLI** - Инструмент CLI анализа кода OpenAI Codex

### 🧩 Система интеллектуального развертывания

```bash
# Интеллектуальное развертывание (рекомендуется)
stigmergy-cli deploy

# Пример вывода:
🔍 Сканирование состояния инструментов CLI системы...

  🔴 ❌ Claude CLI           | CLI: Не установлен | Интеграция: Не установлена
  🟢 ✅ Gemini CLI          | CLI: Доступен | Интеграция: Установлена
  🔴 ❌ QwenCode CLI       | CLI: Не установлен | Интеграция: Не установлена

📋 Обнаружены следующие неустановленные инструменты:

🔴 Неустановленные инструменты CLI:
  - Claude CLI (обязательный) - Инструмент CLI Anthropic Claude
  - QwenCode CLI (опциональный) - Инструмент CLI Alibaba Cloud QwenCode

Хотите попробовать автоматически установить 2 инструмента CLI? (Y/n): Y
```

## 🎯 Примеры сотрудничества между CLI

После установки вы можете напрямую вызывать другие инструменты в любом поддерживаемом CLI:

### В Claude CLI
```bash
# Вызов других инструментов ИИ
Пожалуйста, используйте gemini, чтобы помочь мне перевести этот код
Вызовите qwen для анализа этого требования
Используйте iflow для создания рабочего процесса
Пусть qoder сгенерирует код Python
Запустите помощник codebuddy
```

### В Gemini CLI
```bash
# Сотрудничество между инструментами
Используйте claude для проверки качества кода
Пусть qwen поможет мне написать документацию
Используйте copilot для генерации фрагментов кода
```

## 🛠️ Полный список команд

```bash
# Базовые команды
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:

### Основные инструменты
```bash
npm install -g @anthropic-ai/claude-code
npm install -g @google/gemini-cli
```

### Расширенные инструменты
```bash
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: Среда индивидуального разработчика
```bash
# Быстрая настройка новой среды разработки
git clone my-project
cd my-project
stigmergy-cli deploy

# Теперь вы можете сотрудничать между инструментами в любом CLI
claude-cli "Пожалуйста, используйте gemini, чтобы помочь мне оптимизировать производительность этого кода"
```

### Сценарий 2: Командное сотрудничество
```bash
# Совместная конфигурация проекта команды
git clone team-project
cd team-project
stigmergy-cli init

# Все члены команды используют один и тот же контекст сотрудничества
gemini-cli "Используйте claude для проверки шаблонов проектирования этого модуля"
```

### Сценарий 3: Многоязычная разработка
```bash
# Дополнение специализаций различных инструментов ИИ
qwen-cli "Используйте copilot для генерации компонентов интерфейса"
iflow-cli "Пусть gemini создаст документацию API"
```

## 🔧 Настройка среды разработки

```bash
# Клонирование проекта
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
```

## 🚀 Публикация новых версий

```bash
# Обновление номера версии
npm version patch    # Патч-версия
npm version minor    # Минорная версия
npm version major    # Мажорная версия

# Публикация в NPM
npm run publish-to-npm

# Проверка публикации
npx stigmergy-cli --version
```

## 🛠️ Устранение неполадок

### Распространенные проблемы

1. **Несовместимая версия Node.js**
   ```bash
   # Убедитесь, что используется Node.js 16+
   node --version
   ```

2. **Ошибки прав доступа**
   ```bash
   # Использование привилегий администратора
   sudo npm install -g stigmergy-cli
   ```

3. **Проблемы с сетевым подключением**
   ```bash
   # Настройка зеркала NPM
   npm config set registry https://registry.npmmirror.com
   ```

4. **Ошибка установки инструментов CLI**
   ```bash
   # Ручная установка конкретного инструмента
   npm install -g @anthropic-ai/claude-code
   ```

### Режим отладки

```bash
# Детальный вывод отладки
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 и Issues приветствуются!

1. Форк проекта
2. Создание ветки функции (`git checkout -b feature/AmazingFeature`)
3. Коммит изменений (`git commit -m 'Add some AmazingFeature'`)
4. Отправка в ветку (`git push origin feature/AmazingFeature`)
5. Открытие Pull Request

## 📄 Лицензия

Этот проект лицензирован по лицензии MIT - см. файл [LICENSE](LICENSE) для подробностей.

---

**🎯 Stigmergy CLI - Истинное сотрудничество между CLI, позволяющее каждому инструменту ИИ максимизировать свою ценность!