@whenlabs/when

Шесть инструментов. Одна установка.

Единый устанавливаемый набор инструментов, который добавляет шесть инструментов WhenLabs в ваш рабочий процесс Claude Code / ИИ-агента для кодинга. После установки все инструменты становятся доступны как MCP-инструменты в каждой сессии — Claude использует их автоматически, когда это необходимо.

Пять инструментов (stale, envalid, berth, aware, vow) имеют режимы сканирования через CLI и запускаются по расписанию. Velocity — шестой инструмент — работает постоянно и встроен в систему (на базе SQLite), поэтому у него нет режима сканирования через CLI, и он не отображается в выводе doctor/watch/init/ci.

Установка

npx @whenlabs/when install

Это разовая настройка. После установки все шесть инструментов будут доступны в каждом проекте, который вы открываете с помощью Claude Code.

Что это делает

Запуск npx @whenlabs/when install выполнит следующее:

Зарегистрирует единый MCP-сервер (whenlabs) в вашей конфигурации Claude Code — все шесть инструментов, включая velocity, обслуживаются одним сервером.
Внедрит инструкции CLAUDE.md, чтобы Claude знал, когда автоматически использовать каждый инструмент, и отдавал им предпочтение перед командами оболочки.
Очистит любые устаревшие регистрации velocity-mcp (velocity теперь входит в комплект).

После подключения Claude может вызывать любой инструмент напрямую, без вашего запроса. Например, после рефакторинга Claude может запустить stale_scan для проверки расхождений в документации, или перед релизом — vow_check для проверки лицензий.

Проактивное фоновое сканирование

Инструменты автоматически запускаются в фоновом режиме по расписанию и сообщают о результатах в строке состояния Claude Code:

Инструмент	Интервал	Строка состояния
berth	15 мин	`ports:N` — найдены конфликты портов
stale	30 мин	`stale:N` — документация разошлась с кодом
envalid	30 мин	`env:N` — проблемы проверки .env
vow	60 мин	`lic:N?` — найдены неизвестные лицензии
aware	60 мин	`aware:stale` — файлы контекста ИИ устарели

Отображаются только проблемы — если всё в порядке, строка состояния остается чистой. Когда Claude видит проблему в строке состояния, он проактивно сообщает вам об этом и предлагает исправить её.

MCP-инструменты

Эти инструменты доступны Claude в каждой сессии после установки:

MCP-инструмент	Что он делает
`velocity_start_task`	Начать отсчет времени задачи
`velocity_end_task`	Завершить отсчет и записать результаты
`velocity_estimate`	Оценить время для запланированной задачи
`velocity_stats`	Показать сводную статистику производительности с аналитикой
`velocity_history`	Показать историю задач
`stale_scan`	Обнаружить расхождения в документации
`stale_fix`	Автоматически исправить расхождения (неверные пути, битые ссылки, фантомные переменные окружения)
`stale_auto_fix`	Сканирование + автоисправление расхождений за один вызов
`envalid_validate`	Проверить файлы .env на соответствие схемам
`envalid_detect`	Найти недокументированные переменные окружения в кодовой базе
`envalid_generate_schema`	Сгенерировать .env.schema на основе анализа кода
`envalid_auto_fix`	Обнаружить недокументированные переменные + автогенерация записей схемы
`berth_status`	Показать активные порты и конфликты
`berth_check`	Сканировать проект на наличие конфликтов портов
`berth_resolve`	Автоматически разрешить конфликты портов (завершить процесс или переназначить)
`berth_auto_resolve`	Проверка + авторазрешение конфликтов за один вызов
`aware_init`	Автоопределение стека, генерация файлов контекста ИИ
`aware_doctor`	Диагностика состояния проекта и проблем конфигурации
`aware_auto_sync`	Диагностика + автосинхронизация устаревших файлов контекста ИИ
`vow_scan`	Сканирование и сводка лицензий зависимостей
`vow_check`	Проверка лицензий на соответствие политике
`vow_hook_install`	Установка хука pre-commit для проверки лицензий

В этой таблице показаны основные инструменты. Запустите when <tool> --help для получения списка всех доступных команд для каждого инструмента.

Интеллектуальное взаимодействие между инструментами

Инструменты автоматически предлагают последующие действия, когда обнаруживают проблемы, связанные с другими инструментами. Например, aware_init запускает stale_scan при генерации новых файлов, а envalid_detect предлагает berth_register при обнаружении переменных окружения с URL-адресами сервисов. Эти каскадные предложения отображаются как строки "Tip:" в выводе инструмента.

Поддержка нескольких редакторов

Устанавливайте MCP-серверы в другие редакторы вместе с Claude Code:

npx @whenlabs/when install --cursor     # Cursor
npx @whenlabs/when install --vscode     # VS Code
npx @whenlabs/when install --windsurf   # Windsurf
npx @whenlabs/when install --all        # All supported editors

Без флагов install нацелен только на Claude Code.

Использование CLI

Вы также можете запускать инструменты напрямую из командной строки:

when init            # Onboard a project — bootstrap configs, run all tools, auto-fix
when config          # Show unified .whenlabs.yml config
when config init     # Generate .whenlabs.yml from existing tool configs
when config validate # Validate config structure
when stale scan
when stale fix       # Auto-fix documentation drift
when envalid validate
when envalid detect --generate  # Generate schema from code
when berth status
when berth resolve   # Auto-resolve port conflicts
when aware init
when vow scan
when vow hook install  # Install pre-commit license hook
when status          # Show installation status
when doctor          # Run all tools, show unified health report
when doctor --watch  # Continuous monitoring dashboard
when watch           # Background daemon for status line
when ci              # Run checks for CI (exits 1 on issues)

`when init`

Одна команда для полной настройки любого проекта:

Bootstrap — создает .env.schema, .vow.json, .stale.yml и регистрирует порты berth на основе вашего проекта
Scan — запускает все 5 CLI-инструментов параллельно
Auto-fix — автоматически исправляет расхождения stale, если они обнаружены
Config — генерирует единый .whenlabs.yml из настроенных конфигураций

`when config`

Управление единой конфигурацией проекта .whenlabs.yml. Все шесть инструментов считывают свои настройки из этого файла вместо отдельных конфигурационных файлов. Подкоманды: init (генерация из существующих конфигураций), validate (проверка структуры).

`when doctor`

Запускает все 5 CLI-инструментов для текущего проекта и отображает единый отчет о состоянии. Поддерживает --json для машиночитаемого вывода и --watch для непрерывного мониторинга с живой панелью управления.

`when watch`

Фоновый демон, который запускает все 5 CLI-инструментов через интервалы и записывает результаты в ~/.whenlabs/status.json. Обеспечивает работу интеграции со строкой состояния Claude Code. Используйте --once для однократного сканирования или --interval <seconds> для настройки расписания.

`when ci`

Запускает проверки stale, envalid и vow — завершается с кодом 1, если какой-либо инструмент обнаруживает проблемы. Предназначено для CI-конвейеров:

when ci --ci         # GitHub Actions annotations (::error file=X::message)
when ci --json       # Machine-readable JSON output

GitHub Action

- uses: WhenLabs-org/when@main
  with:
    checks: stale,envalid,vow

Удаление

npx @whenlabs/when uninstall

Удаляет MCP-сервер и очищает инструкции CLAUDE.md.

Лицензия

MIT — см. LICENSE

Создано Siddharth в WhenLabs

WhenLabs/When