Factory Floor

Cos'è Factory Floor?

Factory Floor è un workspace di sviluppo nativo per macOS che permette di eseguire più “workstream” paralleli in un unico posto. Coordina git worktrees (branch e directory isolate), sessioni di Claude Code, terminali di sviluppo e navigazione dev-server—così puoi passare da un compito all'altro senza perdere lo stato locale.

L'app è progettata intorno all'isolamento: ogni workstream ha il proprio branch, terminale e sessione agente AI in esecuzione concorrente. Usa il terminale GPU-renderizzato di Ghostty e supporta automazione setup/esecuzione/teardown tramite un file di configurazione per progetto.

Caratteristiche Principali

• Workspace a finestra unica per progetti e workstream: visualizza terminali, sessioni AI e browser integrato insieme, invece di gestire app separate.
• Git Worktrees per workstream: ogni workstream usa il proprio branch e worktree, l'app supporta il passaggio di compiti senza stash; i file .env sono automaticamente symlinked.
• Integrazione Claude Code con persistenza sessione: le sessioni Claude Code mantengono un contesto persistente e possono essere riprese dopo riavvii dell'app usando ID sessione automatici.
• Persistenza basata su Tmux per sessioni agente: le sessioni agente sopravvivono ai riavvii dell'app tramite tmux su un socket dedicato per ridurre interruzioni nei workflow.
• Browser integrato con rilevamento porte automatico: il browser integrato rileva la porta su cui il tuo script di run inizia ad ascoltare e naviga automaticamente.
• Script lifecycle progetto tramite .factoryfloor.json: configura script setup, run e teardown per progetto; gli script si eseguono nella directory workstream usando la tua shell di login, tutti i campi opzionali.
• Variabili d'ambiente disponibili in ogni terminale e script: terminali e script ricevono variabili come nomi progetto/workstream, percorsi e FF_PORT deterministico.
• Integrazione GitHub tramite gh CLI: la vista progetto mostra info repo, apre PR e stato branch PR (potenziato da gh CLI).
• Navigazione keyboard-first e shortcut: shortcut disponibili per creare progetti/workstream, passare tra tab/workspace/progetti, archiviare workstream e aprire editor/terminali (inclusi opzioni esterne).

Come Usare Factory Floor

1. Installa Factory Floor: installalo con brew install --cask alltuner/tap/factoryfloor o scaricando la sorgente.
2. Aggiungi un progetto: trascina una directory nella sidebar o creane una nuova; Factory Floor rileva automaticamente repo git, tool installati e connessioni GitHub.
3. Crea un workstream: crea un workstream per generare un nuovo git worktree e branch, avviare una sessione Claude Code, aprire un terminale e aggiungere una tab browser.
4. Esegui il tuo dev server e preview: configura setup, run e (opzionalmente) teardown in un .factoryfloor.json alla radice del progetto; quando il comando run inizia ad ascoltare, il browser integrato apre la porta rilevata.
5. Passa tra compiti senza perdere contesto: spostati tra workstream; la persistenza tmux-based e gli ID sessione Claude Code mantengono il contesto anche dopo riavvii dell'app.

Casi d'Uso

• Lavoro parallelo su feature in un unico repo: crea workstream separati per compiti diversi, ognuno con branch, terminale, sessione Claude Code e tab browser mentre passi tra loro.
• Setup dipendenze scoped per compito: definisci uno script setup del progetto come npm install così le dipendenze si installano quando viene creato un worktree/workstream.
• Esecuzioni dev-server consistenti con porte deterministiche: usa la variabile d'ambiente FF_PORT nel tuo script run (es. PORT=$FF_PORT npm run dev) così ogni workstream usa la propria porta prevedibile.
• Pulizia automatica all'archiviazione: imposta uno script teardown (es. docker-compose down) per fermare container o pulire risorse quando un workstream viene archiviato.
• Riprendi debug AI-assistito tra sessioni: affidati agli ID sessione Claude Code persistenti e persistenza socket tmux per continuare il lavoro dopo riavvio dell'app.

FAQ

• Factory Floor è open source? Sì. Factory Floor è con licenza MIT e il codice sorgente è disponibile su GitHub.

• Come fa l'app ad aprire il mio dev server nel browser integrato? Quando avvii il progetto tramite script run di un workstream, Factory Floor usa il rilevamento porte automatico per determinare su quale porta il comando run sta ascoltando e naviga il browser integrato a quell'indirizzo.

• Dove configuro l'automazione setup/run/teardown? Aggiungi un file .factoryfloor.json nella radice del tuo progetto. Può includere comandi script setup, run e teardown; tutti i campi sono opzionali.

• Quali variabili d'ambiente sono disponibili per script e terminali? Ogni terminale workstream e script setup/run/teardown può usare variabili d'ambiente come FF_PROJECT, FF_WORKSTREAM, FF_PROJECT_DIR, FF_WORKTREE_DIR e FF_PORT.

• Factory Floor richiede tool GitHub per la vista GitHub? L'integrazione GitHub nella vista progetto è potenziata da gh CLI.

Alternative

• Terminal locale + tmux + workflow manuale git worktree: puoi approssimare lo stesso approccio sottostante (worktrees, persistenza tmux e monitoraggio dev-server) usando tool separati, ma non otterrai l'orchestrazione in un'unica finestra e il comportamento del browser integrato.
• Multi-root workspace integrati nell'IDE: gli IDE possono gestire più progetti e terminal, ma potrebbero non fornire l'isolamento esplicito dei git worktree per task con lo stesso ciclo di vita script-driven e flusso di rilevamento porte.
• Git branch-per-task con stashing: un approccio git più semplice può supportare il context switching, ma tipicamente si basa su stashing/pulizia anziché worktree isolati e ambienti task-scoped.