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

install-local — команда для Claude Code: что делает и как установить

Команда install-local собирает и ставит локальные версии расширений VS Code и spec-kit из репозитория speckit-companion, автоматически повышая patch-версию для сброса кэша.

MIT ★ 110 обновлён 2026-10-19

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/install-local.md
Открыть на GitHub

Что делает install-local

Скрипт автоматизирует переустановку двух компонентов репозитория speckit-companion: расширения VS Code (.vsix) и расширения spec-kit из папки apps/speckit-extension/. Чтобы редактор показал плашку перезагрузки и подхватил свежую сборку, команда находит максимальную версию среди ~/.vscode/extensions/ и файла package.json, после чего поднимает patch-номер на единицу выше обеих.

Затем выполняются npm run package и установка через code --install-extension speckit-companion-{version}.vsix --force. Временное изменение версии сразу же сбрасывается с помощью git restore package.json package-lock.json, поэтому рабочий коммит остаётся чистым. Вызов code --command workbench.action.reloadWindow в текущих сборках CLI не работает, из-за чего окно редактора придётся перезагрузить вручную через меню или баннер.

Если в проекте присутствует apps/speckit-extension/extension.yml, запускается specify extension add ./apps/speckit-extension --dev --force для обновления команд агента в .specify/extensions/companion/. Если утилита specify не найдена в системе или установлена из стандартного PyPI без поддержки подкоманды extension, этот этап пропускается с отчётом в консоли.

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

  • Собрать и принудительно установить локальный VSIX-пакет speckit-companion
  • Обойти кэширование расширений в VS Code при частых локальных тестах
  • Сгенерировать команды spec-kit в рабочих каталогах агента
  • Откатить временные изменения версий в git перед фиксацией правок

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

  • Запусти /install-local, чтобы обновить расширение
  • Собери и переустанови локальные пакеты через команду /install-local
  • Переустанови расширения speckit-companion для тестирования свежих правок

Как установить install-local

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

.claude/commands/install-local.md

Вызов — /install-local. Для всех проектов — ~/.claude/commands/

Вопросы об install-local

Как установить install-local в Claude Code?

Сохраните файл команды в каталоге проекта по пути .claude/commands/install-local.md.

Зачем команда поднимает номер версии перед упаковкой?

VS Code ориентируется на номер версии и не выводит баннер перезагрузки, если установленная версия совпадает или выше новой. Скрипт берёт максимальный номер из установленных и локального package.json, увеличивает patch на единицу, а после сборки сбрасывает git-дифф.

Что произойдёт, если утилита specify не установлена?

Команда установит расширение для VS Code, пропустит шаг с расширением spec-kit и выведет причину пропуска в финальном отчёте.

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

install-local.md · MIT
---
allowed-tools: Bash(npm version:*), Bash(npm run package:*), Bash(code --install-extension:*), Bash(code --command:*), Bash(specify extension:*)
description: Bump version and install both extensions locally (VS Code + spec-kit)
---

## Context

- Current version: !`node -p "require('./package.json').version"`

## Your task

This repo ships **two** extensions: the **VS Code extension** (`.vsix`) and the **spec-kit extension** (`apps/speckit-extension/` — the `/speckit.companion.*` commands + capture scripts). Reinstall both so local changes to either are picked up.

### 1. VS Code extension

1. Bump to one patch **above both the repo version AND the highest already-installed version**. Throwaway local installs accumulate in `~/.vscode/extensions/` at versions *above* the git baseline (each `/install-local` bump is restored in git but the installed `.vsix` stays), so a plain `npm version patch` from the baseline can produce a version ≤ what's installed → VS Code sees nothing newer and shows **no reload banner**. Compute a safe target instead:

   ```bash
   INSTALLED=$(ls -d ~/.vscode/extensions/alfredoperez.speckit-companion-* 2>/dev/null \
     | sed -E 's/.*-([0-9]+\.[0-9]+\.[0-9]+)$/\1/' | sort -V | tail -1)
   REPO=$(node -p "require('./package.json').version")
   BASE=$(printf '%s\n%s\n' "$INSTALLED" "$REPO" | sort -V | tail -1)
   NEXT=$(node -e "const [a,b,c]=process.argv[1].split('.').map(Number);console.log([a,b,c+1].join('.'))" "$BASE")
   npm version "$NEXT" --no-git-tag-version
   ```

2. Package the extension: `npm run package`
3. Install in VS Code: `code --install-extension speckit-companion-{version}.vsix --force`
4. Reload: the new-higher version makes VS Code surface a **"Restart Extensions / Reload"** banner. `code --command workbench.action.reloadWindow` is NOT a supported CLI flag in current builds (it warns and no-ops) — don't rely on it; tell the user to click the banner or run **Developer: Reload Window** if it doesn't appear.

