К основному содержанию
скилл CX Codex

devbox — скилл для Claude Code: что делает и как установить

Скилл devbox для Claude Code запускает кодинг-агента на собственной инфраструктуре для автоматической обработки задач в репозиториях. Он составляет план, пишет код, проводит ревью и открывает черновики PR.

MIT ★ 341 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rudderlabs/devbox --skill devbox -a claude-code
Открыть на GitHub

Что делает devbox

Агент принимает задачи через CLI или интеграции с Jira, Linear, ClickUp и GitHub. Для каждой задачи создаётся изолированный контейнер-песочница через iron-proxy, который подставляет токены только для разрешённых операций, не раскрывая их напрямую. Управление настройками и развёртывание осуществляются через bun run из корня проекта.

Работа требует установки bun. Перед запуском необходимо настроить devbox.config.json и предоставить необходимые секреты в системный Keychain или переменные окружения. Без настройки интеграций или при неверном указании пути --target в Kubernetes-режиме агент не сможет выполнить задачу. Команды деструктивного характера, такие как bun run reset, требуют подтверждения пользователя.

Какие задачи решает

  • автоматизировать создание черновиков PR по задаче
  • интегрировать работу агента с Jira или Linear
  • провести диагностику состояния интеграций через статус-команды
  • развернуть инфраструктуру агента через Docker Compose или Kubernetes

Примеры запросов агенту

  • bun run devbox create для постановки новой задачи
  • bun run github:status для проверки связи с GitHub
  • ! bun run k8s:install --target <file> для настройки в K8s

Как установить devbox

1Через Skills CLI (Vercel)

npx skills add rudderlabs/devbox --skill devbox -a claude-code

2Вручную: положить файлы

~/.claude/skills/devbox/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/devbox/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о devbox

Как установить devbox в Claude Code?

Выполните команду npx skills add rudderlabs/devbox --skill devbox -a claude-code в терминале проекта.

Что делает devbox?

Это кодинг-агент, который самостоятельно планирует, реализует и рецензирует изменения в коде, открывая черновики PR на основе входящих задач.

Что нужно для работы devbox?

Для работы необходимы установленный bun, настроенный файл devbox.config.json и корректно заданные секреты в системном Keychain или переменных окружения.

Исходный текст

SKILL.md · MIT
---
name: devbox
description: How devbox works and how to run it — the self-hosted coding agent that takes a task, opens a draft pull request and takes follow-ups. Use when setting devbox up (bun run quickstart, devbox.config.json, Docker Compose, kind, Kubernetes, Helm, GitOps, EKS), when using it (bun run devbox create/logs/send, CLI profiles), when connecting the GitHub App, GitLab, Linear, Jira, ClickUp or Slack, when upgrading or uninstalling it, or when something about it fails (bun run up, k8s:install, *:status, iron-proxy, sandboxes, secrets, the keychain, tunnels).
---

# devbox

devbox is a coding agent that runs on the user's own infrastructure and works
on their GitHub repos. A task goes in through the CLI (or a Linear or Jira
issue, a ClickUp task, or a GitHub `@mention`); the agent plans, implements,
reviews its own work and opens a draft pull request; follow-ups push new
commits to the same pull request.

```
devbox CLI ──HTTP──> control plane ──OpenSandbox──> sandbox, one per task (harness)
                     (API, Postgres)                        │ dummy tokens
                                                            v
                                                       iron-proxy ── real tokens ──> GitHub, LLM
```

The sandbox never holds a real credential: iron-proxy swaps dummy tokens for
the real ones and allows writes only to the configured repos. Details:
[docs/architecture.md](../../docs/architecture.md).

## Rules for working with devbox

- **Run every command from the root of the devbox repo.** All commands are
  `bun run <script>` from its `package.json`.
