JSPM

Workspace-based coding environment for running multiple Claude Code sessions in parallel.

Each workspace gets its own isolated git worktree, enabling true parallel development.

Installation

Prerequisites:

• Node.js 18+
• pnpm
• GitHub CLI (gh) - authenticated
• Claude Code - authenticated via claude login

# Clone and install
git clone https://github.com/purplefish-ai/factory-factory.git
cd factory-factory
pnpm install

# Option A: Install CLI globally from source
pnpm link --global

# Option B: Install from npm (when published)
npm install -g factory-factory

Running

Web App

# Using pnpm (recommended for development)
pnpm dev

# Or using the CLI directly (if installed globally)
ff serve --dev

The server automatically:

• Creates the data directory (~/factory-factory/)
• Runs database migrations
• Finds available ports if defaults are in use
• Opens your browser when ready

Desktop App (Electron)

# Development with hot reload
pnpm dev:electron

# Build distributable
pnpm build:electron

The Electron app stores data in the standard location for your OS:

• macOS: ~/Library/Application Support/Factory Factory/
• Windows: %APPDATA%/Factory Factory/
• Linux: ~/.config/Factory Factory/

CLI Reference

Usage: ff serve [options]

Options:
  -p, --port <port>           Frontend port (default: 3000)
  --backend-port <port>       Backend port (default: 3001)
  -d, --database-path <path>  SQLite database path (default: ~/factory-factory/data.db)
  --host <host>               Host to bind to (default: localhost)
  --dev                       Development mode with hot reloading
  --no-open                   Don't open browser automatically
  -v, --verbose               Enable verbose logging

Other CLI commands:

ff build        # Build for production
ff db:migrate   # Run database migrations
ff db:studio    # Open Prisma Studio

Development Commands

# Server
pnpm dev              # Start dev server
pnpm dev --no-open    # Without browser auto-open
pnpm dev --verbose    # With detailed logging
pnpm build            # Build for production
pnpm start            # Start production server

# Electron
pnpm dev:electron     # Start Electron with hot reload
pnpm build:electron   # Build distributable package

# Quality
pnpm test             # Run tests
pnpm typecheck        # TypeScript checking
pnpm check:fix        # Lint + format

# Database
pnpm db:migrate       # Run migrations
pnpm db:studio        # Prisma Studio
pnpm db:generate      # Regenerate Prisma client

Architecture

Project (repository configuration)
    └── Workspace (isolated git worktree)
            ├── ClaudeSession (chat with Claude Code)
            └── TerminalSession (PTY terminal)

Key features:

• Isolated workspaces: Each workspace gets its own git worktree and branch
• Real-time chat: WebSocket-based streaming from Claude Code CLI
• Terminal access: Full PTY terminals per workspace
• Session persistence: Resume previous Claude sessions

Brand

Typography:

• Inter Black - Headlines and logotype
• IBM Plex Mono SemiBold - Code and app icon

Troubleshooting

GitHub CLI:

gh auth status
gh auth login

Database issues:

pnpm db:migrate                  # Run migrations
pnpm exec prisma migrate reset   # Reset database (destroys data)

Port conflicts: The server automatically finds available ports. Use --verbose to see which ports are used.

Acknowledgements

This project was inspired by:

• Conductor - Mac app for running coding agents in parallel
• VibeKanban - Visual kanban for AI-assisted development
• Gastown - Steve Yegge's multi-agent coding environment
• Multiclaude - Dan Lorenc's parallel Claude sessions tool

License

MIT