TurkeyCode CLI

CLI Docs

The open-source build orchestrator that turns one plain-English prompt into a researched, planned, built, and QA'd application — then ships it. Free and open source (MIT).

New here? Jump to Getting Started for an end-to-end walkthrough, or the Command Reference to look up any flag.

The 30-second mental model

TurkeyCode does not write code. It orchestrates Claude Code through a deterministic pipeline with hard gates between every step. No AI decides what happens next — the orchestrator does.

You: "Build me a recipe sharing app"
    |
    |-- Scope       converge on what to build (interactive; skippable)
    |-- Research    tech stack, architecture, prior art
    |-- Plan        2-5 build phases with deliverables
    |
    +-- FOR EACH PHASE:
        |-- Build    one focused coding session
        |-- QA       smoke -> functional -> visual
        |-- Fix      all issues in one session, full context
        |-- Retry    up to 5 QA cycles until clean
        |-- Review   code review with actionable feedback
        +-- Merge    PR merged, next phase

Gates are walls

Every transition has an artifact gate — a file that must exist with valid content before the pipeline advances. No hallucinated progress, no skipped steps.

Install

# Zero-install, one-off
$ npx turkeycode run "your app description"
 
# Or install globally (gives you both `turkeycode` and the `turkey` alias)
$ npm install -g turkeycode

Throughout these docs turkeycode and turkey are the same executable.

The two halves of the product

	What	Cost
The CLI	Builds your app on your machine (any stack, any platform).	Free, open-source (MIT).
turkeycode.ai	Hosts web apps and stores deliverables for non-web builds.	Paid tiers (optional).

The free tool builds your app; the platform hosts it for you — but hosting is entirely optional. turkeycode run never needs an account.

Where to next

Page	Read it when you want to…
Getting Started	Install, authenticate, and walk through your first build → QA → deploy.
Example Walkthrough	See a full build-to-deploy run with terminal frames at each step.
Command Reference	Look up every command, flag, argument, env var, and exit behavior.