**Important:** Never skip the version bump, and never bump *below* an installed version — VS Code caches by version number, so same-or-lower = no update and no banner. After installing, restore the throwaway bump in git (`git restore package.json package-lock.json`) so it never lands in a feature commit.

### 2. spec-kit extension (only if `apps/speckit-extension/extension.yml` exists)

5. Reinstall it so changed/new commands + scripts are re-emitted to the agent dirs:
   `specify extension add ./apps/speckit-extension --dev --force`
   - This regenerates `.specify/extensions/companion/` and the per-agent command emissions — all gitignored (source of truth is `apps/speckit-extension/`), so it produces no commit churn.
   - If `specify` isn't installed or lacks the `extension` subcommand (stock PyPI build), skip with a note — see `apps/speckit-extension/docs/install.md`.
6. Confirm the commands registered: `specify extension add` prints the provided commands; verify any you just changed (e.g. `speckit.companion.status` / `speckit.companion.resume`) appear.

### 3. Report

Report the new VS Code version installed **and** whether the spec-kit extension was reinstalled (with the command count), or why it was skipped.

© alfredoperez · MIT · alfredoperez/speckit-companion

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
install-atk microsoft Скилл install-atk для Claude Code и GitHub Copilot проверяет работу CLI M365 Agents Toolkit и ставит расширение для VS Code. Устанавливает или обновляет ATK в проекте по запросу. CX Codex +1 ★ 3 232звёзд репо vscode-ext-commands официальный github Скилл vscode-ext-commands подсказывает, как добавлять команды в расширения VS Code: задавать имена, видимость, локализацию и связанные параметры. CX Codex +1 9 000установок vscode-extension-dev-typescript-cursorrules-prompt-file PatrickJS Правило vscode-extension-dev-typescript-cursorrules-prompt-file для Cursor задаёт рекомендации по разработке расширений VSCode на TypeScript. Оно охватывает архитектуру, API редактора, безопасность и тесты. CX Codex +1 ★ 41 178звёзд репо npm-git-install akillness Скилл npm-git-install для Claude Code выбирает безопасный способ поставить Node-пакет из ветки, коммита, форка или приватного репозитория. Закрывает выбор между Git-мостом, tarball и публикацией в реестр. CX Codex +1 351установок bootstrap-v6-install twbs Скилл bootstrap-v6-install для Claude Code и Cursor подключает Bootstrap 6 через CDN или пакетный менеджер. Скрипт настраивает Sass, JavaScript и пути для локальной разработки. CX Codex +1 677установок install-loop Cobus Greyling Скилл install-loop для Claude Code устанавливает Loop Engineering в проект через единую CLI-команду. Он выбирает шаблон цикла по проблеме и оставляет запуск в режиме отчётов на первую неделю. CX Codex +1 ★ 11 819звёзд репо

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

Весь набор →
speckit.companion.status Команда speckit.companion.status для Claude Code и Codex показывает шаг, статус, решения и следующее действие активной спеки из .spec-context.json. Она работает только на чтение. CX Codex +1 ★ 110звёзд репо speckit.plan Промпт speckit.plan запускает процесс планирования реализации по спецификации: собирает research.md, data-model.md и схемы API в папку contracts/. CX Codex GP ChatGPT ★ 110звёзд репо sandbox Команда sandbox создаёт временный SpecKit-проект по рецепту или показывает доступные рецепты и уже созданные песочницы. Работает в Claude Code и Codex. CX Codex +1 ★ 110звёзд репо release-qa Команда release-qa для Claude Code проверяет код перед выпуском: сравнивает его с последним тегом версии, запускает тесты и ручные проверки, пишет отчёт с вердиктом ship или fix-first. Блокирует /publish до прохождения проверок. CX Codex +1 ★ 110звёзд репо speckit.companion.living-drift Команда speckit.companion.living-drift показывает, какие файлы возможностей living spec изменились с момента последнего коммита их спецификаций. Помогает найти изменения, которые не попали обратно в спецификацию. CX Codex +1 ★ 110звёзд репо speckit.companion.resume Команда speckit.companion.resume для Claude Code восстанавливает состояние spec-driven разработки после перерыва. Она переносит записанные решения в контекст и запускает следующий шаг пайплайна. CX Codex +1 ★ 110звёзд репо speckit.git.commit Команда speckit.git.commit для Claude Code добавляет изменения в индекс Git и создаёт коммит после команд Spec Kit по настройкам конфигурации проекта. CX Codex +1 ★ 110звёзд репо speckit-git-commit Скилл speckit-git-commit автоматически добавляет и коммитит изменения после команд Spec Kit. Он пригодится, когда историю Git нужно обновлять через настройки проекта. CX Codex +1 ★ 110звёзд репо

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

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