live-runner

name	live-runner
description	Запуск скриптов, серверов, тестов, билдов на лету. Реалтайм-мониторинг, точечная остановка процессов, отладка по ходу выполнения. Триггеры: «запусти», «прогони», «проверь», «почини», «останови», «посмотри логи», «на ходу», «реалтайм», «realtime», «на лету», «мониторь», «отслеживай», «проверяй в процессе».

Live Runner — запуск и управление процессами на лету

Контекст

ИИ не ждёт. Запускает скрипты/серверы/тесты/билды сразу. Мониторит вывод в реальном времени. Ловит ошибки, чинит, перезапускает. Точечно останавливает процессы по PID/имени.

Алгоритм

1. Запуск

• run_shell_command — нужный скрипт/команда
• is_background: true — серверы, watchers, долгие процессы
• is_background: false — одноразовые команды (тесты, линтеры, билды)
• timeout — явно указывай для долгих операций

2. Мониторинг

• Читай вывод по ходу, не после завершения
• Отслеживай: ошибки, порты, утечки памяти, краши, зависания
• При background-процессах — периодически проверяй статус

3. Остановка

• kill <PID> — конкретный процесс по PID
• pkill -f <pattern> — по имени/паттерну
• tmux kill-pane / kill-session — при tmux-воркерах
• НЕ убивай всё подряд — точечно

4. Отладка на лету

1. Ошибка → читай логи
2. Диагноз → находишь причину
3. Фикс → правишь код/конфиг
4. Перезапуск → повторяешь проверку
5. Цикл до успеха

5. Прогон тестов/линтеров/билдов

• Всегда после изменений
• Упал тест → фикс → rerun
• Не пропускай, не надейся «на глаз»

6. Фиксация паттернов

Успешно отладил процесс? → запиши в скилл:

• Как запускать X
• Что мониторить
• Как останавливать
• Типичные баги и их фиксы

Триггеры

«запусти», «прогони», «проверь», «почини», «останови», «посмотри логи», «на ходу», «реалтайм», «realtime», «на лету», «мониторь», «отслеживай», «проверяй в процессе»

Примеры

✅ Правильно:

run_shell_command: "npm run dev", is_background: true
→ мониторю вывод
→ вижу ошибку порта 3000
→ kill PID, меняю порт, перезапуск
→ проверка — работает

❌ Неправильно:

run_shell_command: "npm run dev", is_background: true
→ жду 5 минут
→ «сервер запущен» (не проверил вывод, он упал)

Ссылки

• AGENTS.md правило #18