Работа с форком Codex в SourceCraft CLI

SourceCraft CLI расширяет возможности AI-агентов, добавляя интеграцию с платформой. Вы можете использовать команды и инструменты выбранного агента.

При запуске через SourceCraft CLI в AI-агенты добавляются:

  • Навык src-cli с описанием и руководством по CLI.
  • При нахождении в директории репозитория — информация о том, что репозиторий размещен в SourceCraft, и дополнительные инструкции по работе с ним и CLI.

Если у вас еще нет SourceCraft CLI, установите и настройте его. Склонируйте репозиторий и перейдите в его директорию. Для изменений создайте отдельную ветку:

git checkout -b feature/issue-2

Начните работу с агентом

Форк Codex CLI адаптирован для работы с SourceCraft. В нем преднастроены модели Code Assistant, улучшена эффективность работы с ними, а также установлены инструменты управления платформой. Агент работает в терминале: изучает код проекта, вносит изменения, запускает команды и отвечает на вопросы по репозиторию.

  1. Установите агента:

    src ycodex install
    
  2. Перейдите в директорию вашего проекта и запустите агента:

    src ycodex
    

    По умолчанию агент использует аутентификацию, настройки и модели SourceCraft.

  3. Последовательно вводите запросы к AI-агенту на естественном языке. Например, чтобы выполнить задачу с идентификатором 2:

    Получи список задач в репозитории.
    

    Агент воспользуется SourceCraft CLI для получения списка задач и выведет их.

    Реализуй в коде предложение пользователя из задачи с идентификатором 2 и протестируй код.
    

    Агент спланирует действия, внесет изменения в код и протестирует его.

    Сделай коммит с изменениями, отправь в удаленный репозиторий и создай предложение изменений.
    

    С помощью SourceCraft CLI агент создаст предложение изменений и выведет ссылку на него.

    Для более гранулярного контроля за действиями агента вы можете не просить его делать коммит и отправлять изменения в репозиторий, а сделать это самостоятельно. Сначала проверьте изменения и добавьте нужные файлы в индекс:

    git status
    git diff
    git add <пути_к_файлам>
    git commit -m "Implement issue 2"
    git push -u origin HEAD
    src pr create
    

    Совет

    Команды других инструментов можно вызывать прямо из TUI, добавив в начало !. Например, !git status покажет состояние репозитория, а !src pr list — список предложений изменений.

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

  • /new — начать новый диалог.
  • /diff — посмотреть изменения в файлах проекта.
  • /quit — завершить работу с агентом.

Чтобы добавить файл в контекст запроса, введите @ и выберите файл из списка.

Совет

Чтобы выполнить запрос к агенту с настройками SourceCraft без перехода в интерактивный интерфейс, используйте команду:

src do --ycodex "Изучи код в репозитории, расскажи, как он устроен и зачем нужен."

Выберите AI-модель

Чтобы выбирать AI-модели SourceCraft, нужна платная подписка в организации, выбранной для списания нейрокредитов. Администратор или владелец организации должен разрешить использование выбранной модели. Подробнее в инструкции Настроить AI-модели в SourceCraft.

Совет

Если для вас оформлены платные подписки в нескольких организациях, вы можете выбрать организацию, из квоты которой будут списываться нейрокредиты.

После запуска агента командой src ycodex, введите /model и выберите нужную модель из списка. Чтобы проверить, какая модель используется, выполните /status.

По умолчанию агент использует модели SourceCraft.

Вы также можете указать модель при запуске:

src ycodex --model <идентификатор_модели>

Если вы хотите, чтобы сервис сам подбирал модель для задачи, используйте модель по умолчанию.

Обновите CLI и AI-агентов

Чтобы проверить наличие обновлений SourceCraft CLI и установленных через него AI-агентов, выполните команду:

src update --check

Чтобы установить доступные обновления, выполните команду:

src update --auto

Обновятся SourceCraft CLI и установленные через него форк Codex CLI для SourceCraft, Codex CLI и OpenCode. Подробнее в справочнике src update.

Полезные ссылки

В составе SourceCraft CLI используется немодифицированный исполняемый файл Codex CLI.

Copyright 2025 OpenAI.

Apache License 2.0

Предыдущая
Следующая