Работа с OpenCode в SourceCraft CLI

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

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

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

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

git checkout -b feature/issue-2

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

OpenCode — AI-агент с открытым исходным кодом для работы в терминале. Он помогает изучать проект, писать и отлаживать код, запускать команды и тесты. При запуске через SourceCraft CLI агент использует авторизацию и модели SourceCraft.

  1. Если вы пропустили установку OpenCode при первоначальной настройке SourceCraft CLI, установите его:

    src code install
    

    Будет установлен форк OpenCode, доработанный для работы с SourceCraft. Следить за версией OpenCode можно на странице Релизы SourceCraft CLI.

  2. В директории репозитория запустите OpenCode:

    src code
    
  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 — список предложений изменений.

Для работы в терминальном интерфейсе (TUI) OpenCode используйте команды:

  • /help — открыть справку.
  • @ — выбрать файл, содержимое которого нужно добавить в контекст запроса.
  • /new — начать новый диалог.
  • /undo — отменить последнее сообщение и связанные с ним изменения файлов.
  • /exit — выйти из агента.

Подробнее о командах и сочетаниях клавиш в документации OpenCode.

Совет

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

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

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

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

Совет

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

В OpenCode, запущенном командой src code, введите /models или нажмите Ctrl + P и выберите Switch model. В открывшемся списке выберите нужную модель.

Также вы можете указать идентификатор модели при запуске агента:

src code --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

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