👻 Poltergeist — «привидение», которое держит ваши сборки свежими

Дружелюбный призрак с гаечным ключом окружён иконками файлов, шестерёнок, чек-листов и экрана, символизируя Poltergeist — кроссплатформенный наблюдатель за файлами с авто-сборкой проектов.

В мире, где скорость обратной связи между изменением кода и результатом сборки решает половину успеха, Poltergeist выглядит как инструмент, который может понравиться и людям, и AI-агентам. Это универсальный наблюдатель за файлами с автоматическим пересбором проекта для любого языка и сборочной системы.

🚀 Ключевые особенности

• 💻 Кроссплатформенность — работает на macOS, Linux и Windows; доступен как бинарный или npm-пакет.
• 🔍 Автоопределение проекта — poltergeist init анализирует структуру (Swift, Node.js, Rust, Python, CMake и др.) и генерирует оптимальный poltergeist.config.json.
• ⚡ Мгновенный rebuild — при изменении файлов сборка стартует автоматически; дальнейшие правки сбрасывают предыдущую попытку и запускают новую.
• 🛡 Защита от пересечений — умная блокировка предотвращает одновременные конфликтующие сборки.
• 🔔 Нативные уведомления и inline-диагностика — статус и ошибки выводятся в реальном времени с подсказками по исправлению.
• 🤖 Дружественность к AI-агентам — команды polter ждут завершения сборки перед запуском, что идеально для автономных ботов.

🧠 Как это работает

Poltergeist использует Watchman от Facebook для отслеживания изменений и применяет несколько интересных приёмов:

• 📂 Smart Execution Wrapper — команда polter не запустит бинарник, пока сборка не завершится, исключая гонки между компиляцией и запуском.
• 🗂 Приоритизация задач — если у вас несколько проектов, будет собираться сначала тот, над которым вы активно работаете.
• 🔄 Автоматическая подстройка конфигурации — любые правки в poltergeist.config.json применяются без перезапуска демона.
• 📊 Управление состоянием — каждый проект запускается в отдельном процессе с собственным файлом состояния в /tmp/poltergeist/, что гарантирует изоляцию.

Архитектурная схема.

💡 Личный взгляд

Poltergeist — это тот «клей» в DevOps-процессе, который часто пишут на коленке для конкретной команды. Здесь же он:

• 📦 упакован в удобный CLI,
• 🛠 имеет встроенные best-practices,
• 🌐 подходит для любого стека.

Мне особенно нравится, что авторы думали про AI-интеграцию. В будущем, когда IDE-агенты будут стандартом, такой фоновой watcher позволит им моментально тестировать изменения без лишних запросов к человеку.

📚 Источники и ссылки:

• Poltergeist на GitHub
• Документация и примеры