# capgo-live-updates

Помогает подключить и отладить живые обновления Capgo в приложении на Capacitor: первый бандл, режимы autoUpdate, откаты.

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

## Что делает

Скилл ведёт через установку `@capgo/capacitor-updater` в проект на Capacitor, настройку `plugins.CapacitorUpdater` в `capacitor.config.*` и вызов `notifyAppReady()` в точке входа. Внутри — справочники по конфигурации, JS API, каналам и раскаткам, CI/CD и разбору ошибок; каждый подгружается, только когда тема в игре.

Главная ловушка — версии. Мажор апдейтера следует за мажором Capacitor: для 8.x ставят `@capgo/capacitor-updater@latest`, для 7.x — тег `lts-v7`. Пакет `@capgo/capacitor-updater@9.0.0` на npm — старый релиз под Capacitor 5, помеченный deprecated, и для Capacitor 9 он не подходит. Это повод проверить теги через `npm view @capgo/capacitor-updater dist-tags`, прежде чем что-то советовать.

\`notifyAppReady()` вызывается в самом начале файла входа, до сетевых запросов. Если он не сработал за `appReadyTimeout` (по умолчанию 10000 мс), бандл считается сломанным и возвращается предыдущий. Скилл просит не вставлять API-ключи Capgo и пароли подписи в чат: вход делают через `npx @capgo/cli@latest login` или переменную `CAPGO_TOKEN`. Команды, меняющие удалённое состояние, выполняются только после подтверждения.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capgo-live-updates -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capgo-live-updates -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capgo-live-updates -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Cap-go/capgo-skills capgo-live-updates
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capgo-live-updates -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Cap-go/capgo-skills --path skills/capgo-live-updates
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capgo-live-updates -a opencode
```

### Claude.ai

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

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

## Когда брать
- выпустить хотфикс веб-слоя без ревью в сторе
- выбрать режим autoUpdate и настроить его в capacitor.config
- добавить notifyAppReady, чтобы бандл не откатился
- разобрать код ошибки вроде no_new_version_available или on_premise_app
- собрать ручной поток download/next/set и переключение каналов

## Примеры запросов агенту
- Подключи Capgo live updates к моему Capacitor-проекту
- Почему обновление не применяется и устройство откатывается?
- Настрой ручной поток download и next для апдейтера

## Похожие
- [capgo-cloud-migration](https://affpapa.org/nevibecode/skills/capgo-cloud-migration.md) — скилл · 409 установок
- [capawesome-cloud](https://affpapa.org/nevibecode/skills/capawesome-cloud.md) — скилл · 840 установок
- [ionic](https://affpapa.org/nevibecode/skills/ionic.md) — скилл · 797 установок
- [handbook-updates](https://affpapa.org/nevibecode/skills/handbook-updates.md) — скилл · 597 установок
- [firebase-crashlytics](https://affpapa.org/nevibecode/skills/firebase-crashlytics.md) — скилл · 131700 установок
- [replica-deploy](https://affpapa.org/nevibecode/skills/replica-deploy.md) — скилл · 616 установок

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

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

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