- **Never put a secret in a file, a command line or the chat.** devbox finds
  secrets itself: the environment, then the system keychain, then
  `gh auth token` (GitHub token only), then a hidden prompt. If one is missing,
  tell the user which variable it is and let them provide it
  ([docs/configuration.md#secrets](../../docs/configuration.md#secrets)).
- **Hidden prompts need a terminal you don't have.** `bun run quickstart`,
  `up`, `k8s:install`, `k8s:kind` and the `*:setup` commands may ask questions.
  Pass the flags that answer them ahead, and when a secret is still needed,
  ask the user to run the command themselves (in Claude Code: `! bun run …`).
- **Ask before destructive commands:** `bun run reset` (deletes the database
  and every task's workspace), `k8s:uninstall --purge`, `*:disable --forget`,
  `bun run secrets rm|clear`.
- **Diagnose with the status commands first:** `github:status`,
  `linear:status`, `jira:status`, `clickup:status`, `k8s:check`,
  `bun run devbox show <task>`.
- **Read the linked doc before changing a setting** instead of guessing a
  field: the config parsers reject unknown keys.

## What do you need?

| Goal | Read |
|---|---|
| Set devbox up on this machine for the first time | [references/quickstart.md](references/quickstart.md) |
| Run tasks, follow them, switch control planes | [references/using.md](references/using.md) |
| Connect the GitHub App, GitLab, Linear, Jira, ClickUp or Slack | [references/integrations.md](references/integrations.md) |
| Run on Kubernetes: installer, GitOps, EKS, upgrade, uninstall | [references/kubernetes.md](references/kubernetes.md) |
| Something fails | [references/troubleshooting.md](references/troubleshooting.md) |

## Deployment modes

| Mode | Where it runs | Start / apply | Config |
|---|---|---|---|
| Docker Compose | this machine | `bun run up` (or `bun run quickstart --compose`) | `devbox.config.json` |
| kind | a local Kubernetes cluster in Docker | `bun run k8s:kind` (or `bun run quickstart --kind`) | `devbox.config.json` + `devbox.kind.json` |
| Kubernetes, installer | any cluster | `bun run k8s:install --target <file>` | `devbox.config.json` + the target file |
| Kubernetes, GitOps | any cluster | the Helm chart in `deploy/helm/devbox` | Helm values + your own Secrets |

`devbox.config.json` holds `repos` and `llm` for every mode. On Compose it also
holds `publicUrl`, `integrations`, `github` (trust lists) and `sandbox`. On
Kubernetes those live in the target file (`--target`) instead
([docs/configuration.md](../../docs/configuration.md)).

## Commands

| Command | Does |
|---|---|
| `bun run quickstart` | To a running local devbox, with chosen integrations; writes `devbox.config.json` from the user's answers when there is none |
| `bun run up` / `bun run down` / `bun run reset` | Start, stop (keeps tasks), or wipe the Compose stack |
| `bun run devbox <command>` | The CLI: `create`, `ls`, `show`, `logs`, `send`, `wait`, `restart`, `whoami`, `profile` |
| `bun run secrets ls\|rm\|clear` | Show or remove the secrets saved in the keychain |
| `bun run github:setup\|status\|disable` | The GitHub App |
| `bun run linear:setup\|status\|disable` | Linear |
| `bun run gitlab:setup\|status\|disable` | GitLab merge request notes and pipelines |
| `bun run jira:setup\|status\|disable` | Jira |
| `bun run clickup:setup\|status\|disable` | ClickUp |
| `bun run k8s:kind` | A local kind cluster with devbox installed |
| `bun run k8s:install\|connect\|check\|refresh-snapshot\|uninstall` | Kubernetes, with `--target <file>` |

The integration commands act on Compose without `--target`, and on that
Kubernetes deployment with it (`--target devbox.kind.json` on kind).

## What devbox does not do (v1)

Say so instead of looking for a way around it:

- Code hosts: GitHub, and GitLab (gitlab.com or self-managed, one instance
  per deployment). No Bitbucket. [docs/gitlab.md](../../docs/gitlab.md).
- Two LLM APIs: OpenAI's Responses API and Anthropic's Messages API. A
  self-hosted model needs a server that speaks the Responses API with
  reasoning, on port 80 or 443 under a DNS name.
- Work comes in from the CLI, Linear, Jira (Cloud only), ClickUp (one
  workspace per deployment) and GitHub, plus GitLab merge request notes and
  failed pipelines. Slack only gets completion updates for Linear tasks. No
  web UI.
- A task can't be stopped from Linear, Jira or ClickUp yet. A ClickUp
  automation never starts work.
- No stable extension interface ([docs/extending.md](../../docs/extending.md)).

© rudderlabs · MIT · rudderlabs/devbox

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
gitlab-cicd-pipeline aj-geddes Скилл gitlab-cicd-pipeline для Claude Code помогает агенту писать .gitlab-ci.yml: стадии, джобы, кэш, артефакты, деплой в Kubernetes. Собирает пайплайн с нуля или переделывает существующий. CX Codex +1 673установок gitlab-ci-patterns Seth Hobson Скилл gitlab-ci-patterns для Claude Code помогает собирать GitLab CI/CD-пайплайны со стадиями, кэшем и деплоем. Описывает пайплайны для тестирования, сборки и доставки приложений. CX Codex +1 13 112установок project-references dboeckli Скилл project-references для Claude Code ищет конвенции и реализации в локальном зеркале GitHub-репозиториев. Показывает примеры Helm-чартов, Kubernetes-конфигов, Docker Compose и CI/CD. CX Codex +1 6 300установок replicas-agent replicas-group Описывает фоновому агенту, что доступно в облачном воркспейсе Replicas: превью сервисов, Slack, Linear, GitHub, Google Docs, Docker и CLI replicas. CX Codex +1 36 700установок stack kitlangton Скилл stack для работы со стеками PR и MR там, где ветки вливаются squash-мержем и удаляются. Помогает чинить и синхронизировать цепочки изменений. CX Codex +1 482установок createos NodeOps-app Скилл учит агента выкладывать код в прод на облачной платформе CreateOS: агенты, API, боты, MCP-серверы, фронтенд. CX Codex +1 1 700установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой