Cat Factory
Home
  • Introduction
  • Core Concepts
  • Quick Start
  • Designing Your Board
  • Shared Services
  • Requirements
  • Running Pipelines
  • Recurring Pipelines
  • Pull Requests & Merging
  • Repositories
  • Issue & Document Sources
  • Budgets & Spend
  • Prompt Fragments
  • Deploy to Cloudflare
  • Deploy to Node.js
  • GitHub App
  • Configuration
  • Self-Hosted Runner Pools
  • Ephemeral Environments
  • Architecture
  • Integration Manifests
  • Packages & Repository Layout
GitHub
Home
  • Introduction
  • Core Concepts
  • Quick Start
  • Designing Your Board
  • Shared Services
  • Requirements
  • Running Pipelines
  • Recurring Pipelines
  • Pull Requests & Merging
  • Repositories
  • Issue & Document Sources
  • Budgets & Spend
  • Prompt Fragments
  • Deploy to Cloudflare
  • Deploy to Node.js
  • GitHub App
  • Configuration
  • Self-Hosted Runner Pools
  • Ephemeral Environments
  • Architecture
  • Integration Manifests
  • Packages & Repository Layout
GitHub

Cat Factory

A visual board, task management, and LLM coding agents in one place. Turn tasks into reviewed pull requests you can watch run end to end.

Get Started →Core Concepts

The board is the plan

Lay out services, modules, and tasks on a pannable, zoomable canvas. Every block is both your plan and a unit of work, so there's no separate backlog to keep in sync.

Agents do real work

Coding agents clone your repository, implement the task, and open a pull request. A block is "done" only when its PR is merged with passing CI.

Multi-stage pipelines

Compose ordered agent chains (Architect → Coder → Reviewer → Tester → Acceptance) with default models per agent kind and human decision points along the way.

Human in the loop

A reviewer agent flags open questions and risky assumptions before code is written. You answer the questions, approve the plan, and review every PR before merge.

Durable & observable

Runs are checkpointed, so they survive interruptions and resume where they left off. Watch each step, decision prompt, and failure as it happens.

Cost under control

Set an organization-wide monthly LLM budget. Spend is metered per run, runs pause at the cap, and resume automatically on the next billing period.

From board to merged PRs

Cat Factory is a self-hosted platform that turns a visual board of work into shipped code. You lay out the work visually; LLM agents pick up each block, implement it against a real repository checkout, and open pull requests for your team to review and merge. The board is also your central place to work: you can see every run as it happens and step in when an agent needs you.

You assemble a thin deployment project on top of the published @cat-factory/* packages, then deploy it:

# Deploy the backend to Cloudflare
wrangler d1 migrations apply <your-d1-database> --remote
pnpm deploy

# Build and publish the frontend
NUXT_PUBLIC_API_BASE=https://your-api-domain.com pnpm generate
pnpm deploy

Where to next?

  • New here? Start with the Introduction and Core Concepts.
  • Want it running? Follow the Quick Start or pick a deployment target under Deploy & Operate.
  • Daily driver? Jump into Designing Your Board and Running Pipelines.
  • Integrating your infra? See Integration Manifests and the Architecture reference.

A note on scope

This site documents how to deploy and use Cat Factory. For source code, issues, and contribution guidelines, head to the kibertoad/cat-factory repository.

MIT Licensed | Copyright © Cat Factory contributors