Гонка AI x OpenCode
Оригинал: Gonka AI x OpenCode
Гонка AI x OpenCode
Привет всем,
Мы только что опубликовали небольшую утилиту настройки OpenCode для GonkaGate.
@gonkagate/opencode-setup — это интерфейс командной строки с открытым исходным кодом для людей, которые уже используют открытый код и хотят использовать его в GonkaGate, не превращая настройку в побочный квест. Никакого ручного редактирования opencode.json , экспорта секретов профиля оболочки и необходимости изучать форму конфигурации пользовательского поставщика OpenCode перед первым запросом.
Что мы построили
Мы создали локальный установщик на основе:
npx @gonkagate/opencode-setup
Он обрабатывает конфигурацию, связанную с настройкой поставщика, секретной привязкой, выбором области и проверкой эффективной конфигурации, а затем уходит с дороги, чтобы вы могли продолжать использовать простой открытый код.
Почему мы это построили
Это один из тех предметов сантехники, который должен быть скучным, но зачастую это не так. Если у вас уже есть ключ GonkaGate, следующим шагом не должно быть «открыть три вкладки документации и выяснить, где OpenCode сегодня хочет получить конфигурацию провайдера».
Более рискованные части также наименее интересны: размещение секрета не в том месте, оставление локального репозитория opencode.json в странном состоянии или мысль о том, что настройка сработала, потому что файл изменился, хотя OpenCode разрешает другую конфигурацию во время выполнения. Мы хотели, чтобы путь установки был коротким, явным и внимательным к тому, что он утверждает.
Быстрый старт
Интерактивный
npx @gonkagate/opencode-setup
Неинтерактивный с GONKAGATE_API_KEY
GONKAGATE_API_KEY=gp-... npx @gonkagate/opencode-setup --scope project --yes
Неинтерактивный со стандартным вводом
printf ' %s ' " $GONKAGATE_API_KEY " | npx @gonkagate/opencode-setup --api-key-stdin --scope project --yes
После настройки:
открытый код
Что делает установщик
- Проверяет, что локальный открытый код доступен и поддерживается.
- Показывает общедоступное средство выбора модели в интерактивном режиме.
- Запрашивает область действия пользователя или проекта.
- Принимает ключ GonkaGate через скрытую подсказку GONKAGATE_API_KEY или --api-key-stdin.
- Отклоняет простой --api-key .
- Сохраняет секретность в локальных файлах репозитория.
- Записывает определение поставщика GonkaGate на уровне пользователя и привязку секрета.
- Если выбрана область проекта, в репо-локальный opencode.json записывает только настройки активации.
- Сохраняет несвязанные настройки OpenCode там, где это возможно.
- Создает резервные копии отката перед заменой управляемых файлов.
- Прежде чем сообщить об успехе, проверяется устойчивая конфигурация открытого кода и эффективная конфигурация OpenCode текущего сеанса.
Шлюз, конфигурация OpenCode и транспорт
Масштаб проекта намеренно консервативен. Локальный репозиторий opencode.json получает только настройки активации. Определение поставщика и секретная привязка остаются в области пользователя, поэтому файл проекта по умолчанию остается безопасным для фиксации.
Установщик не записывает данные напрямую в auth.json, не создает файлы .env и не изменяет профили оболочки.
Модели прямо сейчас
Публичный сборщик сейчас намеренно небольшой. У него есть один проверенный вариант:
Мы рассматриваем это как тщательно подобранный список, а не как коробку произвольной модели. Можно добавить дополнительные параметры, поскольку они проходят один и тот же путь проверки OpenCode.
На что мы не заявляем
Границы четкие:
сегодня нет поддержки /v1/responses
нет произвольного переопределения базового URL-адреса в версии 1
нет поддержки произвольного идентификатора пользовательской модели в версии 1
нет простого --api-key
нет редактирования профиля оболочки
нет генерации .env
нет прямой записи в auth.json
еще нет проверки сеанса в реальном времени GonkaGate
- нет идеального объяснения для каждого возможного уровня конфигурации OpenCode с более высоким приоритетом, хотя локально проверяемые блокировщики появляются там, где это возможно.
Если поддержка /v1/responses появится позже, это должна быть миграция по этой интеграции, а не переименование или утверждение «притворись, что оно уже работает».
Полезные ссылки
Репозиторий (https://github.com/GonkaGate/opencode-setup)
пакет npm (https://www.npmjs.com/package/@gonkagate/opencode-setup)
README (https://github.com/GonkaGate/opencode-setup#readme)
Как это работает (https://github.com/GonkaGate/opencode-setup/blob/main/docs/how-it-works.md)
Примечания по безопасности (https://github.com/GonkaGate/opencode-setup/blob/main/docs/security.md)
Устранение неполадок (https://github.com/GonkaGate/opencode-setup/blob/main/docs/troubleshooting.md)
Проверка модели (https://github.com/GonkaGate/opencode-setup/blob/main/docs/model-validation.md)
Журнал изменений (https://github.com/GonkaGate/opencode-setup/blob/main/CHANGELOG.md)
Проблемы и отзывы (https://github.com/GonkaGate/opencode-setup/issues)
GonkaGate (https://gonkagate.com/en)
Получите ключ API GonkaGate (https://gonkagate.com/en/register)
Краткое руководство GonkaGate (https://gonkagate.com/en/docs/quickstart)
OpenCode (https://opencode.ai)
Gonka AI x OpenCode
Hi everyone,
We just published a small OpenCode setup utility for GonkaGate.
@gonkagate/opencode-setup is an open source onboarding CLI for people who already use opencode and want to point it at GonkaGate without making setup a side quest. No hand-editing opencode.json , no shell profile secret exports, and no need to learn the OpenCode custom-provider config shape before the first request.
What we built
We built a local installer around:
npx @gonkagate/opencode-setup
It handles the config plumbing around provider setup, secret binding, scope selection, and effective-config verification, then gets out of the way so you can keep using plain opencode .
Why we built it
This is one of those pieces of plumbing that should be boring, but often is not. If you already have a GonkaGate key, the next step should not be "open three docs tabs and figure out where OpenCode wants provider config today."
The riskier parts are also the least fun: putting the secret in the wrong place, leaving a repo-local opencode.json in a weird state, or thinking setup worked because a file changed even though OpenCode resolves a different config at runtime. We wanted the setup path to be short, explicit, and careful about what it claims.
Quick start
Interactive
npx @gonkagate/opencode-setup
Non-interactive with GONKAGATE_API_KEY
GONKAGATE_API_KEY=gp-... npx @gonkagate/opencode-setup --scope project --yes
Non-interactive with stdin
printf ' %s ' " $GONKAGATE_API_KEY " | npx @gonkagate/opencode-setup --api-key-stdin --scope project --yes
After setup:
opencode
What the installer does
- Checks that local opencode is available and supported.
- Shows the public curated model picker in interactive mode.
- Asks for user or project scope.
- Accepts the GonkaGate key through a hidden prompt, GONKAGATE_API_KEY , or --api-key-stdin .
- Rejects plain --api-key .
- Keeps the secret out of repository-local files.
- Writes the user-level GonkaGate provider definition and secret binding.
- When project scope is selected, writes only activation settings to repo-local opencode.json .
- Preserves unrelated OpenCode settings where it can.
- Creates rollback backups before replacing managed files.
- Verifies the durable plain- opencode config and the current session's effective OpenCode config before reporting success.
Gateway, OpenCode config, and transport
The project scope is intentionally conservative. The repo-local opencode.json only gets activation settings. The provider definition and secret binding stay in user scope, so the project file remains commit-safe by default.
The installer does not write directly to auth.json , does not create .env files, and does not mutate shell profiles.
Models right now
The public picker is deliberately small right now. It has one validated option:
We are treating this as a curated list, not a free-form custom model box. More options can be added as they pass the same OpenCode validation path.
What we're not claiming
The boundaries are explicit:
no /v1/responses support today
no arbitrary custom base URL override in v1
no arbitrary custom model id support in v1
no plain --api-key
no shell profile edits
no .env generation
no direct writes to auth.json
no live GonkaGate session verification yet
- no perfect explanation for every possible higher-precedence OpenCode config layer, although locally inspectable blockers are surfaced where possible
If /v1/responses support lands later, it should be a migration on this integration, not a rename or a pretend-it-already-works claim.
Гонка AI x OpenCode
Привет всем,
Мы только что опубликовали небольшую утилиту настройки OpenCode для GonkaGate.
@gonkagate/opencode-setup — это интерфейс командной строки с открытым исходным кодом для людей, которые уже используют открытый код и хотят использовать его в GonkaGate, не превращая настройку в побочный квест. Никакого ручного редактирования opencode.json , экспорта секретов профиля оболочки и необходимости изучать форму конфигурации пользовательского поставщика OpenCode перед первым запросом.
Что мы построили
Мы создали локальный установщик на основе:
npx @gonkagate/opencode-setup
Он обрабатывает конфигурацию, связанную с настройкой поставщика, секретной привязкой, выбором области и проверкой эффективной конфигурации, а затем уходит с дороги, чтобы вы могли продолжать использовать простой открытый код.
Почему мы это построили
Это один из тех предметов сантехники, который должен быть скучным, но зачастую это не так. Если у вас уже есть ключ GonkaGate, следующим шагом не должно быть «открыть три вкладки документации и выяснить, где OpenCode сегодня хочет получить конфигурацию провайдера».
Более рискованные части также наименее интересны: размещение секрета не в том месте, оставление локального репозитория opencode.json в странном состоянии или мысль о том, что настройка сработала, потому что файл изменился, хотя OpenCode разрешает другую конфигурацию во время выполнения. Мы хотели, чтобы путь установки был коротким, явным и внимательным к тому, что он утверждает.
Быстрый старт
Интерактивный
npx @gonkagate/opencode-setup
Неинтерактивный с GONKAGATE_API_KEY
GONKAGATE_API_KEY=gp-... npx @gonkagate/opencode-setup --scope project --yes
Неинтерактивный со стандартным вводом
printf ' %s ' " $GONKAGATE_API_KEY " | npx @gonkagate/opencode-setup --api-key-stdin --scope project --yesПосле настройки:
открытый код
Что делает установщик
Шлюз, конфигурация OpenCode и транспорт
Масштаб проекта намеренно консервативен. Локальный репозиторий opencode.json получает только настройки активации. Определение поставщика и секретная привязка остаются в области пользователя, поэтому файл проекта по умолчанию остается безопасным для фиксации.
Установщик не записывает данные напрямую в auth.json, не создает файлы .env и не изменяет профили оболочки.
Модели прямо сейчас
Публичный сборщик сейчас намеренно небольшой. У него есть один проверенный вариант:
Мы рассматриваем это как тщательно подобранный список, а не как коробку произвольной модели. Можно добавить дополнительные параметры, поскольку они проходят один и тот же путь проверки OpenCode.
На что мы не заявляем
Границы четкие:
сегодня нет поддержки /v1/responses
нет произвольного переопределения базового URL-адреса в версии 1
нет поддержки произвольного идентификатора пользовательской модели в версии 1
нет простого --api-key
нет редактирования профиля оболочки
нет генерации .env
нет прямой записи в auth.json
еще нет проверки сеанса в реальном времени GonkaGate
Если поддержка /v1/responses появится позже, это должна быть миграция по этой интеграции, а не переименование или утверждение «притворись, что оно уже работает».
Полезные ссылки
Репозиторий (https://github.com/GonkaGate/opencode-setup)
пакет npm (https://www.npmjs.com/package/@gonkagate/opencode-setup)
README (https://github.com/GonkaGate/opencode-setup#readme)
Как это работает (https://github.com/GonkaGate/opencode-setup/blob/main/docs/how-it-works.md)
Примечания по безопасности (https://github.com/GonkaGate/opencode-setup/blob/main/docs/security.md)
Устранение неполадок (https://github.com/GonkaGate/opencode-setup/blob/main/docs/troubleshooting.md)
Проверка модели (https://github.com/GonkaGate/opencode-setup/blob/main/docs/model-validation.md)
Журнал изменений (https://github.com/GonkaGate/opencode-setup/blob/main/CHANGELOG.md)
Проблемы и отзывы (https://github.com/GonkaGate/opencode-setup/issues)
GonkaGate (https://gonkagate.com/en)
Получите ключ API GonkaGate (https://gonkagate.com/en/register)
Краткое руководство GonkaGate (https://gonkagate.com/en/docs/quickstart)
OpenCode (https://opencode.ai)