KubeOpenCode CLI
Агенты OpenCode в Kubernetes: задачи и общие настройки задают манифестами, а в живого агента заходят командой kubeoc
- 120 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент выполняет произвольный код и команды в кластере с правами служебной учетной записи.
- Ключи модели и доступ к репозиториям выдаются агентам через секреты Kubernetes.
Установка
- Работает в
Ручная установка
kubectl create namespace kubeopencode-system
helm install kubeopencode oci://ghcr.io/kubeopencode/helm-charts/kubeopencode --namespace kubeopencode-system --set server.enabled=trueСтавит оператор в кластер. Утилиту `kubeoc` отдельно: `go install github.com/kubeopencode/kubeopencode/cmd/kubeoc@latest`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольный код и команды в кластере с правами служебной учетной записи.
- Ключи модели и доступ к репозиториям выдаются агентам через секреты Kubernetes.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
KubeOpenCode запускает агентов OpenCode внутри кластера Kubernetes. Агент и задача описываются манифестами `Agent` и `Task`: в них указаны профиль, рабочий каталог, служебная учетная запись, секрет с ключом модели и текст поручения, например обновить зависимости, прогнать тесты и открыть запрос на слияние. Проект ставится в кластер Helm-чартом. Для работы из терминала есть утилита `kubeoc`: `kubeoc get agents` показывает агентов, `kubeoc agent attach` подключает к работающему. Проект независим от команды OpenCode и добавляет общие настройки агентов, управление и интеграцию с корпоративной инфраструктурой.
Для кого. Командам платформенной инженерии, которые запускают кодинг-агентов в общем кластере и хотят единые настройки и учет.
Подходит, если
- Нескольким командам нужен один набор профилей агента вместо личных конфигураций.
- Обновление зависимостей с тестами и запрос на слияние поручают агенту как задачу в кластере.
- Ключи модели хранятся в секретах Kubernetes, а не на ноутбуках.
- За работой агента следят из терминала командой `kubeoc agent attach`.
Не подходит, если
- Единственному разработчику хватает обычного OpenCode на локальной машине.
- Кластера Kubernetes нет и поднимать его не планируется.
- Агенту нельзя давать доступ к репозиториям и секретам кластера.
Пример запроса к агенту
Создай агента по умолчанию в kubeopencode-system и поставь ему задачу обновить зависимости, прогнать тесты и открыть запрос на слияние.Ограничения
Нужен кластер Kubernetes, Helm и ключ модели в секрете. API манифестов имеет версию `v1alpha1`, то есть может меняться. Проект независим от OpenCode и не связан с его командой. Агент действует с правами указанной служебной учетной записи, поэтому права стоит ограничить до необходимого. Интерфейс сервера включается флагом `server.enabled=true` при установке. Подробности по безопасности, архитектуре и функциям вынесены в документацию проекта, в README их нет.
Как отключить. Удалите релиз командой `helm uninstall kubeopencode -n kubeopencode-system` и пространство имен, если оно больше не нужно. Утилиту `kubeoc` уберите вручную из `PATH`.
Частые вопросы
Как поставить KubeOpenCode в кластер?
Создайте пространство имен `kubeopencode-system` и выполните `helm install` для чарта `oci://ghcr.io/kubeopencode/helm-charts/kubeopencode` с `--set server.enabled=true`.
Как поставить утилиту kubeoc?
Выполните `go install github.com/kubeopencode/kubeopencode/cmd/kubeoc@latest`. После этого `kubeoc get agents` покажет агентов кластера.
Связан ли проект с командой OpenCode?
Нет. Авторы прямо называют его независимым проектом на основе OpenCode.
Как описать задачу для агента?
Создайте манифест `Task` с полями `agentRef` и `description`. Например, в описании можно поручить обновить зависимости, прогнать тесты и создать запрос на слияние.
Где хранится ключ модели?
В секрете Kubernetes: манифест `Agent` ссылается на него через `credentials` и передает значение в переменную `OPENCODE_API_KEY`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и оператор Kubernetes, который запускает Claude Code, Codex, Gemini, OpenCode и Cursor как задачи и сессии в кластере
Набор агентов для Kubernetes и GKE: аудиты флота по расписанию, правки через пулреквесты, ответы в Google Chat и Slack
Открытый интерфейс Kubernetes с встроенным MCP-сервером: агент осматривает кластер, разбирает поломки и выполняет операции с учетом RBAC
Docker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.
Самостоятельно хостится центр управления агентами: Claude Code, Codex, Copilot, OpenCode и Pi с телефона, десктопа и терминала
Скилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| KubeOpenCode (эта карточка) | нет | 120 | ||
| OpenCode | нет | 224 828 | сам OpenCode работает на одной машине; KubeOpenCode запускает его агентов в Kubernetes с общими профилями | |
| Kubernetes MCP | нет | не нужна | 1 610 | та карточка дает агенту доступ к кластеру через MCP; здесь сами агенты живут в кластере |
Коротко о README
Установка идет Helm-чартом, пример показывает пару манифестов `Agent` и `Task`. Проект сообщества, отдельный от OpenCode.