cc-gemini-plugin

Интеграция Gemini CLI с двумя хостами — для Claude Code и Codex.

Репозиторий использует один общий рантайм Gemini и два тонких адаптера:

• Claude Code предоставляет команду /cc-gemini-plugin:gemini и агент gemini-agent.
• Codex предоставляет встроенный скилл gemini-integration.

Каждый хост получает удобный способ передавать масштабные задачи кросс-файлового анализа в Gemini вместо того, чтобы обрабатывать файлы по одному.

Архитектура

• Общий мост-рантайм в scripts/gemini-bridge.js
• Интеграция с Claude Code через манифест плагина, команду /cc-gemini-plugin:gemini и агент gemini-agent
• Интеграция с Codex через корневой файл определения скилла SKILL.md и agents/openai.yaml
• Тесты моста в tests/gemini-bridge.test.js

Сценарии использования

• Понимание архитектуры всей кодовой базы
• Кросс-файловый аудит безопасности
• Анализ влияния рефакторинга
• Ориентирование в незнакомой кодовой базе
• Генерация документации
• Синтез структурированных текстовых данных из JSON, YAML, TOML, CSV, Markdown и кода

Предварительные требования

1. Установите Gemini CLI

npm install -g @google/gemini-cli
# или
brew install gemini-cli

2. Пройдите аутентификацию

3. Проверьте работу Gemini

Установка

Claude Code

Установка выполняется на уровне пользователя. После добавления маркетплейса и установки плагина он будет доступен в новых сессиях Claude Code на этой машине.

Добавьте маркетплейс с GitHub, установите плагин, затем перезагрузите плагины:

/plugin marketplace add thepushkarp/cc-gemini-plugin
/plugin install cc-gemini-plugin@cc-gemini-plugin
/reload-plugins

После установки используйте:

Для обновления плагина:

/plugin marketplace update cc-gemini-plugin
/reload-plugins

Codex

Для работы с этим репозиторием Codex не требует плагина. Установите его как скилл на уровне пользователя — он будет доступен в новых сессиях Codex на этой машине во всех репозиториях.

Установите, клонировав репозиторий в ~/.agents/skills:

mkdir -p ~/.agents/skills
git clone https://github.com/thepushkarp/cc-gemini-plugin.git \
  ~/.agents/skills/cc-gemini-plugin

После клонирования скилла перезапустите Codex.

Для последующего обновления:

После установки используйте встроенный скилл:

Общий рантайм

Оба хоста маршрутизируют запросы через:

Поддерживаемые опции:

• --model <name>
• --dirs <path,...>
• --files <glob,...>
• --format <text|json|stream-json>
• --max-files <n>
• --max-file-bytes <n>
• --print-command

Мост:

• собирает файлы и директории локально
• встраивает текстовое содержимое в структурированный промпт
• пропускает неподдерживаемые бинарные файлы
• вызывает Gemini CLI в безголовом режиме

Точки входа хостов

Claude Code

Использование:

/cc-gemini-plugin:gemini <задача>
/cc-gemini-plugin:gemini --dirs src,docs <задача>
/cc-gemini-plugin:gemini --files "schemas/**/*.json,data/**/*.csv" <задача>

Codex

Используйте встроенный скилл:

Или попросите Codex использовать интеграцию Gemini для прохода с большим контекстом.

Метаданные скилла для Codex находятся в agents/openai.yaml.

Примеры

Архитектурный обзор:

node scripts/gemini-bridge.js --dirs src,docs \
  "Explain the architecture and cite the key files."

Анализ влияния рефакторинга:

node scripts/gemini-bridge.js --dirs src \
  "Analyze the impact of refactoring the auth module. Include affected files and migration steps."

Обзор структурированных данных:

node scripts/gemini-bridge.js --files "schemas/**/*.json,data/**/*.csv" \
  "Summarize the data contracts and identify breaking changes."

Структурированный вывод:

node scripts/gemini-bridge.js --format json --dirs src \
  "Summarize the public API surface."

Разработка

Запуск тестов моста:

Структура репозитория

cc-gemini-plugin/
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── SKILL.md
├── agents/
│   ├── gemini-agent.md
│   └── openai.yaml
├── commands/
│   └── gemini.md
├── scripts/
│   └── gemini-bridge.js
├── tests/
│   └── gemini-bridge.test.js
└── package.json

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

Лицензия

MIT