chiefwiggum 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Addison Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# Chief Wiggum
+
+```
+░█▀▀░█░█░▀█▀░█▀▀░█▀▀░░░█░█░▀█▀░█▀▀░█▀▀░█░█░█▄█
+░█░░░█▀█░░█░░█▀▀░█▀▀░░░█▄█░░█░░█░█░█░█░█░█░█░█
+░▀▀▀░▀░▀░▀▀▀░▀▀▀░▀░░░░░▀░▀░▀▀▀░▀▀▀░▀▀▀░▀▀▀░▀░▀
+```
+
+Autonomous coding agent CLI. Point it at a plan, watch it build.
+
+## Install
+
+```bash
+npx chiefwiggum@latest
+```
+
+That's it. Now you can use `chiefwiggum` anywhere.
+
+**Requires:** [Claude Code](https://claude.ai/code) installed and authenticated.
+
+## Usage
+
+### Interactive Setup
+
+```bash
+cd your-project
+chiefwiggum new
+```
+
+You'll be prompted with numbered options:
+
+```
+How would you like to set up this project?
+
+  1) From a plan file - I have a plan.md ready
+  2) Describe it - I'll tell you what to build
+  3) Existing TODO - Just start the loop with current TODO.md
+
+Enter choice [1-3]:
+```
+
+### From a Plan File
+
+```bash
+chiefwiggum new plans/myplan.md
+```
+
+Generates specs and starts building.
+
+### Just Run the Loop
+
+```bash
+chiefwiggum loop
+# or just
+chiefwiggum
+```
+
+Works through existing TODO.md tasks.
+
+### Check Status
+
+```bash
+chiefwiggum status
+```
+
+Shows project status and task progress.
+
+## What It Does
+
+1. **Setup** (`chiefwiggum new`)
+   - Interactive Q&A or use existing plan
+   - Generates: `specs/prd.md`, `specs/technical.md`, `CLAUDE.md`, `TODO.md`
+
+2. **Build Loop** (`chiefwiggum loop`)
+   - Picks first unchecked task from TODO.md
+   - Spawns Claude to implement it
+   - Commits changes
+   - Repeats until done
+
+3. **Guardrails**
+   - 3 consecutive failures → stops
+   - 5 cycles without commits → stops
+   - 60 minute timeout per task
+
+## Project Structure
+
+After setup:
+
+```
+your-project/
+├── specs/
+│   ├── prd.md           # Product requirements
+│   └── technical.md     # Technical specification
+├── CLAUDE.md            # Project context for AI
+├── TODO.md              # Task list (checkbox format)
+└── plans/
+    └── plan.md          # Your original plan (if provided)
+```
+
+## Configuration
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `TODO_FILE` | `TODO.md` | Task list file |
+| `ITERATION_TIMEOUT_MINUTES` | `60` | Max time per task |
+| `MAX_CONSECUTIVE_FAILURES` | `3` | Failures before stopping |
+| `MAX_NO_COMMIT_CYCLES` | `5` | Cycles without progress |
+| `COOLDOWN_SECONDS` | `5` | Pause between tasks |
+
+## Requirements
+
+- [Claude Code CLI](https://claude.ai/code) (authenticated)
+- Git
+- jq
+- tmux (recommended for long builds)
+
+## Tips
+
+- **Run in tmux**: For long builds, use `tmux` so you can detach
+- **Review specs first**: After `chiefwiggum new`, review generated specs before starting loop
+- **Watch the output**: Claude streams progress so you can see what it's doing
+- **Check commits**: Each task should produce a commit - if not, something's wrong
+
+## Troubleshooting
+
+**Loop stops with "3 consecutive failures"**
+- Check `/tmp/chiefwiggum-iter*.log` for error details
+- Fix the issue, then run `chiefwiggum` again
+
+**Loop stops with "No commits for 5 cycles"**
+- Tasks may be too vague or blocked
+- Review TODO.md and make tasks more specific
+
+**`jq: command not found`**
+```bash
+brew install jq        # macOS
+sudo apt install jq    # Ubuntu
+```
+
+## License
+
+MIT

package/chiefwiggum

@@ -0,0 +1,782 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+###########################################
+#  ░█▀▀░█░█░▀█▀░█▀▀░█▀▀░░░█░█░▀█▀░█▀▀░█▀▀░█░█░█▄█
+#  ░█░░░█▀█░░█░░█▀▀░█▀▀░░░█▄█░░█░░█░█░█░█░█░█░█░█
+#  ░▀▀▀░▀░▀░▀▀▀░▀▀▀░▀░░░░░▀░▀░▀▀▀░▀▀▀░▀▀▀░▀▀▀░▀░▀
+#
+#  Autonomous coding agent CLI
+###########################################
+
+VERSION="1.0.0"
+
+# =========================================
+# COLORS
+# =========================================
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# =========================================
+# CONFIGURATION
+# =========================================
+TODO_FILE="${TODO_FILE:-TODO.md}"
+COOLDOWN_SECONDS="${COOLDOWN_SECONDS:-5}"
+
+# Guardrails
+ITERATION_TIMEOUT_MINUTES="${ITERATION_TIMEOUT_MINUTES:-60}"
+MAX_CONSECUTIVE_FAILURES="${MAX_CONSECUTIVE_FAILURES:-3}"
+MAX_NO_COMMIT_CYCLES="${MAX_NO_COMMIT_CYCLES:-5}"
+MAX_CLAUDE_ATTEMPTS="${MAX_CLAUDE_ATTEMPTS:-3}"
+
+# Claude Code reliability hardening
+export CLAUDE_CODE_EXIT_AFTER_STOP_DELAY="${CLAUDE_CODE_EXIT_AFTER_STOP_DELAY:-30000}"
+export NODE_OPTIONS="--unhandled-rejections=strict${NODE_OPTIONS:+ $NODE_OPTIONS}"
+
+# =========================================
+# BANNER
+# =========================================
+show_banner() {
+  echo ""
+  echo -e "${CYAN}░█▀▀░█░█░▀█▀░█▀▀░█▀▀░░░█░█░▀█▀░█▀▀░█▀▀░█░█░█▄█${NC}"
+  echo -e "${CYAN}░█░░░█▀█░░█░░█▀▀░█▀▀░░░█▄█░░█░░█░█░█░█░█░█░█░█${NC}"
+  echo -e "${CYAN}░▀▀▀░▀░▀░▀▀▀░▀▀▀░▀░░░░░▀░▀░▀▀▀░▀▀▀░▀▀▀░▀▀▀░▀░▀${NC}"
+  echo -e "${BLUE}  Autonomous Coding Agent v${VERSION}${NC}"
+  echo ""
+}
+
+# =========================================
+# HELP
+# =========================================
+show_help() {
+  show_banner
+  echo "Usage: chiefwiggum [command] [options]"
+  echo ""
+  echo "Commands:"
+  echo "  new [plan.md]    Initialize project (interactive or from plan file)"
+  echo "  loop             Run the build loop on existing TODO.md"
+  echo "  status           Show current project status"
+  echo "  help             Show this help message"
+  echo ""
+  echo "Examples:"
+  echo "  chiefwiggum new                  # Interactive setup"
+  echo "  chiefwiggum new plans/myplan.md  # Setup from plan file"
+  echo "  chiefwiggum loop                 # Start build loop"
+  echo "  chiefwiggum                      # Same as 'loop'"
+  echo ""
+}
+
+# =========================================
+# PROMPT HELPERS
+# =========================================
+ask_choice() {
+  local prompt="$1"
+  shift
+  local options=("$@")
+
+  echo ""
+  echo -e "${BOLD}${prompt}${NC}"
+  echo ""
+
+  local i=1
+  for opt in "${options[@]}"; do
+    echo -e "  ${CYAN}${i})${NC} ${opt}"
+    ((i++))
+  done
+  echo ""
+
+  while true; do
+    read -rp "Enter choice [1-${#options[@]}]: " choice
+    if [[ "$choice" =~ ^[0-9]+$ ]] && [ "$choice" -ge 1 ] && [ "$choice" -le "${#options[@]}" ]; then
+      return $((choice - 1))
+    fi
+    echo -e "${RED}Invalid choice. Please enter 1-${#options[@]}${NC}"
+  done
+}
+
+ask_text() {
+  local prompt="$1"
+  local default="${2:-}"
+
+  echo ""
+  if [ -n "$default" ]; then
+    read -rp "${prompt} [${default}]: " response
+    echo "${response:-$default}"
+  else
+    read -rp "${prompt}: " response
+    echo "$response"
+  fi
+}
+
+ask_confirm() {
+  local prompt="$1"
+  local default="${2:-y}"
+
+  if [ "$default" = "y" ]; then
+    read -rp "${prompt} [Y/n]: " response
+    [[ ! "$response" =~ ^[Nn] ]]
+  else
+    read -rp "${prompt} [y/N]: " response
+    [[ "$response" =~ ^[Yy] ]]
+  fi
+}
+
+# =========================================
+# STATUS COMMAND
+# =========================================
+cmd_status() {
+  show_banner
+
+  echo -e "${BOLD}Project Status${NC}"
+  echo ""
+
+  # Check for key files
+  local has_todo=false
+  local has_specs=false
+  local has_claude_md=false
+
+  [ -f "$TODO_FILE" ] && has_todo=true
+  [ -d "specs" ] && has_specs=true
+  [ -f "CLAUDE.md" ] && has_claude_md=true
+
+  echo -e "  TODO.md:    $([ "$has_todo" = true ] && echo -e "${GREEN}✓${NC}" || echo -e "${RED}✗${NC}")"
+  echo -e "  specs/:     $([ "$has_specs" = true ] && echo -e "${GREEN}✓${NC}" || echo -e "${RED}✗${NC}")"
+  echo -e "  CLAUDE.md:  $([ "$has_claude_md" = true ] && echo -e "${GREEN}✓${NC}" || echo -e "${RED}✗${NC}")"
+  echo ""
+
+  if [ "$has_todo" = true ]; then
+    local total=$(grep -c "^\s*- \[" "$TODO_FILE" 2>/dev/null || echo "0")
+    local done=$(grep -c "^\s*- \[x\]" "$TODO_FILE" 2>/dev/null || echo "0")
+    local remaining=$((total - done))
+
+    echo -e "${BOLD}Tasks${NC}"
+    echo -e "  Total:     ${total}"
+    echo -e "  Completed: ${GREEN}${done}${NC}"
+    echo -e "  Remaining: ${YELLOW}${remaining}${NC}"
+    echo ""
+  fi
+
+  # Git status
+  if git rev-parse --git-dir &>/dev/null; then
+    local branch=$(git branch --show-current 2>/dev/null || echo "unknown")
+    local commits=$(git rev-list --count HEAD 2>/dev/null || echo "0")
+    echo -e "${BOLD}Git${NC}"
+    echo -e "  Branch:  ${branch}"
+    echo -e "  Commits: ${commits}"
+  fi
+  echo ""
+}
+
+# =========================================
+# NEW COMMAND - INTERACTIVE SETUP
+# =========================================
+cmd_new() {
+  local plan_file="${1:-}"
+
+  show_banner
+
+  echo -e "${BOLD}Project Setup${NC}"
+  echo ""
+
+  # Show current directory
+  echo -e "Working directory: ${CYAN}$(pwd)${NC}"
+  echo ""
+
+  if ! ask_confirm "Initialize Chief Wiggum in this directory?"; then
+    echo -e "${YELLOW}Aborted.${NC}"
+    exit 0
+  fi
+
+  # Check for existing files
+  local existing_files=()
+  [ -f "$TODO_FILE" ] && existing_files+=("TODO.md")
+  [ -d "specs" ] && existing_files+=("specs/")
+  [ -f "CLAUDE.md" ] && existing_files+=("CLAUDE.md")
+
+  if [ ${#existing_files[@]} -gt 0 ]; then
+    echo ""
+    echo -e "${YELLOW}Existing files found:${NC}"
+    for f in "${existing_files[@]}"; do
+      echo "  - $f"
+    done
+    echo ""
+    if ! ask_confirm "Overwrite these files?" "n"; then
+      echo -e "${YELLOW}Aborted.${NC}"
+      exit 0
+    fi
+  fi
+
+  # If plan file provided, use it directly
+  if [ -n "$plan_file" ]; then
+    if [ ! -f "$plan_file" ]; then
+      echo -e "${RED}Plan file not found: ${plan_file}${NC}"
+      exit 1
+    fi
+    generate_from_plan "$plan_file"
+    start_loop
+    return
+  fi
+
+  # Interactive setup
+  ask_choice "How would you like to set up this project?" \
+    "From a plan file - I have a plan.md ready" \
+    "Describe it - I'll tell you what to build" \
+    "Existing TODO - Just start the loop with current TODO.md"
+  local setup_choice=$?
+
+  case $setup_choice in
+    0)
+      # From plan file
+      local plan_path
+      plan_path=$(ask_text "Path to plan file" "plans/plan.md")
+      if [ ! -f "$plan_path" ]; then
+        echo -e "${RED}Plan file not found: ${plan_path}${NC}"
+        exit 1
+      fi
+      generate_from_plan "$plan_path"
+      ;;
+    1)
+      # Describe project
+      interactive_describe
+      ;;
+    2)
+      # Existing TODO
+      if [ ! -f "$TODO_FILE" ]; then
+        echo -e "${RED}No TODO.md found. Run 'chiefwiggum new' to set up first.${NC}"
+        exit 1
+      fi
+      ;;
+  esac
+
+  # Ask about starting the loop
+  echo ""
+  ask_choice "Ready to start. What would you like to do?" \
+    "Start the build loop now" \
+    "Review files first, then start manually with 'chiefwiggum loop'" \
+    "Exit"
+  local start_choice=$?
+
+  case $start_choice in
+    0) start_loop ;;
+    1)
+      echo ""
+      echo -e "${GREEN}Setup complete!${NC} Review your files, then run:"
+      echo -e "  ${CYAN}chiefwiggum loop${NC}"
+      ;;
+    2)
+      echo -e "${YELLOW}Exiting.${NC}"
+      ;;
+  esac
+}
+
+# =========================================
+# INTERACTIVE PROJECT DESCRIPTION
+# =========================================
+interactive_describe() {
+  echo ""
+  echo -e "${BOLD}Tell me about your project${NC}"
+  echo ""
+
+  # Project name
+  local project_name
+  project_name=$(ask_text "Project name")
+
+  # Project type
+  ask_choice "What type of project is this?" \
+    "Web application (Next.js, React, etc.)" \
+    "API / Backend service" \
+    "CLI tool" \
+    "Library / Package" \
+    "Mobile app" \
+    "Other"
+  local project_type=$?
+  local project_type_names=("web" "api" "cli" "library" "mobile" "other")
+  local project_type_name="${project_type_names[$project_type]}"
+
+  # Tech stack
+  local tech_stack
+  tech_stack=$(ask_text "Tech stack (e.g., Next.js, TypeScript, Convex)")
+
+  # Description
+  echo ""
+  echo -e "${BOLD}Describe what you're building:${NC}"
+  echo "(Enter description, then press Enter twice to finish)"
+  echo ""
+  local description=""
+  local empty_lines=0
+  while IFS= read -r line; do
+    if [ -z "$line" ]; then
+      ((empty_lines++))
+      [ $empty_lines -ge 1 ] && break
+    else
+      empty_lines=0
+    fi
+    description+="$line"$'\n'
+  done
+
+  # Key features
+  echo ""
+  echo -e "${BOLD}List key features (one per line, empty line to finish):${NC}"
+  local features=""
+  while IFS= read -r line; do
+    [ -z "$line" ] && break
+    features+="- $line"$'\n'
+  done
+
+  # Generate plan content
+  local plan_content="# ${project_name}
+
+## Overview
+${description}
+
+## Project Type
+${project_type_name}
+
+## Tech Stack
+${tech_stack}
+
+## Key Features
+${features}
+"
+
+  # Save plan
+  mkdir -p plans
+  local plan_file="plans/plan.md"
+  echo "$plan_content" > "$plan_file"
+  echo ""
+  echo -e "${GREEN}Plan saved to ${plan_file}${NC}"
+
+  # Generate specs from plan
+  generate_from_plan "$plan_file"
+}
+
+# =========================================
+# GENERATE SPECS FROM PLAN
+# =========================================
+generate_from_plan() {
+  local plan_file="$1"
+  local plan_content
+  plan_content="$(cat "$plan_file")"
+
+  echo ""
+  echo -e "${GREEN}════════════════════════════════════════${NC}"
+  echo -e "${GREEN}  Generating specs from: ${plan_file}${NC}"
+  echo -e "${GREEN}════════════════════════════════════════${NC}"
+
+  mkdir -p specs
+
+  # Step 1: Generate PRD
+  echo ""
+  echo -e "${YELLOW}[1/4] Generating specs/prd.md...${NC}"
+
+  local prd_prompt="You are generating a PRD (Product Requirements Document) from a project plan.
+
+Here is the plan:
+<plan>
+${plan_content}
+</plan>
+
+Generate a complete PRD with these sections:
+- Overview
+- Problem Statement
+- Goals & Success Metrics
+- User Stories
+- Functional Requirements
+- Non-Functional Requirements
+- Out of Scope
+
+Write it directly to specs/prd.md.
+Do NOT ask questions — infer everything from the plan.
+Be concise but comprehensive."
+
+  echo "$prd_prompt" | claude -p --dangerously-skip-permissions 2>/dev/null
+  echo -e "${GREEN}  ✓ specs/prd.md${NC}"
+
+  # Step 2: Generate Technical Spec
+  echo ""
+  echo -e "${YELLOW}[2/4] Generating specs/technical.md...${NC}"
+  local prd_generated
+  prd_generated="$(cat specs/prd.md 2>/dev/null || echo "")"
+
+  local tech_prompt="You are generating a Technical Specification from a PRD.
+
+Here is the PRD:
+<prd>
+${prd_generated}
+</prd>
+
+Generate a complete Technical Specification with:
+- Architecture Overview
+- Tech Stack
+- Data Model
+- API Design (if applicable)
+- Key Components
+- Security Considerations
+- Performance Considerations
+
+Write it directly to specs/technical.md.
+Do NOT ask questions — infer everything from the PRD."
+
+  echo "$tech_prompt" | claude -p --dangerously-skip-permissions 2>/dev/null
+  echo -e "${GREEN}  ✓ specs/technical.md${NC}"
+
+  # Step 3: Generate CLAUDE.md
+  echo ""
+  echo -e "${YELLOW}[3/4] Generating CLAUDE.md...${NC}"
+
+  local claude_prompt="You are generating a CLAUDE.md file for a project.
+
+Here is the PRD:
+<prd>
+${prd_generated}
+</prd>
+
+Here is the Technical Spec:
+<technical>
+$(cat specs/technical.md 2>/dev/null || echo "")
+</technical>
+
+Generate a CLAUDE.md with:
+- Brief project overview
+- Key commands to run
+- Architecture summary
+- Important conventions
+- Empty '## Learnings' section at the bottom
+
+Write it directly to CLAUDE.md.
+Keep it concise - this is a quick reference for AI agents."
+
+  echo "$claude_prompt" | claude -p --dangerously-skip-permissions 2>/dev/null
+  echo -e "${GREEN}  ✓ CLAUDE.md${NC}"
+
+  # Step 4: Generate TODO
+  echo ""
+  echo -e "${YELLOW}[4/4] Generating TODO.md...${NC}"
+
+  local todo_prompt="You are generating a TODO task list from a PRD and Technical Specification.
+
+Here is the PRD:
+<prd>
+${prd_generated}
+</prd>
+
+Here is the Technical Specification:
+<technical>
+$(cat specs/technical.md 2>/dev/null || echo "")
+</technical>
+
+Generate a phased TODO.md with:
+- Logical phases (Setup, Core Features, Polish, etc.)
+- Granular tasks using checkbox format: - [ ] Task description
+- Each phase ends with: - [ ] Phase review
+- Tasks should be completable in 1-2 hours max
+
+Write it directly to TODO.md.
+Do NOT ask questions — infer everything from the specs."
+
+  echo "$todo_prompt" | claude -p --dangerously-skip-permissions 2>/dev/null
+  echo -e "${GREEN}  ✓ TODO.md${NC}"
+
+  echo ""
+  echo -e "${GREEN}Specs generated:${NC}"
+  echo "  - specs/prd.md"
+  echo "  - specs/technical.md"
+  echo "  - CLAUDE.md"
+  echo "  - TODO.md"
+
+  # Commit specs
+  if git rev-parse --git-dir &>/dev/null; then
+    git add specs/ TODO.md CLAUDE.md 2>/dev/null || true
+    git commit -m "chore: generate specs from plan" 2>/dev/null || true
+  fi
+}
+
+# =========================================
+# BUILD LOOP
+# =========================================
+start_loop() {
+  [ -f "$TODO_FILE" ] || { echo -e "${RED}Missing $TODO_FILE${NC}"; exit 1; }
+
+  local max_iterations
+  max_iterations=$(grep -c "\[ \]" "$TODO_FILE" 2>/dev/null) || max_iterations=0
+
+  if [ "$max_iterations" -eq 0 ]; then
+    echo -e "${GREEN}No unchecked tasks in $TODO_FILE. All done!${NC}"
+    exit 0
+  fi
+
+  echo ""
+  echo -e "${GREEN}════════════════════════════════════════${NC}"
+  echo -e "${GREEN}  Starting Build Loop${NC}"
+  echo -e "${GREEN}  Tasks remaining: ${max_iterations}${NC}"
+  echo -e "${GREEN}  Timeout: ${ITERATION_TIMEOUT_MINUTES}m per task${NC}"
+  echo -e "${GREEN}════════════════════════════════════════${NC}"
+
+  local consecutive_failures=0
+  local no_commit_cycles=0
+  local last_commit
+  last_commit="$(git rev-parse HEAD 2>/dev/null || echo "none")"
+
+  for i in $(seq 1 "$max_iterations"); do
+    echo ""
+    echo -e "${YELLOW}══════════ Task $i of $max_iterations ══════════${NC}"
+
+    cleanup_stale_processes
+
+    local start_time
+    start_time="$(date +%s)"
+
+    set +e
+    run_task_iteration "$i"
+    local claude_exit=$?
+    set -e
+
+    local duration=$(($(date +%s) - start_time))
+    echo ""
+    echo -e "Completed in ${duration}s (exit: ${claude_exit})"
+
+    # Track failures
+    if [ "$claude_exit" -ne 0 ]; then
+      consecutive_failures=$((consecutive_failures + 1))
+      echo -e "${RED}Failure ${consecutive_failures}/${MAX_CONSECUTIVE_FAILURES}${NC}"
+      sleep 30
+    else
+      consecutive_failures=0
+    fi
+
+    # Track commits
+    local current_commit
+    current_commit="$(git rev-parse HEAD 2>/dev/null || echo "none")"
+    if [ "$current_commit" = "$last_commit" ]; then
+      if [ "$claude_exit" -eq 0 ]; then
+        no_commit_cycles=$((no_commit_cycles + 1))
+        echo -e "${YELLOW}No commit (${no_commit_cycles}/${MAX_NO_COMMIT_CYCLES})${NC}"
+      fi
+    else
+      no_commit_cycles=0
+      last_commit="$current_commit"
+      echo -e "${GREEN}New commit: ${current_commit:0:7}${NC}"
+      git push origin HEAD 2>/dev/null && echo "Pushed to origin" || true
+    fi
+
+    # Guardrails
+    if [ "$consecutive_failures" -ge "$MAX_CONSECUTIVE_FAILURES" ]; then
+      echo -e "${RED}Stopping: ${MAX_CONSECUTIVE_FAILURES} consecutive failures${NC}"
+      exit 1
+    fi
+
+    if [ "$no_commit_cycles" -ge "$MAX_NO_COMMIT_CYCLES" ]; then
+      echo -e "${RED}Stopping: No commits for ${MAX_NO_COMMIT_CYCLES} cycles${NC}"
+      exit 1
+    fi
+
+    # Check if done
+    if ! grep -q "\[ \]" "$TODO_FILE"; then
+      echo ""
+      echo -e "${GREEN}════════════════════════════════════════${NC}"
+      echo -e "${GREEN}  All tasks completed!${NC}"
+      echo -e "${GREEN}════════════════════════════════════════${NC}"
+      git push origin HEAD 2>/dev/null || true
+      exit 0
+    fi
+
+    sleep "$COOLDOWN_SECONDS"
+  done
+
+  echo -e "${YELLOW}Reached max iterations (${max_iterations})${NC}"
+  git push origin HEAD 2>/dev/null || true
+}
+
+run_task_iteration() {
+  local iteration="$1"
+  local log_file="/tmp/chiefwiggum-iter${iteration}.log"
+
+  local task_prompt='You are an autonomous coding agent. Complete ONE task from TODO.md.
+
+## Before Starting
+Read these files to understand the project:
+- CLAUDE.md — Project context and conventions
+- specs/prd.md — What we are building
+- specs/technical.md — How we are building it
+- TODO.md — Task list
+
+## Workflow
+1. Find the FIRST unchecked task (- [ ]) in TODO.md
+2. Plan: Understand what needs to be done
+3. Implement: Write the code
+4. Review: Verify it works
+5. Mark complete: Change - [ ] to - [x] in TODO.md
+6. Commit: git add . && git commit -m "type(scope): description"
+
+## Rules
+- ONE task per iteration
+- Follow existing code patterns
+- Use conventional commits (feat, fix, docs, refactor, test, chore)
+- If blocked after 3 attempts, output RALPH_BLOCKED: <reason>
+
+## When Done
+Output: RALPH_COMPLETE
+If no tasks remain: RALPH_ALL_DONE'
+
+  local claude_exit=1
+
+  for attempt in $(seq 1 "$MAX_CLAUDE_ATTEMPTS"); do
+    echo -e "${YELLOW}Attempt ${attempt}/${MAX_CLAUDE_ATTEMPTS}${NC}"
+
+    echo "$task_prompt" \
+      | timeout --kill-after=10s "${ITERATION_TIMEOUT_MINUTES}m" \
+        claude -p --dangerously-skip-permissions --no-session-persistence \
+          --verbose --output-format stream-json \
+      2>&1 \
+      | tee "$log_file" \
+      | jq -r '
+          if .type == "assistant" then
+            (.message.content[]? | select(.type=="text") | .text? // empty),
+            (.message.content[]? | select(.type=="tool_use") | "🔧 " + .name)
+          elif .type == "result" then
+            "✅ " + (.subtype // "done")
+          else empty end
+        ' 2>/dev/null || true &
+    local claude_pid=$!
+
+    # Monitor for freeze
+    while kill -0 $claude_pid 2>/dev/null; do
+      if grep -q "No messages returned" "$log_file" 2>/dev/null; then
+        echo -e "${RED}Freeze detected, killing...${NC}"
+        kill -9 $claude_pid 2>/dev/null || true
+        sleep 2
+        break
+      fi
+      sleep 1
+    done
+
+    wait $claude_pid 2>/dev/null
+    claude_exit=$?
+
+    # Check for transient errors
+    if [ "$claude_exit" -ne 0 ]; then
+      if grep -qE "(No messages returned|ECONNRESET|ETIMEDOUT)" "$log_file" 2>/dev/null; then
+        echo -e "${YELLOW}Transient error, retrying...${NC}"
+        sleep $((attempt * 5))
+        continue
+      fi
+    fi
+
+    break
+  done
+
+  rm -f "$log_file"
+  return $claude_exit
+}
+
+cleanup_stale_processes() {
+  pkill -f playwright 2>/dev/null || true
+  pkill -f chromium 2>/dev/null || true
+  if command -v lsof &>/dev/null; then
+    lsof -ti:3000 | xargs kill -9 2>/dev/null || true
+  fi
+  sleep 1
+}
+
+# =========================================
+# INSTALL COMMAND
+# =========================================
+cmd_install() {
+  show_banner
+
+  echo -e "${BOLD}Installing Chief Wiggum...${NC}"
+  echo ""
+
+  # Check if already installed globally
+  if command -v chiefwiggum &>/dev/null; then
+    local installed_path=$(which chiefwiggum)
+    if [[ "$installed_path" != *"npx"* ]] && [[ "$installed_path" != *".npm/_npx"* ]]; then
+      echo -e "${GREEN}✓ Already installed at: ${installed_path}${NC}"
+      echo ""
+      echo "Run 'chiefwiggum new' to get started."
+      return 0
+    fi
+  fi
+
+  # Install globally
+  echo "Running: npm install -g chiefwiggum"
+  echo ""
+
+  if npm install -g chiefwiggum; then
+    echo ""
+    echo -e "${GREEN}════════════════════════════════════════${NC}"
+    echo -e "${GREEN}  ✓ Installation complete!${NC}"
+    echo -e "${GREEN}════════════════════════════════════════${NC}"
+    echo ""
+    echo "Get started:"
+    echo -e "  ${CYAN}chiefwiggum new${NC}     # Set up a new project"
+    echo -e "  ${CYAN}chiefwiggum loop${NC}    # Run the build loop"
+    echo -e "  ${CYAN}chiefwiggum help${NC}    # See all commands"
+    echo ""
+  else
+    echo ""
+    echo -e "${RED}Installation failed.${NC}"
+    echo "Try running with sudo: sudo npm install -g chiefwiggum"
+    exit 1
+  fi
+}
+
+# =========================================
+# MAIN
+# =========================================
+main() {
+  local cmd="${1:-}"
+
+  case "$cmd" in
+    install)
+      cmd_install
+      ;;
+    new)
+      shift
+      cmd_new "$@"
+      ;;
+    loop)
+      show_banner
+      start_loop
+      ;;
+    status)
+      cmd_status
+      ;;
+    help|--help|-h)
+      show_help
+      ;;
+    "")
+      # No command: if running via npx, install. Otherwise run loop.
+      if [[ "${0}" == *"npx"* ]] || [[ "${0}" == *".npm/_npx"* ]]; then
+        cmd_install
+      else
+        show_banner
+        if [ -f "$TODO_FILE" ]; then
+          start_loop
+        else
+          echo -e "${YELLOW}No TODO.md found. Run 'chiefwiggum new' to get started.${NC}"
+          exit 1
+        fi
+      fi
+      ;;
+    *)
+      # Check if it's a file path (for backward compat with ralph.sh)
+      if [ -f "$cmd" ]; then
+        show_banner
+        generate_from_plan "$cmd"
+        start_loop
+      else
+        echo -e "${RED}Unknown command: ${cmd}${NC}"
+        echo "Run 'chiefwiggum help' for usage."
+        exit 1
+      fi
+      ;;
+  esac
+}
+
+main "$@"

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "chiefwiggum",
+  "version": "1.0.0",
+  "description": "Autonomous coding agent CLI. Point it at a plan, watch it build.",
+  "bin": {
+    "chiefwiggum": "./chiefwiggum"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/addisonk/chief-wiggum.git"
+  },
+  "keywords": [
+    "cli",
+    "autonomous",
+    "coding-agent",
+    "claude",
+    "ai"
+  ],
+  "author": "Addison Kowalski",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/addisonk/chief-wiggum/issues"
+  },
+  "homepage": "https://github.com/addisonk/chief-wiggum#readme",
+  "engines": {
+    "node": ">=18"
+  }
+}