Git Workspace for Codex

Локальный Git прямо в Codex. Просматривайте изменения и управляйте коммитами нескольких репозиториев из одной панели.

Возможности · Установка · Начало-работы · Конфиденциальность · Разработка

Для Codex на macOS. Для запуска требуются Git и Node.js 22+.

Возможности

• Несколько репозиториев — выберите папку с проектами.
• Changes и Staged Changes — просматривайте diff, добавляйте и убирайте файлы из staging.
• Diff и файл целиком — смотрите изменения и счётчики добавленных/удалённых строк.
• Commit и Push — проверьте направление перед отправкой.
• Сообщения коммитов — генерация через Codex CLI; модель, язык и формат настраиваются отдельно.
• Новый репозиторий — инициализируйте Git и подключите GitHub remote.

Установка

После публикации репозитория в GitHub:

codex plugin marketplace add w1z2z/git-workspace-for-codex
codex plugin add git-workspace@git-workspace-local

Перезапустите Codex (⌘Q) и откройте Git Workspace в разделе плагинов. Если установка по GitHub slug не работает в вашей версии Codex, скачайте ZIP, распакуйте его и укажите путь к папке:

codex plugin marketplace add "/путь/к/git-workspace-for-codex"
codex plugin add git-workspace@git-workspace-local

Сборка уже включена, npm для установки не нужен.

Начало работы

1. Откройте Git Workspace и нажмите Папка….
2. Выберите папку с проектами и репозиторий.
3. Выберите файл для просмотра diff или полного содержимого.
4. + добавляет файл в Staged Changes; − убирает.
5. Напишите сообщение или нажмите кнопку со звёздами для генерации.
6. Нажмите Commit, затем Push, чтобы отправить коммит.

Если staging пуст, Commit включает все изменения репозитория. Если в staging уже есть файлы — коммитятся только они. Для подключения GitHub сначала создайте пустой репозиторий, затем добавьте его HTTPS или SSH URL в плагине.

Настройки генерации

• Язык приложения — язык интерфейса.
• Язык текста коммита — язык сообщения.
• Формат — feat: add login (Conventional Commit) или Add login (краткая тема).
• Модель — модель Codex для генерации.

Генерация требует Codex CLI и активного входа. API-ключ не нужен. Остальные функции работают без Codex CLI.

Конфиденциальность

• Плагин работает с выбранными локальными Git-репозиториями.
• При генерации diff изменений передаётся Codex CLI; размер ограничен 250 КБ.
• Codex CLI запускается в read-only sandbox. Плагин не читает файлы авторизации.
• Push запускается только по нажатию; направление можно проверить перед отправкой.
• Автоматические fetch и pull не выполняются. Force push, merge и rebase не поддерживаются.
• Отмена изменений файла сохраняет его копию в локальном Git stash после подтверждения.
• Настройки и черновики хранятся в ~/Library/Application Support/Git Workspace/.

Требования

Разработка

npm ci
npm run build
npm test

Собранные файлы для установки находятся в dist/. После изменений исходников команды выше обновляют сборку и запускают тесты на временных Git-репозиториях.

Удаление

codex plugin remove git-workspace@git-workspace-local

Настройки и черновики в ~/Library/Application Support/Git Workspace/ удаляются отдельно.

Лицензия

MIT