Executor Overview - Draft

What Are Executors?

Executors are the AI code tools that Draft uses to implement tickets. When a ticket moves to EXECUTING, Draft spawns the configured executor CLI in the ticket’s isolated worktree.

Supported Executors

Executor	CLI	Mode	Status
Claude Code	`claude`	Headless	Recommended
Cursor Agent	`cursor`	Headless	Supported
Other Executors	Various	Various	Community

How Execution Works

Draft creates an isolated git worktree for the ticket
The executor CLI is spawned with the ticket’s instructions as a prompt
The agent reads the codebase, makes changes, and exits
Draft checks the git diff in the worktree

Post-Execution States

Outcome	Ticket State	Reason
Success + changes detected	`VERIFYING`	Runs verification pipeline
Success + no changes	`BLOCKED`	”No changes produced”
CLI failure	`BLOCKED`	Error message from CLI

Configuration

Set the executor in draft.yaml:

executor_config:
  executor_type: CLAUDE

Draft auto-detects available CLIs on your system. If multiple executors are installed, the configured one takes precedence.

Executor Detection

Draft checks for CLIs in your PATH:

# Check which executors Draft can find
which claude    # Claude Code CLI
which cursor    # Cursor CLI

If the configured executor isn’t found, the job will fail with a clear error message.