Factoryfloor
AI-powered macOS development workspace. Git worktrees, Claude Code sessions, and dev servers in a single native app.
Install / Use
/learn @alltuner/FactoryfloorQuality Score
Category
Development & EngineeringSupported Platforms
README
Get Started
Install via Homebrew:
brew install --cask alltuner/tap/factoryfloor
Or download the latest release.
Then:
- Open Factory Floor and add a project by clicking the
+button in the sidebar, then selecting a repository directory. - Create a workstream with
Cmd+N. Factory Floor sets up a git worktree and launches a Claude Code agent automatically. - Start building. Add terminals (
Cmd+T), browsers (Cmd+B), or configure run scripts to auto-detect your dev server.
What is Factory Floor?
Factory Floor is a native macOS app built on Ghostty's GPU-rendered terminal. It manages multiple parallel development tasks, each in its own git worktree with a dedicated Claude Code agent, terminal, and browser.
One project, many workstreams, all at native speed.
Features
- Git Worktrees — Each workstream gets its own branch and worktree. Switch between tasks without stashing.
- Claude Code — Integrated AI agent with session persistence. Resume conversations across app restarts.
- Tmux Persistence — Agent sessions survive app restarts via tmux on a dedicated socket.
- Setup & Run Scripts — Configure setup, run, and teardown scripts per project via
.factoryfloor.json. Environment tab with split-pane terminals, Rebuild (⌃⇧R) and Start/Rerun (⌃⇧S). - Embedded Browser — WKWebView tab with automatic port detection. The browser navigates to the port your run script opens.
- GitHub Integration — Repo info, open PRs, and branch PR status via the
ghCLI. - Dynamic Tabs — Open as many terminals and browsers as you need. Close with Cmd+W or Ctrl+D.
- Update Notifications — Checks for new versions and shows a badge in the sidebar.
- Keyboard-first — Every action has a shortcut. Cmd+Return for agent, Cmd+I for info, Cmd+E for environment, Cmd+T for terminal, Cmd+B for browser.
Script Configuration
Add a .factoryfloor.json to your project root to automate your workstream lifecycle. All fields are optional.
{
"setup": "npm install",
"run": "PORT=$FF_PORT npm run dev",
"teardown": "docker-compose down"
}
| Hook | When it runs | Example use case |
|---|---|---|
| setup | Once, when a workstream is created | Install deps, copy .env, run build steps |
| run | On demand via the Environment tab | Start dev server, docker-compose up |
| teardown | When a workstream is archived | docker-compose down, clean temp files |
Scripts run in the workstream directory using your login shell. The run script is wrapped in the ff-run launcher for automatic port detection.
Environment Variables
Every workstream terminal has access to:
| Variable | Description |
|---|---|
| FF_PROJECT | Project name |
| FF_WORKSTREAM | Workstream name |
| FF_PROJECT_DIR | Main repository path |
| FF_WORKTREE_DIR | Worktree path for this workstream |
| FF_PORT | Deterministic port (40001-49999) |
Keyboard Shortcuts
Global
| Shortcut | Action |
|---|---|
| Cmd+N | New workstream or project |
| Cmd+Shift+N | New project |
| Cmd+, | Settings |
| Cmd+/ | Help |
Workstream
| Shortcut | Action |
|---|---|
| Cmd+Return | Focus Coding Agent |
| Cmd+I | Info panel |
| Cmd+E | Environment |
| Cmd+T | New Terminal |
| Cmd+B | New Browser |
| Cmd+W | Close tab |
| Cmd+L | Address bar (browser) |
| Cmd+0 | Back to project |
| Cmd+1-9 | Switch tab |
| Ctrl+1-9 | Switch workstream |
| Cmd+Shift+[ / ] | Cycle tabs |
| Cmd+Shift+O | External browser |
| Cmd+Shift+E | External terminal |
| Ctrl+Shift+R | Rebuild setup |
| Ctrl+Shift+S | Start/Rerun |
Supported Languages
English, Catalan, Spanish, Swedish.
Install
brew install --cask alltuner/tap/factoryfloor
Or download the latest release.
Upgrade
brew upgrade --cask factoryfloor
CLI
Homebrew automatically installs the ff command. If you installed via DMG, install the CLI from Settings > Environment.
Development
Requires: Xcode, XcodeGen (brew install xcodegen), Zig (brew install zig).
# First time: build the Ghostty terminal engine
cd ghostty && zig build -Demit-xcframework=true -Dxcframework-target=universal -Doptimize=ReleaseFast && cd ..
# Build
./scripts/dev.sh build
# Build and run
./scripts/dev.sh br
# Kill and relaunch
./scripts/dev.sh run
# Run with a specific directory
./scripts/dev.sh run ~/repos/myproject
# Run tests
./scripts/dev.sh test
# Clean
./scripts/dev.sh clean
# Release (sign, notarize, DMG)
./scripts/release.sh 0.1.0
See CLAUDE.md for development workflow, architecture, and conventions.
Website
The website lives in website/ and is built with Hugo + Tailwind CSS.
cd website && bun install && bun run dev
Localization
All strings are localized. To add a language:
- Copy
Localization/en.lprojtoLocalization/xx.lproj - Translate all values in
Localizable.strings - Add the path to
project.ymland runxcodegen generate
Credits
Factory Floor is built on the shoulders of these projects:
- Ghostty — GPU-accelerated terminal engine (Metal-rendered via libghostty)
- Claude Code — AI coding agent by Anthropic
- tmux — Terminal multiplexer for session persistence
- XcodeGen — Xcode project generation from
project.yml - cmark-gfm — GitHub Flavored Markdown rendering (via swift-cmark)
- Hugo + Tailwind CSS — Website
- Umami — Privacy-friendly website analytics
Support the project
Factory Floor is an open source project built by David Poblador i Garcia through All Tuner Labs.
If this project helped you ship faster, automate your workflow, or experiment with coding agents, consider supporting its development.
❤️ Sponsor development https://github.com/sponsors/alltuner
☕ One-time support https://buymeacoffee.com/alltuner
Your support helps fund the continued development of Factory Floor and other open source developer tools such as VibeTuner.
License
<p align="center"> Built by <a href="https://davidpoblador.com">David Poblador i Garcia</a> with the support of <a href="https://alltuner.com">All Tuner Labs</a>.<br> Made with ❤️ in Poblenou, Barcelona. </p>
