Getting Started

Install Dark Factory, configure your first project, and let autonomous agents handle your GitHub issues.

Installation

Prerequisites

• Claude Code — installed and available on your PATH (Dark Factory is built specifically for Claude Code)
• Docker — agents run in sandboxed containers
• GitHub CLI (gh) — authenticated with your account
• Anthropic API key or Claude Code OAuth token

Install via Homebrew (macOS)

brew install peter-stratton/dark-factory/godark

Install from source

Requires Go 1.22+:

go install github.com/peter-stratton/dark-factory/cmd/godark@latest

Verify installation

godark version
godark doctor

The doctor command checks that system dependencies are in place — Docker running, gh authenticated, and API key set. Language toolchains are installed inside the Docker sandbox automatically.

Project Setup

Initialize an existing project

cd your-project
godark init --repo owner/your-project

This writes:

• godark.yaml — project configuration with auto-detected build/test/lint commands (only if it doesn't exist; --repo updates the repo field in existing configs)
• .claude/skills/ — all nine godark skill files (always overwritten)
• .claude/godark.md — pipeline documentation for Claude Code (always overwritten)
• docs/ — architecture, conventions, and roadmap templates (skip if exists)
• prompts/ — agent prompt templates (always overwritten)

Create a new project

godark new my-project --repo owner/my-project

Creates the directory, initializes git, and scaffolds all harness files including CLAUDE.md, .gitignore, and documentation structure.

Configure the project

Use the /godark-configure-project skill to auto-detect your build commands, environment variables, CI checks, and Docker configuration:

# In Claude Code:
/godark-configure-project

Or edit godark.yaml manually. See the Configuration guide for all options.

Tutorials

We have hands-on demo projects in Go, Python, and Node.js/TypeScript. Each is a GitHub template repo you can clone and follow step-by-step, with Dark Factory pushing real PRs to your repo.

Browse all tutorials →

Next Steps

• Workflows — the plan-run-merge loop and how milestones work
• Teams — multi-developer coordination and milestone ownership
• CLI Reference — all commands and flags
• Configuration — deep dive into godark.yaml
• Skills — scaffold roadmaps, planning docs, and more