Point at a ticket. Get a pull request.A single model writes bad code and approves its own bad code. WorkerMill separates planning, coding, and review — each with a different model, different strengths, different blind spots.

Website ·

Docs · Discussions · npm

Get Started

npx workermill

No API key required — select Ollama during setup to run fully local. Or bring your own keys for Anthropic, OpenAI, Google, LM Studio, or any OpenAI-compatible provider. Setup takes 60 seconds.

Point at a ticket. Get a pull request.

Point WorkerMill at your GitHub Issues, Jira, or Linear tickets. It plans the work, assigns specialist AI personas — backend, frontend, devops, security — writes the code, runs your tests, reviews with a separate model, and opens a PR.

> /ship #42

coordinator Fetched #42: Add product export to CSV

planner Reading codebase... 38 files analyzed planner 2 stories: [backend_developer] CSV export endpoint with filters, auth, tests [frontend_developer] Export button on Products page

backend_developer Created src/routers/products.py export endpoint backend_developer Created tests/test_products.py — 4 new tests frontend_developer Created frontend/src/pages/ProductsPage.tsx — Export CSV button

tech_lead Reviewing against original spec... tech_lead Score: 5/10 — N+1 database query, JSX parsing error tech_lead Revision needed

backend_developer Fixed N+1 with selectinload, updated tests frontend_developer Fixed JSX structure, verified build

tech_lead Score: 8/10 — approved

system Branch: workermill/add-product-export (4 commits) Push and open PR? (y/n) Cost: ~$2.50 (planner + reviewer only — workers ran locally for free)`

The reviewer caught a real N+1 database query. The workers fixed it. The re-review passed. No human intervention. That's the difference between one model approving its own work and a team with independent review.

Works with GitHub Issues (/ship #42), Jira (/ship PROJ-123), Linear (/ship TEAM-42), spec files (/ship spec.md), or just a description (/ship add dark mode).

Review didn't pass? /retry picks up where you left off

> /retry

coordinator Retrying on branch: workermill/user-auth — 2 done, 1 remaining coordinator Story 1/1: [backend_developer] Auth service

backend_developer Modified src/routes/auth.ts — cookie-based token, blacklist on /logout backend_developer Modified src/middleware/requireAuth.ts — read token from cookie backend_developer Running quality gates... vitest ✓ (23 passed)

tech_lead Score: 9/10 — approved`

/retry doesn't start over. It loads the existing plan from disk, skips planning entirely, and resumes from the first incomplete story. No wasted tokens replanning or rebuilding what already works.

Review your code. Fix what it finds.

/review runs a standalone Tech Lead review on your current work. If it finds issues, WorkerMill offers to create a GitHub issue with the findings and immediately kicks off /ship to fix them.

> /review branch

tech_lead Reading diff against main... 14 files changed tech_lead Score: 6/10 tech_lead Issues:

1. API key passed as query parameter — use headers
2. No input validation on POST /api/webhooks
3. Error responses leak stack traces in production

Create a GitHub issue with these findings and fix them? (y/n) y

coordinator Created issue #18 — starting fix...`

