# upstash-box-cli

Скилл учит агента работать с Upstash Box: запускать команды, собирать проекты и отдавать публичную ссылку на результат.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 563 установки · ★ 34
- Автор: Upstash
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/upstash/skills/tree/HEAD/skills/upstash-box-cli/SKILL.md
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/skills/upstash-box-cli

## Что делает

\`box` управляет удалённым контейнером, а не вашей машиной. Локальные инструменты агента остаются локальными, всё, что должно произойти внутри бокса, идёт через `box`. Скилл описывает установку CLI, авторизацию и выбор бокса.

Каждой команде нужен API-ключ, иначе она падает с «API token required». Ключ задаётся один раз через `export UPSTASH_BOX_API_KEY=box_...` или передаётся флагом `--token` в отдельной команде. Бокс ищется по порядку: `--box <id>`, затем `$BOX_ID`, затем ближайший файл `.box` при поиске вверх по дереву. Из-за этого поиска вверх переход в другой проект может подхватить чужой пин и выполнить работу не в том боксе — если в сессии больше одного бокса, передавайте `--box` явно. `box status` показывает, какой бокс выбран и откуда он взялся.

Флаги `--keep-alive`, `--browser`, `--env` и `--size` выбираются только при создании, потом их не поменять: нужен новый бокс. Обычный `box create --no-repl` засыпает при простое и просыпается на следующей команде. `--keep-alive` нужен, когда что-то должно пережить паузу, например отделённый сервер под preview-URL, но такой бокс продолжает стоить денег, пока вы его не остановите или не удалите. Удалённая оболочка — `sh`, не bash, поэтому heredoc внутри `box exec` ломается с `Syntax error: redirection unexpected`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add upstash/skills --skill upstash-box-cli -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/upstash-box-cli/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/upstash-box-cli/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add upstash/skills --skill upstash-box-cli -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/upstash-box-cli/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add upstash/skills --skill upstash-box-cli -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/upstash-box-cli/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install upstash/skills upstash-box-cli
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/upstash-box-cli/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add upstash/skills --skill upstash-box-cli -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/upstash/skills --path skills/upstash-box-cli
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/upstash-box-cli/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add upstash/skills --skill upstash-box-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/upstash/skills/tree/HEAD/skills/upstash-box-cli/SKILL.md

## Когда брать
- запустить сборку и тесты в удалённом контейнере, не трогая локальную машину
- клонировать репозиторий и открыть pull request со скриншотом
- опубликовать публичный URL для запущенного в боксе сервера
- снять скриншот страницы через headless Chromium
- поставить повторяющуюся задачу или запустить ИИ-агента внутри бокса

## Примеры запросов агенту
- создай бокс с runtime node и прогони в нём npm test
- сделай скриншот страницы и приложи его к issue
- подними dev-сервер в боксе и дай публичную ссылку

## Похожие
- [upstash-redis-kv](https://affpapa.org/nevibecode/skills/upstash-redis-kv.md) — скилл · 469 установок
- [upstash-vector-db-skills](https://affpapa.org/nevibecode/skills/upstash-vector-db-skills.md) — скилл · 366 установок
- [upstash-redis](https://affpapa.org/nevibecode/skills/upstash-redis.md) — скилл · 7 установок
- [bailian-sandbox](https://affpapa.org/nevibecode/skills/bailian-sandbox.md) — скилл · 812 установок
- [docker-agent-run](https://affpapa.org/nevibecode/skills/docker-agent-run.md) — скилл · 746 установок
- [ae-system](https://affpapa.org/nevibecode/skills/ae-system.md) — скилл · 735 установок

Из того же набора: [upstash/skills](https://affpapa.org/nevibecode/by/upstash/skills.md) — 10 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md