vibe-forge 0.3.6 → 0.3.11

package/agents/scribe/personality.md

@@ -66,6 +66,24 @@ Where other agents create, Scribe preserves. The README that saves a future deve
 9. Move to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-024        # When starting a task
+/update-status blocked TASK-024        # When stuck (then /need-help if needed)
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+4. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/bin/cli.js

@@ -21,6 +21,8 @@ const REPO_URL = 'https://github.com/SpasticPalate/vibe-forge.git';
 const FORGE_DIR = '_vibe-forge';
 
 // Colors for terminal output
+// NOTE: Intentionally self-contained - cli.js runs standalone via npx before
+// the rest of Vibe Forge is installed, so it cannot share with colors.sh
 const colors = {
   reset: '\x1b[0m',
   red: '\x1b[31m',
@@ -199,6 +201,9 @@ async function initCommand() {
 
   log('');
 
+  // Update project's .gitignore to ignore tool internals but keep project data
+  updateGitignore();
+
   // Run the setup script
   logInfo('Running setup...');
   log('');
@@ -212,6 +217,50 @@ async function initCommand() {
   }
 }
 
+function updateGitignore() {
+  const gitignorePath = path.join(process.cwd(), '.gitignore');
+  const forgeIgnoreMarker = '# Vibe Forge';
+  const forgeIgnoreBlock = `
+# Vibe Forge
+# Tool internals (regenerated on update)
+_vibe-forge/.git/
+_vibe-forge/bin/
+_vibe-forge/agents/
+_vibe-forge/config/
+_vibe-forge/docs/
+_vibe-forge/tests/
+_vibe-forge/src/
+_vibe-forge/node_modules/
+_vibe-forge/package*.json
+_vibe-forge/*.md
+_vibe-forge/LICENSE
+_vibe-forge/.github/
+
+# Keep project data (tasks, context) - these ARE committed
+# !_vibe-forge/tasks/
+# !_vibe-forge/context/
+# !_vibe-forge/.claude/
+`;
+
+  try {
+    let content = '';
+    if (fs.existsSync(gitignorePath)) {
+      content = fs.readFileSync(gitignorePath, 'utf8');
+      // Check if already has forge entries
+      if (content.includes(forgeIgnoreMarker)) {
+        return; // Already configured
+      }
+    }
+
+    // Append forge ignore block
+    const newContent = content.trimEnd() + '\n' + forgeIgnoreBlock;
+    fs.writeFileSync(gitignorePath, newContent);
+    logSuccess('Updated .gitignore for Vibe Forge');
+  } catch (err) {
+    logError(`Warning: Could not update .gitignore: ${err.message}`);
+  }
+}
+
 async function updateCommand() {
   showBanner();
 

package/bin/forge-daemon.sh

@@ -113,6 +113,7 @@ safe_move_task() {
 
 notify() {
     local message="$1"
+    local urgency="${2:-normal}"  # normal or urgent
     local timestamp
     timestamp=$(date -Iseconds)
 
@@ -125,7 +126,41 @@ notify() {
     # Terminal bell (works in most terminals)
     printf '\a'
 
-    # Terminal-specific notifications could be added here
+    # System toast notification for urgent messages
+    if [[ "$urgency" == "urgent" ]]; then
+        send_system_notification "$message"
+    fi
+}
+
+# Send system-level notification (platform-specific)
+send_system_notification() {
+    local message="$1"
+    local title="Vibe Forge"
+
+    case "$(uname -s)" in
+        MINGW*|MSYS*|CYGWIN*)
+            # Windows: Use PowerShell toast notification
+            powershell.exe -NoProfile -Command "
+                \$null = [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime]
+                \$template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)
+                \$textNodes = \$template.GetElementsByTagName('text')
+                \$textNodes.Item(0).AppendChild(\$template.CreateTextNode('$title')) | Out-Null
+                \$textNodes.Item(1).AppendChild(\$template.CreateTextNode('$message')) | Out-Null
+                \$toast = [Windows.UI.Notifications.ToastNotification]::new(\$template)
+                [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('Vibe Forge').Show(\$toast)
+            " 2>/dev/null &
+            ;;
+        Darwin)
+            # macOS: Use osascript
+            osascript -e "display notification \"$message\" with title \"$title\"" 2>/dev/null &
+            ;;
+        Linux)
+            # Linux: Use notify-send if available
+            if command -v notify-send &>/dev/null; then
+                notify-send "$title" "$message" 2>/dev/null &
+            fi
+            ;;
+    esac
 }
 
 check_new_pending_tasks() {
@@ -143,10 +178,10 @@ check_new_pending_tasks() {
                 # Extract task info from frontmatter safely
                 local task_id task_title assigned_to
 
-                # Use head to limit read and tr to sanitize
-                task_id=$(grep -m1 "^id:" "$task" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | head -c 100)
-                task_title=$(grep -m1 "^title:" "$task" 2>/dev/null | cut -d':' -f2- | tr -d '"' | head -c 200)
-                assigned_to=$(grep -m1 "^assigned_to:" "$task" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | head -c 50)
+                # Use head to limit read, tr to sanitize, and strip ANSI escape sequences
+                task_id=$(grep -m1 "^id:" "$task" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | tr -d '\033' | sed 's/\[[0-9;]*m//g' | head -c 100)
+                task_title=$(grep -m1 "^title:" "$task" 2>/dev/null | cut -d':' -f2- | tr -d '"' | tr -d '\033' | sed 's/\[[0-9;]*m//g' | head -c 200)
+                assigned_to=$(grep -m1 "^assigned_to:" "$task" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | tr -d '\033' | sed 's/\[[0-9;]*m//g' | head -c 50)
 
                 # Use filename as fallback
                 task_id="${task_id:-$filename}"
@@ -191,13 +226,93 @@ check_new_pending_tasks() {
     done
 }
 
+check_attention_needed() {
+    # Check for workers needing attention (urgent notifications)
+    if [[ ! -d "$FORGE_ROOT/$TASKS_ATTENTION" ]]; then
+        return 0
+    fi
+
+    for attention_file in "$FORGE_ROOT/$TASKS_ATTENTION"/*.md; do
+        if [[ -f "$attention_file" && ! -L "$attention_file" ]]; then
+            local filename
+            filename=$(basename "$attention_file")
+            local notified_key="attention:$filename"
+
+            if ! grep -qF "$notified_key" "$NOTIFIED_FILE" 2>/dev/null; then
+                # Extract attention info
+                local agent issue
+                agent=$(grep -m1 "^agent:" "$attention_file" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | head -c 50)
+                issue=$(grep -m1 "^##" "$attention_file" 2>/dev/null | sed 's/^## *//' | head -c 200)
+
+                agent="${agent:-Unknown}"
+                issue="${issue:-Needs attention}"
+
+                # Ring bell multiple times for attention
+                printf '\a\a\a'
+
+                # Send urgent notification with toast
+                notify "🔔 $agent needs help: $issue" "urgent"
+
+                echo "$notified_key" >> "$NOTIFIED_FILE"
+            fi
+        fi
+    done
+}
+
+# Build worker status from agent-status files
+build_worker_status() {
+    local status_dir="$FORGE_ROOT/$AGENT_STATUS_DIR"
+    local now_epoch
+    now_epoch=$(date +%s)
+    local stale_threshold=300  # 5 minutes
+
+    if [[ ! -d "$status_dir" ]]; then
+        return 0
+    fi
+
+    echo "workers:"
+    for status_file in "$status_dir"/*.json; do
+        if [[ -f "$status_file" && ! -L "$status_file" ]]; then
+            local agent status task message updated updated_epoch age stale_marker
+
+            # Parse JSON status file
+            agent=$(jq -r '.agent // "unknown"' "$status_file" 2>/dev/null)
+            status=$(jq -r '.status // "unknown"' "$status_file" 2>/dev/null)
+            task=$(jq -r '.task // ""' "$status_file" 2>/dev/null)
+            message=$(jq -r '.message // ""' "$status_file" 2>/dev/null | head -c 80)
+            updated=$(jq -r '.updated // ""' "$status_file" 2>/dev/null)
+
+            # Check if stale (not updated in 5+ minutes)
+            stale_marker=""
+            if [[ -n "$updated" ]]; then
+                # Convert ISO timestamp to epoch (cross-platform)
+                updated_epoch=$(date -d "$updated" +%s 2>/dev/null || date -j -f "%Y-%m-%dT%H:%M:%S" "${updated%Z}" +%s 2>/dev/null || echo "0")
+                age=$((now_epoch - updated_epoch))
+                if [[ "$age" -gt "$stale_threshold" ]]; then
+                    stale_marker=" (stale)"
+                fi
+            fi
+
+            echo "  - agent: $agent"
+            echo "    status: $status$stale_marker"
+            if [[ -n "$task" ]]; then
+                echo "    task: $task"
+            fi
+            if [[ -n "$message" ]]; then
+                echo "    message: \"$message\""
+            fi
+            echo "    updated: $updated"
+        fi
+    done
+}
+
 # =============================================================================
 # Daemon Functions
 # =============================================================================
 
 update_state() {
     # Count tasks in each folder (using find with -maxdepth for safety)
-    local pending in_progress completed review approved needs_changes merged
+    local pending in_progress completed review approved needs_changes merged attention
     pending=$(find "$FORGE_ROOT/$TASKS_PENDING" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
     in_progress=$(find "$FORGE_ROOT/$TASKS_IN_PROGRESS" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
     completed=$(find "$FORGE_ROOT/$TASKS_COMPLETED" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
@@ -205,9 +320,22 @@ update_state() {
     approved=$(find "$FORGE_ROOT/$TASKS_APPROVED" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
     needs_changes=$(find "$FORGE_ROOT/$TASKS_NEEDS_CHANGES" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
     merged=$(find "$FORGE_ROOT/$TASKS_MERGED" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
+    attention=$(find "$FORGE_ROOT/$TASKS_ATTENTION" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
 
     local blocked=0
 
+    # Build attention details if any workers need help
+    local attention_details=""
+    if [[ "$attention" -gt 0 ]]; then
+        attention_details=$(build_attention_details)
+    fi
+
+    # Build worker status from agent-status files
+    local worker_status=""
+    if [[ -d "$FORGE_ROOT/$AGENT_STATUS_DIR" ]]; then
+        worker_status=$(build_worker_status)
+    fi
+
     # Write state file atomically (write to temp, then move)
     local temp_state="${STATE_FILE}.tmp.$$"
     cat > "$temp_state" << EOF
@@ -228,12 +356,33 @@ tasks:
   needs_changes: $needs_changes
   merged: $merged
   blocked: $blocked
+  attention_needed: $attention
 
+$attention_details
+$worker_status
 last_updated: $(date -Iseconds)
 EOF
     mv "$temp_state" "$STATE_FILE"
 }
 
+build_attention_details() {
+    echo "attention:"
+    for attention_file in "$FORGE_ROOT/$TASKS_ATTENTION"/*.md; do
+        if [[ -f "$attention_file" && ! -L "$attention_file" ]]; then
+            local agent created issue
+            agent=$(grep -m1 "^agent:" "$attention_file" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | head -c 50)
+            created=$(grep -m1 "^created:" "$attention_file" 2>/dev/null | cut -d':' -f2- | tr -d ' ' | head -c 30)
+            # Get the issue line (first ## heading content or fallback)
+            issue=$(sed -n '/^## Issue/,/^##/p' "$attention_file" 2>/dev/null | grep -v "^##" | head -1 | tr -d '\n' | head -c 100)
+            issue="${issue:-Needs attention}"
+
+            echo "  - agent: $agent"
+            echo "    since: $created"
+            echo "    issue: \"$issue\""
+        fi
+    done
+}
+
 route_completed_to_review() {
     # Move completed tasks to review queue
     for task in "$FORGE_ROOT/$TASKS_COMPLETED"/*.md; do
@@ -275,6 +424,9 @@ daemon_loop() {
         # Check for new tasks and notify
         check_new_pending_tasks
 
+        # Check for workers needing attention (urgent)
+        check_attention_needed
+
         # Route tasks
         route_completed_to_review
         route_approved_to_merged
@@ -334,6 +486,8 @@ cmd_start() {
     mkdir -p "$FORGE_ROOT/$TASKS_APPROVED"
     mkdir -p "$FORGE_ROOT/$TASKS_NEEDS_CHANGES"
     mkdir -p "$FORGE_ROOT/$TASKS_MERGED"
+    mkdir -p "$FORGE_ROOT/$TASKS_ATTENTION"
+    mkdir -p "$FORGE_ROOT/$AGENT_STATUS_DIR"
 
     # Start daemon in background
     daemon_loop &
@@ -394,11 +548,76 @@ cmd_status() {
 
     if [[ -f "$STATE_FILE" ]]; then
         echo "Task Counts:"
-        grep -E "pending:|in_progress:|completed:|in_review:|approved:|needs_changes:|merged:" "$STATE_FILE" | sed 's/^/  /'
+        grep -E "pending:|in_progress:|completed:|in_review:|approved:|needs_changes:|merged:|attention_needed:" "$STATE_FILE" | sed 's/^/  /'
     fi
 
     echo ""
 
+    # Show attention-needed workers prominently
+    local attention_count
+    attention_count=$(find "$FORGE_ROOT/$TASKS_ATTENTION" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
+    if [[ "$attention_count" -gt 0 ]]; then
+        echo -e "${RED}🔔 ATTENTION NEEDED:${NC}"
+        for attention_file in "$FORGE_ROOT/$TASKS_ATTENTION"/*.md; do
+            if [[ -f "$attention_file" && ! -L "$attention_file" ]]; then
+                local agent issue
+                agent=$(grep -m1 "^agent:" "$attention_file" 2>/dev/null | cut -d':' -f2 | tr -d ' "' | head -c 50)
+                issue=$(sed -n '/^## Issue/,/^##/p' "$attention_file" 2>/dev/null | grep -v "^##" | head -1 | head -c 80)
+                echo -e "  ${YELLOW}$agent${NC}: $issue"
+            fi
+        done
+        echo ""
+    fi
+
+    # Show worker status
+    if [[ -d "$FORGE_ROOT/$AGENT_STATUS_DIR" ]]; then
+        local status_count
+        status_count=$(find "$FORGE_ROOT/$AGENT_STATUS_DIR" -maxdepth 1 -name "*.json" -type f 2>/dev/null | wc -l)
+        if [[ "$status_count" -gt 0 ]]; then
+            echo "Active Workers:"
+            local now_epoch stale_threshold
+            now_epoch=$(date +%s)
+            stale_threshold=300
+            for status_file in "$FORGE_ROOT/$AGENT_STATUS_DIR"/*.json; do
+                if [[ -f "$status_file" && ! -L "$status_file" ]]; then
+                    local agent status task updated stale_marker icon
+                    agent=$(jq -r '.agent // "unknown"' "$status_file" 2>/dev/null)
+                    status=$(jq -r '.status // "unknown"' "$status_file" 2>/dev/null)
+                    task=$(jq -r '.task // ""' "$status_file" 2>/dev/null)
+                    updated=$(jq -r '.updated // ""' "$status_file" 2>/dev/null)
+
+                    # Check staleness
+                    stale_marker=""
+                    if [[ -n "$updated" ]]; then
+                        local updated_epoch age
+                        updated_epoch=$(date -d "$updated" +%s 2>/dev/null || date -j -f "%Y-%m-%dT%H:%M:%S" "${updated%Z}" +%s 2>/dev/null || echo "0")
+                        age=$((now_epoch - updated_epoch))
+                        if [[ "$age" -gt "$stale_threshold" ]]; then
+                            stale_marker=" ${YELLOW}(stale)${NC}"
+                        fi
+                    fi
+
+                    # Status icon
+                    case "$status" in
+                        "working") icon="🔨" ;;
+                        "idle") icon="💤" ;;
+                        "blocked") icon="🚫" ;;
+                        "testing") icon="🧪" ;;
+                        "reviewing") icon="👁️" ;;
+                        *) icon="❓" ;;
+                    esac
+
+                    if [[ -n "$task" ]]; then
+                        echo -e "  $icon ${CYAN}$agent${NC}: $status ($task)$stale_marker"
+                    else
+                        echo -e "  $icon ${CYAN}$agent${NC}: $status$stale_marker"
+                    fi
+                fi
+            done
+            echo ""
+        fi
+    fi
+
     # Show recent notifications
     if [[ -f "$NOTIFY_FILE" ]]; then
         local notify_count

package/bin/forge-setup.sh

@@ -304,6 +304,48 @@ configure_daemon() {
     fi
 }
 
+# =============================================================================
+# STEP 7b: Configure Worker Loop (Persistent Mode)
+# =============================================================================
+
+configure_worker_loop() {
+    echo ""
+    echo "Worker Loop Configuration"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "Worker Loop keeps agents running continuously."
+    echo "When a worker finishes a task, it automatically checks for new work"
+    echo "instead of exiting. Great for longer coding sessions."
+    echo ""
+
+    local enable_worker_loop="n"
+
+    if [[ "$NON_INTERACTIVE" == "false" ]]; then
+        read -p "Enable persistent worker mode? (y/N): " choice
+        if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
+            enable_worker_loop="y"
+        fi
+    fi
+
+    # Update config with worker loop preference
+    local config_file="$FORGE_ROOT/.forge/config.json"
+    if [[ -f "$config_file" ]]; then
+        # Add worker_loop_enabled to config
+        sed -i 's/"daemon_enabled": \(true\|false\)/"daemon_enabled": \1,\n    "worker_loop_enabled": '"$( [[ "$enable_worker_loop" == "y" ]] && echo "true" || echo "false" )"'/' "$config_file" 2>/dev/null || true
+    fi
+
+    if [[ "$enable_worker_loop" == "y" ]]; then
+        echo ""
+        echo -e "${GREEN}✅ Worker Loop enabled${NC}"
+        echo "   Workers will keep running and check for new tasks"
+    else
+        echo ""
+        echo -e "${YELLOW}ℹ️  Worker Loop disabled${NC}"
+        echo "   Workers will exit after completing their tasks"
+        echo "   Enable later with: forge config worker-loop on"
+    fi
+}
+
 # =============================================================================
 # STEP 8: Install Slash Command
 # =============================================================================
@@ -476,6 +518,7 @@ main() {
     if validate_setup; then
         configure_terminal
         configure_daemon
+        configure_worker_loop
         install_slash_command
         create_project_context
         setup_complete

package/bin/forge-spawn.sh

@@ -31,7 +31,9 @@ source "$SCRIPT_DIR/lib/agents.sh"
 
 # Load agent configuration from JSON if available
 if [[ -f "$FORGE_ROOT/$AGENTS_CONFIG" ]]; then
-    load_agents_from_json "$FORGE_ROOT/$AGENTS_CONFIG" 2>/dev/null || true
+    if ! load_agents_from_json "$FORGE_ROOT/$AGENTS_CONFIG" 2>/dev/null; then
+        log_warn "Failed to load agents.json, using fallback defaults"
+    fi
 fi
 
 # =============================================================================
@@ -44,9 +46,17 @@ spawn_windows_terminal() {
     log_info "Spawning $agent in Windows Terminal..."
 
     if command -v wt &> /dev/null || command -v wt.exe &> /dev/null; then
-        # Get display name for tab title
-        local display_name
+        # Get display info for tab
+        local display_name icon tab_color
         display_name=$(get_agent_display_name "$agent")
+        icon=$(get_agent_icon "$agent")
+        tab_color=$(get_agent_tab_color "$agent")
+
+        # Build tab title with icon
+        local tab_title="$display_name"
+        if [[ -n "$icon" ]]; then
+            tab_title="$icon $display_name"
+        fi
 
         # Convert FORGE_ROOT to Windows path for wt.exe
         # Git Bash paths like /c/foo become C:/foo
@@ -57,15 +67,21 @@ spawn_windows_terminal() {
             win_forge_root="$FORGE_ROOT"
         fi
 
+        # Build wt command with optional tab color
+        local wt_args=(-w 0 new-tab --title "$tab_title")
+        if [[ -n "$tab_color" ]]; then
+            wt_args+=(--tabColor "$tab_color")
+        fi
+
         # Windows Terminal: open new tab with forge command
         # SECURITY: $agent has already been validated through resolve_agent
         if [[ -n "$GIT_BASH_PATH" ]]; then
             local bash_path="${GIT_BASH_PATH//\//\\}"
-            wt.exe -w 0 new-tab --title "$display_name" "$bash_path" -c "cd \"$win_forge_root\" && ./bin/forge.sh start \"$agent\""
+            wt.exe "${wt_args[@]}" "$bash_path" -c "cd \"$win_forge_root\" && ./bin/forge.sh start \"$agent\""
         else
-            wt.exe -w 0 new-tab --title "$display_name" bash -c "cd \"$win_forge_root\" && ./bin/forge.sh start \"$agent\""
+            wt.exe "${wt_args[@]}" bash -c "cd \"$win_forge_root\" && ./bin/forge.sh start \"$agent\""
         fi
-        log_success "$display_name spawned in new Windows Terminal tab"
+        log_success "$tab_title spawned in new Windows Terminal tab"
     else
         log_error "wt command not found."
         echo "Make sure Windows Terminal is installed."
@@ -123,7 +139,9 @@ main() {
     require_forge_config "$FORGE_ROOT"
 
     echo ""
-    log_header "🔥 Forge Spawn: $(get_agent_display_name "$resolved")"
+    local icon
+    icon=$(get_agent_icon "$resolved")
+    log_header "${icon:-🔥} Forge Spawn: $(get_agent_display_name "$resolved")"
     if [[ "$agent" != "$resolved" ]]; then
         echo "   (resolved from '$agent')"
     fi

package/bin/forge.sh

@@ -41,7 +41,9 @@ source "$SCRIPT_DIR/lib/agents.sh"
 # Load agent configuration from JSON if available
 # This overwrites the fallback values in constants.sh
 if [[ -f "$FORGE_ROOT/$AGENTS_CONFIG" ]]; then
-    load_agents_from_json "$FORGE_ROOT/$AGENTS_CONFIG" 2>/dev/null || true
+    if ! load_agents_from_json "$FORGE_ROOT/$AGENTS_CONFIG" 2>/dev/null; then
+        log_warn "Failed to load agents.json, using fallback defaults"
+    fi
 fi
 
 # =============================================================================
@@ -116,7 +118,13 @@ On startup, you MUST immediately display the team assembly welcome as shown in t
 
 # Startup Instructions
 
-On startup: Announce yourself (name, icon, role), check tasks/pending/ and tasks/needs-changes/ for your work, summarize what you find, and ask if you should begin.
+On startup:
+1. Announce yourself briefly (icon, name, role)
+2. Check tasks/pending/ and tasks/needs-changes/ for tasks assigned to you
+3. If you find assigned tasks, IMMEDIATELY begin working on them (no confirmation needed)
+4. If no tasks found, announce you're idle and ready for work
+
+You are autonomous - when assigned work exists, start it without asking permission.
 "
     fi
 
@@ -233,6 +241,73 @@ cmd_daemon() {
     esac
 }
 
+cmd_config() {
+    local setting="${1:-}"
+    local value="${2:-}"
+    local config_file="$FORGE_ROOT/.forge/config.json"
+
+    if [[ ! -f "$config_file" ]]; then
+        log_error "Forge not initialized. Run 'forge init' first."
+        exit 1
+    fi
+
+    case "$setting" in
+        "worker-loop"|"loop")
+            case "$value" in
+                "on"|"true"|"1"|"enable"|"enabled")
+                    # Enable worker loop
+                    if jq -e '.worker_loop_enabled' "$config_file" > /dev/null 2>&1; then
+                        jq '.worker_loop_enabled = true' "$config_file" > "$config_file.tmp" && mv "$config_file.tmp" "$config_file"
+                    else
+                        jq '. + {worker_loop_enabled: true}' "$config_file" > "$config_file.tmp" && mv "$config_file.tmp" "$config_file"
+                    fi
+                    log_success "Worker Loop enabled"
+                    echo "Workers will now keep running to check for new tasks."
+                    ;;
+                "off"|"false"|"0"|"disable"|"disabled")
+                    # Disable worker loop
+                    if jq -e '.worker_loop_enabled' "$config_file" > /dev/null 2>&1; then
+                        jq '.worker_loop_enabled = false' "$config_file" > "$config_file.tmp" && mv "$config_file.tmp" "$config_file"
+                    else
+                        jq '. + {worker_loop_enabled: false}' "$config_file" > "$config_file.tmp" && mv "$config_file.tmp" "$config_file"
+                    fi
+                    log_success "Worker Loop disabled"
+                    echo "Workers will exit after completing their tasks."
+                    ;;
+                ""|"status")
+                    # Show current status
+                    local current
+                    current=$(jq -r '.worker_loop_enabled // false' "$config_file")
+                    if [[ "$current" == "true" ]]; then
+                        echo "Worker Loop: enabled"
+                    else
+                        echo "Worker Loop: disabled"
+                    fi
+                    ;;
+                *)
+                    echo "Usage: forge config worker-loop [on|off|status]"
+                    ;;
+            esac
+            ;;
+        "")
+            # Show all config
+            echo ""
+            log_header "Forge Configuration"
+            echo ""
+            jq '.' "$config_file"
+            echo ""
+            ;;
+        *)
+            log_error "Unknown setting: $setting"
+            echo ""
+            echo "Available settings:"
+            echo "  worker-loop    Toggle persistent worker mode (on/off)"
+            echo ""
+            echo "Usage: forge config <setting> [value]"
+            ;;
+    esac
+}
+
 cmd_help() {
     echo ""
     log_header "🔥 Vibe Forge"
@@ -247,17 +322,15 @@ cmd_help() {
     echo "  status              Show current forge status"
     echo "  test                Validate setup is working"
     echo "  daemon <action>     Manage background daemon (start|stop|status|notifications|clear)"
+    echo "  config <setting>    View or change configuration settings"
     echo "  help                Show this help message"
     echo ""
-    echo "Agents (with aliases):"
-    echo "  anvil     (frontend, ui, fe)      - Frontend Developer"
-    echo "  furnace   (backend, api, be)      - Backend Developer"
-    echo "  crucible  (test, testing, qa)     - Tester / QA"
-    echo "  sentinel  (review, reviewer, cr)  - Code Reviewer"
-    echo "  scribe    (docs, documentation)   - Documentation"
-    echo "  herald    (release, deploy)       - Release Manager"
-    echo "  ember     (devops, ops, infra)    - DevOps"
-    echo "  aegis     (security, sec, appsec) - Security"
+    show_available_agents
+    echo ""
+    echo "Configuration:"
+    echo "  forge config                    Show all settings"
+    echo "  forge config worker-loop on     Enable persistent worker mode"
+    echo "  forge config worker-loop off    Disable persistent worker mode"
     echo ""
     echo "Examples:"
     echo "  forge               Start Planning Hub"
@@ -298,6 +371,10 @@ main() {
             shift
             cmd_daemon "$@"
             ;;
+        "config")
+            shift
+            cmd_config "$@"
+            ;;
         "help"|"--help"|"-h")
             cmd_help
             ;;