Works with branch (full diff vs main), diff (uncommitted changes), or a PR number (/review #42).

Target a single expert

/as sends one specialist with full tool access — no planning step, no review loop.

/as security_engineer audit this repository for injection and broken auth /as backend_developer add pagination to the /api/tasks endpoint /as devops_engineer set up a GitHub Actions CI pipeline /as qa_engineer write integration tests for the checkout flow

/as security_engineer audit this repository for injection and broken auth /as backend_developer add pagination to the /api/tasks endpoint /as devops_engineer set up a GitHub Actions CI pipeline /as qa_engineer write integration tests for the checkout flow

Or just chat

Ask it to fix a bug, explain a function, or refactor a module. It reads your code, makes changes, runs your tests.

How It Works

Unlike single-model tools, WorkerMill never lets the same model review its own code.

• A planner reads your codebase and decomposes the task into scoped stories with specific files and implementation guidance.

• Specialist workers build one story at a time — a backend expert writes the API, a frontend expert wires the UI. Workers run locally via Ollama (free) or on any cloud provider.

• A reviewer on a different model reads the actual diffs against the original spec. It rejects bad work with specific feedback — including real code examples — until the code meets the standard.

{  "providers": {  "ollama": { "model": "qwen3-coder:30b" },  "openai": { "apiKey": "{env:OPENAI_API_KEY}" },  "google": { "apiKey": "{env:GOOGLE_API_KEY}" }  },  "default": "ollama",  "routing": {  "planner": "openai",  "tech_lead": "google"  } }

{  "providers": {  "ollama": { "model": "qwen3-coder:30b" },  "openai": { "apiKey": "{env:OPENAI_API_KEY}" },  "google": { "apiKey": "{env:GOOGLE_API_KEY}" }  },  "default": "ollama",  "routing": {  "planner": "openai",  "tech_lead": "google"  } }

Use expensive models for judgment. Free local models for volume.

AI Provider Support

Bring your own keys. Mix and match per role. WorkerMill uses the Vercel AI SDK — any compatible provider works out of the box.

Provider Models Notes

Ollama Any local model Auto-detected, including WSL. Fully offline

LM Studio Any local model Auto-detected

Anthropic Claude Opus 4.6, Sonnet 4.6, Haiku 4.5

OpenAI GPT-5.4, GPT-5.4 Mini, GPT-5.3 Codex

Google Gemini 3.1 Pro, Gemini 2.5 Flash

Any provider with an OpenAI-compatible API also works — Groq, DeepSeek, Mistral, OpenRouter, Together AI, xAI, Fireworks, or your own custom endpoint.

Install

# Run without installing (recommended) npx workermill

# Run without installing (recommended) npx workermill

Or install globally

npm install -g workermill

Check your setup

wm doctor`

No server, no Docker, no account. First run walks you through provider setup — pick a model, add a key (or point at Ollama), and you're building.

Requirements: Node.js 20+, Git, and an LLM provider (Ollama for local, or an API key). GitHub CLI (gh) is optional but needed for automatic PR creation.

All Commands

Build

Command What it does

/ship Full team: plan, execute with experts, review, commit to branch

/ship spec.md Same, but read the task from a file

/ship GH-42 / PROJ-123 / TEAM-42 Fetch a ticket from GitHub Issues, Jira, or Linear

/as One expert, full tools, no planning overhead

/retry Resume last /ship — skips planning, picks up from the first incomplete story

/review branch Tech lead review of feature branch diff vs main

/review diff Review uncommitted changes only

/review #42 Review a GitHub PR by number

Session

Command What it does

/model provider/model [ctx] Hot-swap model mid-session (e.g. /model google/gemini-3.1-pro)

/compact [focus] Compress conversation — optionally preserve specific context

/cost Session cost estimate and token usage

/sessions List past conversations (resume with --resume on next launch)

/clear Reset the conversation

/editor Open $EDITOR for longer input

Project

Command What it does

/init Generate WORKERMILL.md from codebase analysis

/remember Save a persistent memory

/forget Remove a memory

/memories View all saved project memories

/personas List, view, or create expert personas

/skills List custom skills from .workermill/skills/

Safety

Command What it does

/undo Revert file changes — per-file, per-step, or everything

/diff Preview uncommitted changes

/git Branch and status

/permissions Manage tool allow/deny rules

/trust Auto-approve all tools for this session

Config

Command What it does

/settings View and change configuration inline

/settings key Add an API key without leaving the session

/setup Re-run the provider setup wizard

/hooks View configured pre/post tool hooks

/mcp MCP server connection status

Experimental

Command What it does

/chrome Headless Chrome for testing and scraping

/voice Voice input — speak your task

/schedule Scheduled recurring tasks

Shortcuts: !command runs shell directly · ESC cancels · ESC ESC rolls back last exchange · Shift+Tab cycles permission mode · @file.ts inlines code · @dir/ inlines tree · @url fetches content · @image.png sends to vision models

For teams that need a web dashboard, VS Code extension, and managed cloud workers, see the WorkerMill Platform.

Apache License 2.0 — see LICENSE for details.