init

/init - Initialize Threadwork for a Project

Initialize Threadwork in the current project. This command detects your project's existing configuration and proposes sensible defaults.

Prerequisites

Before running this command, ensure:

1. You are in a git repository
2. The Beads CLI (bd) is installed: npm install -g @anthropic/beads

What This Command Does

1. Detects project state - Examines git branches, existing Beads setup, and any prior Threadwork configuration
2. Proposes configuration - Suggests defaults based on detected patterns
3. Asks for confirmation - Single confirmation point (not question-by-question)
4. Creates configuration - Writes .threadwork.yaml with confirmed settings
5. Initializes Beads - Runs bd init --branch beads-metadata if Beads not already initialized

Execution Steps

Step 1: Check Prerequisites

Run these commands to verify prerequisites:

# Check if we're in a git repo
git rev-parse --is-inside-work-tree

# Check if Beads CLI is installed
bd --version

If bd is not found, stop and inform the user:

Error: Beads CLI (bd) not found. Install with: npm install -g @anthropic/beads

Step 2: Detect Project State

Run these commands to understand the current state:

# List all branches (local and remote)
git branch -a

# Check if .threadwork.yaml exists
test -f .threadwork.yaml && echo "exists" || echo "not found"

# Check if Beads is initialized (look for .beads directory or bd status)
bd --no-daemon status 2>/dev/null || echo "beads not initialized"

Step 3: Analyze and Propose Configuration

Based on detection results, determine:

Base Branch Detection:

• If dev branch exists → propose base_branch: dev
• Else if develop branch exists → propose base_branch: develop
• Else if main branch exists → propose base_branch: main
• Else → propose base_branch: main (will be created)

Branch Prefix Detection:

• Look for existing feature/* branches → propose branch_prefix: feature/
• Look for existing feat/* branches → propose branch_prefix: feat/
• Otherwise → propose branch_prefix: feature/