Pilot Shell

Сделай Claude Code production-ready.

От требования до production-grade кода — спланированного, протестированного, проверенного. Spec-driven планы. Принудительные quality gates. Постоянная база знаний.

curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

macOS · Linux · Windows (WSL2) — установка менее чем за 2 минуты.

Зачем нужен Pilot Shell

Claude Code пишет код быстро — но без структуры пропускает тесты, теряет контекст и выдаёт непоследовательные результаты. Другие фреймворки добавляют сложность (десятки агентов, тысячи строк конфигурации), не давая ощутимо лучшего результата.

Pilot Shell устроен иначе. Каждый компонент решает конкретную проблему:

• /spec — планирует, реализует и верифицирует фичи end-to-end с TDD
• /prd — превращает размытые идеи в чёткие требования с опциональным глубоким исследованием
• Quality hooks — принудительно применяют линтинг, форматирование, проверку типов и тесты как gates (не рекомендации)
• Context engineering — сохраняет решения и знания между сессиями
• Code intelligence — семантический поиск (Probe) + граф знаний кода (CodeGraph)
• Оптимизация токенов — снижение стоимости на 60–90% через RTK и context-mode
• Расширения — переиспользуемые правила, скиллы и MCP-серверы с командным шарингом и кастомизацией
• Консоль — локальный веб-дашборд с уведомлениями в реальном времени и управлением сессиями
• Pilot Bot — постоянный агент автоматизации с планировщиком задач и фоновыми джобами

Запусти pilot для Spec-Driven Development с /spec или pilot bot для круглосуточных автоматизаций.

Предварительные требования

Claude Code: Установи Claude Code через нативный установщик до настройки Pilot Shell. Если у тебя установлена версия через npm или brew — сначала удали её. Если установка Claude Code не обнаружена, установщик Pilot попытается выполнить её автоматически.

Подписка Claude: Разработчикам-одиночкам подойдёт Max 5x для умеренного использования или Max 20x для интенсивного. Командам рекомендуется Team Premium (6.25x использования на участника, SSO, инструменты администратора, управление биллингом). Компаниям с повышенными требованиями к соответствию или закупкам — Enterprise (оплата по API за использование).

Терминал (рекомендуется): cmux отлично работает с Pilot Shell — вертикальная раскладка вкладок позволяет запускать несколько сессий рядом. Подойдёт любой современный терминал: Ghostty, iTerm2 или встроенный терминал macOS/Linux.

Claude Chrome (рекомендуется): Установи расширение Claude Code для Chrome для автоматизации браузера и E2E-тестирования. Pilot автоматически обнаруживает его и использует как предпочтительный инструмент. При отсутствии расширения Pilot переключается на Chrome DevTools MCP (прямой CDP-доступ, Lighthouse, трассировка производительности), затем на playwright-cli (постоянные сессии, трассировка) или agent-browser (лёгкий, быстрый старт).

Codex Plugin (включён): Codex plugin устанавливается автоматически вместе с Pilot. Обеспечивает adversarial code review на базе OpenAI Codex — независимое второе мнение в процессе планирования и верификации /spec. Выполни /codex:setup один раз для аутентификации, затем включи ревьюеров в Console Settings → Reviewers. Подписка ChatGPT Plus ($20/мес) покрывает использование Codex API.

Установка

Работает с любым существующим проектом. Pilot Shell устанавливается поверх Claude Code и использует его встроенные концепции — команды, правила, хуки, скиллы, субагенты, MCP, LSP и оптимизированные настройки — для улучшения рабочего процесса:

curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

Устанавливается глобально на macOS, Linux и Windows (WSL2). Все инструменты и правила размещаются в ~/.pilot/ и ~/.claude/. После установки перейди в любой проект и запусти pilot или ccp.

Если в последней версии обнаружена проблема или неисправленный баг, можно вернуться к предыдущей версии (см. releases):

export VERSION=8.2.4
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

Удаляет бинарник Pilot, файлы плагина, управляемые команды/правила, настройки и алиасы оболочки:

curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/uninstall.sh | bash

Pilot Shell работает внутри Dev Container — подробнее в документации.