Factory Floor

Что такое Factory Floor?

Factory Floor — нативное приложение для macOS, которое позволяет запускать несколько параллельных «потоков работ» в одном месте. Оно координирует git worktrees (ветки и изолированные директории), сессии Claude Code, терминалы разработки и просмотр dev-серверов — чтобы вы могли переключаться между задачами, не теряя локальное состояние.

Приложение построено вокруг изоляции: каждый поток работ получает свою ветку, терминал и сессию ИИ-агента, работающие параллельно. Оно использует GPU-терминал Ghostty и поддерживает автоматизацию setup/run/teardown через файл конфигурации для каждого проекта.

Ключевые возможности

• Единое окно для проектов и потоков работ: просматривайте терминалы, сессии ИИ и встроенный браузер вместе, вместо переключения между отдельными приложениями.
• Git Worktrees для каждого потока работ: каждый поток использует свою ветку и worktree, приложение поддерживает переключение задач без stashing; файлы .env автоматически связываются символическими ссылками.
• Интеграция Claude Code с сохранением сессий: сессии Claude Code сохраняют постоянный контекст и могут быть возобновлены после перезапуска приложения с помощью автоматических ID сессий.
• Tmux-персистентность для сессий агентов: сессии агентов переживают перезапуски приложения через tmux на выделенном сокете, чтобы минимизировать прерывания workflow.
• Встроенный браузер с автоопределением порта: встроенный браузер определяет порт, на котором начинает слушать скрипт запуска, и автоматически переходит на него.
• Скрипты жизненного цикла проекта через .factoryfloor.json: настраивайте скрипты setup, run и teardown для каждого проекта; скрипты выполняются в директории потока работ с использованием вашей login shell, все поля опциональны.
• Переменные окружения в каждом терминале и скрипте: терминалы и скрипты получают переменные, такие как имена проекта/потока работ, пути и детерминированный FF_PORT.
• Интеграция с GitHub через gh CLI: в представлении проекта можно показывать информацию о репозитории, открывать PR и статус веток PR (на базе gh CLI).
• Навигация и горячие клавиши в первую очередь: доступны сочетания для создания проектов/потоков работ, переключения вкладок/рабочих пространств/проектов, архивирования потоков и открытия редакторов/терминалов (включая внешние).

Как использовать Factory Floor

1. Установите Factory Floor: установите через brew install --cask alltuner/tap/factoryfloor или скачав исходники.
2. Добавьте проект: перетащите директорию в боковую панель или создайте новую; Factory Floor автоматически определяет git-репозитории, установленные инструменты и подключения к GitHub.
3. Создайте поток работ: создайте поток для генерации новой git worktree и ветки, запуска сессии Claude Code, открытия терминала и добавления вкладки браузера.
4. Запустите dev-сервер и предпросмотр: настройте setup, run и (опционально) teardown в .factoryfloor.json в корне проекта; когда команда run начинает слушать, встроенный браузер открывает обнаруженный порт.
5. Переключайтесь между задачами без потери контекста: перемещайтесь между потоками работ; tmux-персистентность и ID сессий Claude Code сохраняют контекст при перезапусках приложения.

Сценарии использования

• Параллельная работа над фичами в одном репо: создавайте отдельные потоки работ для разных задач, чтобы каждый имел свою ветку, терминал, сессию Claude Code и вкладку браузера при переключении между ними.
• Настройка зависимостей в рамках задачи: определите скрипт setup проекта, например npm install, чтобы зависимости устанавливались при создании worktree/потока работ.
• Стабильные запуски dev-сервера с предсказуемыми портами: используйте переменную FF_PORT в скрипте run (например, PORT=$FF_PORT npm run dev), чтобы каждый поток работ использовал свой предсказуемый порт.
• Автоматическая очистка при архивировании: настройте скрипт teardown (например, docker-compose down) для остановки контейнеров или очистки ресурсов при архивировании потока работ.
• Возобновление ИИ-отладки между сессиями: полагайтесь на сохраненные ID сессий Claude Code и персистентность tmux-сокета, чтобы продолжить работу после перезапуска приложения.

Часто задаваемые вопросы

• Factory Floor с открытым исходным кодом? Да. Factory Floor лицензировано по MIT, исходный код доступен на GitHub.

• Как приложение открывает мой dev-сервер во встроенном браузере? При запуске проекта через скрипт потока работ Factory Floor использует автоопределение порта, чтобы узнать, на каком порту слушает команда run, и переходит во встроенном браузере на этот адрес.

• Где настроить автоматизацию setup/run/teardown? Добавьте файл .factoryfloor.json в корень проекта. Он может включать команды скриптов setup, run и teardown; все поля опциональны.

• Какие переменные окружения доступны скриптам и терминалам? Каждый терминал потока работ и скрипты setup/run/teardown могут использовать переменные вроде FF_PROJECT, FF_WORKSTREAM, FF_PROJECT_DIR, FF_WORKTREE_DIR и FF_PORT.

• Требует ли Factory Floor инструменты GitHub для просмотра GitHub? Интеграция с GitHub в представлении проекта работает на базе gh CLI.

Альтернативы

• Локальный терминал + tmux + ручной git worktree workflow: можно приблизить тот же базовый подход (worktrees, постоянство tmux и мониторинг dev-серверов) с помощью отдельных инструментов, но без оркестрации в одном окне и встроенного браузера.
• Многоroot-рабочие пространства в IDE: IDE могут управлять несколькими проектами и терминалами, но не обеспечивают явную изоляцию git worktree по задачам с таким же скриптовым жизненным циклом и обнаружением портов.
• Git ветка-на-задачу со стэкингом: более простой подход git поддерживает переключение контекста, но обычно полагается на стэкинг/очистку вместо изолированных worktrees и окружений, ограниченных задачей.