@revotools/cli 0.2.0

package/dist/revo

@@ -0,0 +1,3263 @@
+#!/usr/bin/env bash
+# Revo CLI - Claude-first multi-repo workspace manager
+# https://github.com/marcus.salinas/revo
+# This is a bundled distribution - do not edit
+
+set -euo pipefail
+
+# Exit cleanly on SIGPIPE (e.g., revo clone | grep, revo status | head)
+trap 'exit 0' PIPE
+
+REVO_VERSION="0.2.0"
+
+
+# === lib/ui.sh ===
+# Revo CLI - UI Components (Clack-style)
+# Provides terminal UI primitives with Unicode/ASCII fallback
+
+# Detect color support
+if [[ -t 1 ]] && [[ "${TERM:-}" != "dumb" ]]; then
+    UI_COLOR=1
+else
+    UI_COLOR=0
+fi
+
+# Detect Unicode support
+if [[ "${LANG:-}" == *UTF-8* ]] || [[ "${LC_ALL:-}" == *UTF-8* ]]; then
+    UI_UNICODE=1
+else
+    UI_UNICODE=0
+fi
+
+# --- Symbols ---
+if [[ "$UI_UNICODE" -eq 1 ]]; then
+    S_STEP_ACTIVE="◆"
+    S_STEP_DONE="◇"
+    S_STEP_ERROR="▲"
+    S_STEP_CANCEL="■"
+    S_BAR="│"
+    S_BAR_START="┌"
+    S_BAR_END="└"
+    S_SPINNER_FRAMES=("◒" "◐" "◓" "◑")
+    S_CHECKBOX_ON="◼"
+    S_CHECKBOX_OFF="◻"
+    S_RADIO_ON="●"
+    S_RADIO_OFF="○"
+else
+    S_STEP_ACTIVE="*"
+    S_STEP_DONE="+"
+    S_STEP_ERROR="!"
+    S_STEP_CANCEL="x"
+    S_BAR="|"
+    S_BAR_START="/"
+    S_BAR_END="\\"
+    S_SPINNER_FRAMES=("-" "\\" "|" "/")
+    S_CHECKBOX_ON="[x]"
+    S_CHECKBOX_OFF="[ ]"
+    S_RADIO_ON="(*)"
+    S_RADIO_OFF="( )"
+fi
+
+# --- Colors ---
+ui_reset() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[0m' || true
+}
+
+ui_cyan() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[36m%s\033[0m' "$1" || printf '%s' "$1"
+}
+
+ui_green() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[32m%s\033[0m' "$1" || printf '%s' "$1"
+}
+
+ui_yellow() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[33m%s\033[0m' "$1" || printf '%s' "$1"
+}
+
+ui_red() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[31m%s\033[0m' "$1" || printf '%s' "$1"
+}
+
+ui_dim() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[2m%s\033[0m' "$1" || printf '%s' "$1"
+}
+
+ui_bold() {
+    [[ "$UI_COLOR" -eq 1 ]] && printf '\033[1m%s\033[0m' "$1" || printf '%s' "$1"
+}
+
+# --- Bar Components ---
+ui_bar() {
+    ui_dim "$S_BAR"
+}
+
+ui_bar_start() {
+    ui_dim "$S_BAR_START"
+}
+
+ui_bar_end() {
+    ui_dim "$S_BAR_END"
+}
+
+# --- Layout Components ---
+
+# Intro: Start of a section
+# Usage: ui_intro "Title"
+ui_intro() {
+    local title="$1"
+    printf '%s  %s\n' "$(ui_bar_start)" "$(ui_cyan "$title")"
+    printf '%s\n' "$(ui_bar)"
+}
+
+# Outro: End of a section
+# Usage: ui_outro "Message"
+ui_outro() {
+    local message="$1"
+    printf '%s\n' "$(ui_bar)"
+    printf '%s  %s\n' "$(ui_bar_end)" "$(ui_green "$message")"
+}
+
+# Outro with cancel
+ui_outro_cancel() {
+    local message="$1"
+    printf '%s\n' "$(ui_bar)"
+    printf '%s  %s\n' "$(ui_bar_end)" "$(ui_red "$message")"
+}
+
+# Step: Active prompt
+# Usage: ui_step "Label"
+ui_step() {
+    local label="$1"
+    printf '%s  %s\n' "$(ui_cyan "$S_STEP_ACTIVE")" "$label"
+}
+
+# Step done: Completed step
+# Usage: ui_step_done "Label" "value"
+ui_step_done() {
+    local label="$1"
+    local value="${2:-}"
+    if [[ -n "$value" ]]; then
+        printf '%s  %s %s\n' "$(ui_green "$S_STEP_DONE")" "$label" "$(ui_dim "$value")"
+    else
+        printf '%s  %s\n' "$(ui_green "$S_STEP_DONE")" "$label"
+    fi
+}
+
+# Step error
+ui_step_error() {
+    local message="$1"
+    printf '%s  %s\n' "$(ui_yellow "$S_STEP_ERROR")" "$(ui_yellow "$message")"
+}
+
+# Step cancel
+ui_step_cancel() {
+    local message="$1"
+    printf '%s  %s\n' "$(ui_red "$S_STEP_CANCEL")" "$(ui_red "$message")"
+}
+
+# Info line (continuation)
+ui_info() {
+    local message="$1"
+    printf '%s  %s\n' "$(ui_bar)" "$message"
+}
+
+# Empty bar line
+ui_bar_line() {
+    printf '%s\n' "$(ui_bar)"
+}
+
+# --- Interactive Components ---
+
+# Text input
+# Usage: result=$(ui_text "Prompt" "default")
+# Returns: user input or default
+ui_text() {
+    local prompt="$1"
+    local default="${2:-}"
+    local input
+
+    ui_step "$prompt"
+    if [[ -n "$default" ]]; then
+        printf '%s  ' "$(ui_bar)"
+        read -r -p "" -e -i "$default" input
+    else
+        printf '%s  ' "$(ui_bar)"
+        read -r input
+    fi
+
+    # Return default if empty
+    if [[ -z "$input" ]]; then
+        input="$default"
+    fi
+
+    printf '%s' "$input"
+}
+
+# Confirm (y/n)
+# Usage: if ui_confirm "Question?"; then ... fi
+ui_confirm() {
+    local prompt="$1"
+    local default="${2:-y}"
+    local hint
+    local response
+
+    if [[ "$default" == "y" ]]; then
+        hint="Y/n"
+    else
+        hint="y/N"
+    fi
+
+    ui_step "$prompt ($hint)"
+    printf '%s  ' "$(ui_bar)"
+    read -r -n 1 response
+    printf '\n'
+
+    # Handle empty (use default)
+    if [[ -z "$response" ]]; then
+        response="$default"
+    fi
+
+    [[ "$response" =~ ^[Yy]$ ]]
+}
+
+# Select from options
+# Usage: result=$(ui_select "Prompt" "opt1" "opt2" "opt3")
+# Returns: selected option
+ui_select() {
+    local prompt="$1"
+    shift
+    local options=("$@")
+    local selected=0
+    local count=${#options[@]}
+    local key
+
+    ui_step "$prompt"
+
+    # Save cursor position and hide cursor
+    printf '\033[?25l'
+
+    while true; do
+        # Draw options
+        for i in "${!options[@]}"; do
+            if [[ $i -eq $selected ]]; then
+                printf '%s  %s %s\n' "$(ui_bar)" "$(ui_cyan "$S_RADIO_ON")" "${options[$i]}"
+            else
+                printf '%s  %s %s\n' "$(ui_bar)" "$(ui_dim "$S_RADIO_OFF")" "$(ui_dim "${options[$i]}")"
+            fi
+        done
+
+        # Read key
+        read -rsn1 key
+
+        # Handle arrow keys (escape sequences)
+        if [[ "$key" == $'\033' ]]; then
+            read -rsn2 key
+            case "$key" in
+                '[A') # Up
+                    ((selected > 0)) && ((selected--))
+                    ;;
+                '[B') # Down
+                    ((selected < count - 1)) && selected=$((selected + 1))
+                    ;;
+            esac
+        elif [[ "$key" == "" ]]; then
+            # Enter pressed
+            break
+        elif [[ "$key" == "j" ]]; then
+            ((selected < count - 1)) && selected=$((selected + 1))
+        elif [[ "$key" == "k" ]]; then
+            ((selected > 0)) && ((selected--))
+        fi
+
+        # Move cursor up to redraw
+        printf '\033[%dA' "$count"
+    done
+
+    # Show cursor
+    printf '\033[?25h'
+
+    printf '%s' "${options[$selected]}"
+}
+
+# --- Spinner ---
+# Usage:
+#   ui_spinner_start "Loading..."
+#   ... do work ...
+#   ui_spinner_stop "Done!" # or ui_spinner_stop
+_SPINNER_PID=""
+_SPINNER_MSG=""
+
+ui_spinner_start() {
+    local message="$1"
+    _SPINNER_MSG="$message"
+
+    # Skip spinner animation when stdout is not a terminal (piped/redirected)
+    if [[ ! -t 1 ]]; then
+        return
+    fi
+
+    (
+        local i=0
+        local frame_count=${#S_SPINNER_FRAMES[@]}
+
+        while true; do
+            printf '\r%s  %s %s' "$(ui_bar)" "$(ui_cyan "${S_SPINNER_FRAMES[$i]}")" "$message"
+            ((i = (i + 1) % frame_count))
+            sleep 0.1
+        done
+    ) &
+    _SPINNER_PID=$!
+
+    # Ensure cleanup on script exit
+    trap 'ui_spinner_stop 2>/dev/null' EXIT
+}
+
+ui_spinner_stop() {
+    local final_message="${1:-}"
+
+    if [[ -n "$_SPINNER_PID" ]] && kill -0 "$_SPINNER_PID" 2>/dev/null; then
+        kill "$_SPINNER_PID" 2>/dev/null
+        wait "$_SPINNER_PID" 2>/dev/null || true
+    fi
+    _SPINNER_PID=""
+
+    # Clear spinner line only when connected to a terminal
+    if [[ -t 1 ]]; then
+        printf '\r\033[K'
+    fi
+
+    # Show final message if provided
+    if [[ -n "$final_message" ]]; then
+        ui_step_done "$final_message"
+    fi
+}
+
+ui_spinner_error() {
+    local message="$1"
+
+    if [[ -n "$_SPINNER_PID" ]] && kill -0 "$_SPINNER_PID" 2>/dev/null; then
+        kill "$_SPINNER_PID" 2>/dev/null
+        wait "$_SPINNER_PID" 2>/dev/null || true
+    fi
+    _SPINNER_PID=""
+
+    if [[ -t 1 ]]; then
+        printf '\r\033[K'
+    fi
+    ui_step_error "$message"
+}
+
+# --- Progress ---
+# Usage: ui_progress "message" current total
+ui_progress() {
+    local message="$1"
+    local current="$2"
+    local total="$3"
+    local percent=$((current * 100 / total))
+    local bar_width=20
+    local filled=$((percent * bar_width / 100))
+    local empty=$((bar_width - filled))
+
+    printf '\r%s  ' "$(ui_bar)"
+    printf '%s [' "$message"
+    printf '%*s' "$filled" '' | tr ' ' '='
+    printf '%*s' "$empty" '' | tr ' ' ' '
+    printf '] %d%%' "$percent"
+}
+
+# --- ANSI-aware padding ---
+
+_ui_visible_len() {
+    local str="$1"
+    local stripped
+    stripped=$(printf '%s' "$str" | sed $'s/\033\\[[0-9;]*m//g')
+    printf '%d' "${#stripped}"
+}
+
+_ui_pad() {
+    local str="$1"
+    local target_width="$2"
+    local visible_len
+    visible_len=$(_ui_visible_len "$str")
+    local pad=$((target_width - visible_len))
+    [[ $pad -lt 0 ]] && pad=0
+    printf '%s%*s' "$str" "$pad" ""
+}
+
+# --- Table ---
+# Usage: ui_table_widths 24 20 12 14
+#        ui_table_header "Col1" "Col2" "Col3" "Col4"
+#        ui_table_row "val1" "val2" "val3" "val4"
+_TABLE_COL_WIDTHS=()
+
+ui_table_widths() {
+    _TABLE_COL_WIDTHS=("$@")
+}
+
+ui_table_header() {
+    local cols=("$@")
+    local i=0
+
+    printf '%s  ' "$(ui_bar)"
+    for col in "${cols[@]}"; do
+        local w="${_TABLE_COL_WIDTHS[$i]:-20}"
+        local padded
+        padded=$(printf "%-${w}s" "$col")
+        printf '%s' "$(ui_bold "$padded")"
+        i=$((i + 1))
+    done
+    printf '\n'
+
+    # Separator
+    printf '%s  ' "$(ui_bar)"
+    i=0
+    for _ in "${cols[@]}"; do
+        local w="${_TABLE_COL_WIDTHS[$i]:-20}"
+        local dashes=""
+        local j=0
+        while [[ $j -lt $w ]]; do
+            dashes+="─"
+            j=$((j + 1))
+        done
+        printf '%s' "$(ui_dim "$dashes")"
+        i=$((i + 1))
+    done
+    printf '\n'
+}
+
+ui_table_row() {
+    local vals=("$@")
+    local i=0
+
+    printf '%s  ' "$(ui_bar)"
+    for val in "${vals[@]}"; do
+        local w="${_TABLE_COL_WIDTHS[$i]:-20}"
+        _ui_pad "$val" "$w"
+        i=$((i + 1))
+    done
+    printf '\n'
+}
+
+# --- Utilities ---
+
+# Clear line
+ui_clear_line() {
+    printf '\r\033[K'
+}
+
+# Move cursor up N lines
+ui_cursor_up() {
+    local n="${1:-1}"
+    printf '\033[%dA' "$n"
+}
+
+# Hide cursor
+ui_cursor_hide() {
+    printf '\033[?25l'
+}
+
+# Show cursor
+ui_cursor_show() {
+    printf '\033[?25h'
+}
+
+# Ensure cursor is shown on exit
+trap 'ui_cursor_show' EXIT
+
+# === lib/yaml.sh ===
+# Revo CLI - Minimal YAML Parser
+# Parses revo.yaml (and legacy mars.yaml) format only - not a general YAML parser
+# Compatible with bash 3.2+ (no associative arrays)
+
+# Global state - using parallel indexed arrays instead of associative arrays
+YAML_WORKSPACE_NAME=""
+YAML_DEFAULTS_BRANCH=""
+YAML_REPO_COUNT=0
+
+# Arrays indexed by repo number (0, 1, 2, ...)
+# Access: ${YAML_REPO_URLS[$i]}
+YAML_REPO_URLS=()
+YAML_REPO_PATHS=()
+YAML_REPO_TAGS=()
+YAML_REPO_DEPS=()
+
+yaml_parse() {
+    local file="$1"
+    local line
+    local in_repos=0
+    local in_defaults=0
+    local current_index=-1
+
+    # Reset state
+    YAML_WORKSPACE_NAME=""
+    YAML_DEFAULTS_BRANCH="main"
+    YAML_REPO_COUNT=0
+    YAML_REPO_URLS=()
+    YAML_REPO_PATHS=()
+    YAML_REPO_TAGS=()
+    YAML_REPO_DEPS=()
+
+    if [[ ! -f "$file" ]]; then
+        return 1
+    fi
+
+    while IFS= read -r line || [[ -n "$line" ]]; do
+        # Skip empty lines and comments
+        [[ -z "$line" ]] && continue
+        [[ "$line" =~ ^[[:space:]]*# ]] && continue
+
+        # Remove leading/trailing whitespace for comparison
+        local trimmed="${line#"${line%%[![:space:]]*}"}"
+        trimmed="${trimmed%"${trimmed##*[![:space:]]}"}"
+
+        # Check section markers
+        if [[ "$trimmed" == "repos:" ]]; then
+            in_repos=1
+            in_defaults=0
+            continue
+        elif [[ "$trimmed" == "defaults:" ]]; then
+            in_repos=0
+            in_defaults=1
+            continue
+        elif [[ "$trimmed" == "workspace:" ]]; then
+            in_repos=0
+            in_defaults=0
+            continue
+        fi
+
+        # Parse workspace name
+        if [[ "$trimmed" =~ ^name:[[:space:]]*[\"\']?([^\"\']+)[\"\']?$ ]]; then
+            YAML_WORKSPACE_NAME="${BASH_REMATCH[1]}"
+            continue
+        fi
+
+        # Parse defaults section
+        if [[ $in_defaults -eq 1 ]]; then
+            if [[ "$trimmed" =~ ^branch:[[:space:]]*(.+)$ ]]; then
+                YAML_DEFAULTS_BRANCH="${BASH_REMATCH[1]}"
+            fi
+            continue
+        fi
+
+        # Parse repos section
+        if [[ $in_repos -eq 1 ]]; then
+            # New repo entry (starts with -)
+            if [[ "$trimmed" =~ ^-[[:space:]]*url:[[:space:]]*(.+)$ ]]; then
+                current_index=$((current_index + 1))
+                local url="${BASH_REMATCH[1]}"
+                YAML_REPO_URLS[$current_index]="$url"
+                YAML_REPO_PATHS[$current_index]=$(yaml_path_from_url "$url")
+                YAML_REPO_TAGS[$current_index]=""
+                YAML_REPO_DEPS[$current_index]=""
+                YAML_REPO_COUNT=$((YAML_REPO_COUNT + 1))
+                continue
+            fi
+
+            # Continuation of current repo
+            if [[ $current_index -ge 0 ]]; then
+                if [[ "$trimmed" =~ ^path:[[:space:]]*(.+)$ ]]; then
+                    YAML_REPO_PATHS[$current_index]="${BASH_REMATCH[1]}"
+                elif [[ "$trimmed" =~ ^tags:[[:space:]]*\[([^\]]*)\]$ ]]; then
+                    # Parse inline array: [tag1, tag2]
+                    local tags_str="${BASH_REMATCH[1]}"
+                    # Remove spaces and quotes
+                    tags_str="${tags_str//[[:space:]]/}"
+                    tags_str="${tags_str//\"/}"
+                    tags_str="${tags_str//\'/}"
+                    YAML_REPO_TAGS[$current_index]="$tags_str"
+                elif [[ "$trimmed" =~ ^depends_on:[[:space:]]*\[([^\]]*)\]$ ]]; then
+                    # Parse inline array: [name1, name2]
+                    local deps_str="${BASH_REMATCH[1]}"
+                    deps_str="${deps_str//[[:space:]]/}"
+                    deps_str="${deps_str//\"/}"
+                    deps_str="${deps_str//\'/}"
+                    YAML_REPO_DEPS[$current_index]="$deps_str"
+                fi
+            fi
+        fi
+    done < "$file"
+
+    return 0
+}
+
+# Extract repo name from URL
+# Usage: yaml_path_from_url "git@github.com:org/repo.git"
+# Returns: "repo"
+yaml_path_from_url() {
+    local url="$1"
+    local name
+
+    # Handle SSH URLs: git@github.com:org/repo.git
+    if [[ "$url" =~ ([^/:]+)\.git$ ]]; then
+        name="${BASH_REMATCH[1]}"
+    # Handle HTTPS URLs: https://github.com/org/repo.git
+    elif [[ "$url" =~ /([^/]+)\.git$ ]]; then
+        name="${BASH_REMATCH[1]}"
+    # Handle URLs without .git
+    elif [[ "$url" =~ ([^/:]+)$ ]]; then
+        name="${BASH_REMATCH[1]}"
+    else
+        name="repo"
+    fi
+
+    printf '%s' "$name"
+}
+
+# Get list of repo indices, optionally filtered by tag
+# Usage: yaml_get_repos [tag]
+# Returns: newline-separated list of indices (0, 1, 2, ...)
+yaml_get_repos() {
+    local filter_tag="${1:-}"
+    local i
+
+    for ((i = 0; i < YAML_REPO_COUNT; i++)); do
+        if [[ -z "$filter_tag" ]]; then
+            printf '%d\n' "$i"
+        else
+            local tags="${YAML_REPO_TAGS[$i]}"
+            # Check if tag is in comma-separated list
+            if [[ ",$tags," == *",$filter_tag,"* ]]; then
+                printf '%d\n' "$i"
+            fi
+        fi
+    done
+}
+
+# Get repo URL by index
+yaml_get_url() {
+    local idx="$1"
+    printf '%s' "${YAML_REPO_URLS[$idx]:-}"
+}
+
+# Get repo path by index
+yaml_get_path() {
+    local idx="$1"
+    printf '%s' "${YAML_REPO_PATHS[$idx]:-}"
+}
+
+# Get repo tags by index
+yaml_get_tags() {
+    local idx="$1"
+    printf '%s' "${YAML_REPO_TAGS[$idx]:-}"
+}
+
+# Get repo depends_on list by index (comma-separated names)
+yaml_get_deps() {
+    local idx="$1"
+    printf '%s' "${YAML_REPO_DEPS[$idx]:-}"
+}
+
+# Find repo index by name (path basename)
+# Usage: idx=$(yaml_find_by_name "backend")
+# Returns: index or -1 if not found
+yaml_find_by_name() {
+    local name="$1"
+    local i
+    for ((i = 0; i < YAML_REPO_COUNT; i++)); do
+        if [[ "${YAML_REPO_PATHS[$i]}" == "$name" ]]; then
+            printf '%d' "$i"
+            return 0
+        fi
+    done
+    printf '%d' -1
+    return 1
+}
+
+# Write revo.yaml
+# Usage: yaml_write "path/to/revo.yaml"
+yaml_write() {
+    local file="$1"
+    local i
+
+    {
+        printf 'version: 1\n\n'
+        printf 'workspace:\n'
+        printf '  name: "%s"\n\n' "$YAML_WORKSPACE_NAME"
+        printf 'repos:\n'
+
+        for ((i = 0; i < YAML_REPO_COUNT; i++)); do
+            local url="${YAML_REPO_URLS[$i]}"
+            local path="${YAML_REPO_PATHS[$i]}"
+            local tags="${YAML_REPO_TAGS[$i]}"
+            local deps="${YAML_REPO_DEPS[$i]:-}"
+
+            printf '  - url: %s\n' "$url"
+
+            # Only write path if different from derived
+            local derived
+            derived=$(yaml_path_from_url "$url")
+            if [[ "$path" != "$derived" ]]; then
+                printf '    path: %s\n' "$path"
+            fi
+
+            # Write tags if present
+            if [[ -n "$tags" ]]; then
+                printf '    tags: [%s]\n' "$tags"
+            fi
+
+            # Write depends_on if present
+            if [[ -n "$deps" ]]; then
+                printf '    depends_on: [%s]\n' "$deps"
+            fi
+        done
+
+        printf '\ndefaults:\n'
+        printf '  branch: %s\n' "$YAML_DEFAULTS_BRANCH"
+    } > "$file"
+}
+
+# Add a repo to the config
+# Usage: yaml_add_repo "url" "path" "tags" "deps"
+yaml_add_repo() {
+    local url="$1"
+    local path="${2:-}"
+    local tags="${3:-}"
+    local deps="${4:-}"
+
+    local idx=$YAML_REPO_COUNT
+
+    YAML_REPO_URLS[$idx]="$url"
+
+    if [[ -z "$path" ]]; then
+        path=$(yaml_path_from_url "$url")
+    fi
+    YAML_REPO_PATHS[$idx]="$path"
+    YAML_REPO_TAGS[$idx]="$tags"
+    YAML_REPO_DEPS[$idx]="$deps"
+
+    YAML_REPO_COUNT=$((YAML_REPO_COUNT + 1))
+}
+
+# === lib/config.sh ===
+# Revo CLI - Configuration Management
+# Handles workspace detection and config loading/saving
+
+REVO_WORKSPACE_ROOT=""
+REVO_CONFIG_FILE=""
+REVO_REPOS_DIR=""
+
+# Find workspace root by searching upward for revo.yaml (or mars.yaml as fallback)
+# Usage: config_find_root [start_dir]
+# Returns: 0 if found (sets REVO_WORKSPACE_ROOT), 1 if not found
+config_find_root() {
+    local start_dir="${1:-$PWD}"
+    local current="$start_dir"
+
+    while [[ "$current" != "/" ]]; do
+        if [[ -f "$current/revo.yaml" ]]; then
+            REVO_WORKSPACE_ROOT="$current"
+            REVO_CONFIG_FILE="$current/revo.yaml"
+            REVO_REPOS_DIR="$current/repos"
+            return 0
+        fi
+        # Fallback: support mars.yaml for migration from Mars
+        if [[ -f "$current/mars.yaml" ]]; then
+            REVO_WORKSPACE_ROOT="$current"
+            REVO_CONFIG_FILE="$current/mars.yaml"
+            REVO_REPOS_DIR="$current/repos"
+            return 0
+        fi
+        current="$(dirname "$current")"
+    done
+
+    return 1
+}
+
+# Initialize workspace in current directory
+# Usage: config_init "workspace_name"
+# Returns: 0 on success, 1 if already initialized
+config_init() {
+    local workspace_name="$1"
+    local dir="${2:-$PWD}"
+
+    if [[ -f "$dir/revo.yaml" ]] || [[ -f "$dir/mars.yaml" ]]; then
+        return 1
+    fi
+
+    REVO_WORKSPACE_ROOT="$dir"
+    REVO_CONFIG_FILE="$dir/revo.yaml"
+    REVO_REPOS_DIR="$dir/repos"
+
+    # Set workspace name for yaml module
+    YAML_WORKSPACE_NAME="$workspace_name"
+    YAML_DEFAULTS_BRANCH="main"
+    YAML_REPO_COUNT=0
+    YAML_REPO_URLS=()
+    YAML_REPO_PATHS=()
+    YAML_REPO_TAGS=()
+    YAML_REPO_DEPS=()
+
+    # Create directory structure
+    mkdir -p "$REVO_REPOS_DIR"
+
+    # Write config
+    yaml_write "$REVO_CONFIG_FILE"
+
+    # Create .gitignore
+    printf 'repos/\n.revo/\n' > "$dir/.gitignore"
+
+    return 0
+}
+
+# Load configuration
+# Usage: config_load
+# Returns: 0 on success, 1 on failure
+config_load() {
+    if [[ -z "$REVO_CONFIG_FILE" ]] || [[ ! -f "$REVO_CONFIG_FILE" ]]; then
+        return 1
+    fi
+
+    yaml_parse "$REVO_CONFIG_FILE"
+}
+
+# Save configuration
+# Usage: config_save
+config_save() {
+    if [[ -z "$REVO_CONFIG_FILE" ]]; then
+        return 1
+    fi
+
+    yaml_write "$REVO_CONFIG_FILE"
+}
+
+# Get repos (optionally filtered by tag)
+# Usage: repos=$(config_get_repos [tag])
+config_get_repos() {
+    local tag="${1:-}"
+    yaml_get_repos "$tag"
+}
+
+# Get repo count
+# Usage: count=$(config_repo_count [tag])
+config_repo_count() {
+    local tag="${1:-}"
+    local count=0
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    while IFS= read -r repo; do
+        [[ -n "$repo" ]] && count=$((count + 1))
+    done <<< "$repos"
+
+    printf '%d' "$count"
+}
+
+# Check if repo directory exists
+# Usage: if config_repo_exists "repo_index"; then ...
+config_repo_exists() {
+    local idx="$1"
+    local path
+    path=$(yaml_get_path "$idx")
+    [[ -d "$REVO_REPOS_DIR/$path" ]]
+}
+
+# Get full path to repo
+# Usage: full_path=$(config_repo_full_path "repo_index")
+config_repo_full_path() {
+    local idx="$1"
+    local path
+    path=$(yaml_get_path "$idx")
+    printf '%s/%s' "$REVO_REPOS_DIR" "$path"
+}
+
+# Require workspace context
+# Usage: config_require_workspace || return 1
+# Prints error and returns 1 if not in workspace
+config_require_workspace() {
+    if ! config_find_root; then
+        printf 'Error: Not in a Revo workspace. Run "revo init" first.\n' >&2
+        return 1
+    fi
+    config_load
+}
+
+# Check if path is inside workspace
+# Usage: if config_is_in_workspace "/some/path"; then ...
+config_is_in_workspace() {
+    local path="$1"
+    [[ "$path" == "$REVO_WORKSPACE_ROOT"* ]]
+}
+
+# Get workspace name
+config_workspace_name() {
+    printf '%s' "$YAML_WORKSPACE_NAME"
+}
+
+# Get default branch
+config_default_branch() {
+    printf '%s' "$YAML_DEFAULTS_BRANCH"
+}
+
+# === lib/git.sh ===
+# Revo CLI - Git Operations
+# Wrapper functions for git commands with consistent error handling
+
+# Result pattern: functions return 0 on success, non-zero on failure
+# Output is captured in global variables to avoid subshell issues
+
+GIT_OUTPUT=""
+GIT_ERROR=""
+
+# Clone a repository
+# Usage: git_clone "url" "target_dir"
+# Returns: 0 on success, 1 on failure
+git_clone() {
+    local url="$1"
+    local target="$2"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ -d "$target" ]]; then
+        GIT_ERROR="Directory already exists: $target"
+        return 1
+    fi
+
+    if GIT_OUTPUT=$(git clone --progress "$url" "$target" 2>&1); then
+        return 0
+    else
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+}
+
+# Get repository status
+# Usage: git_status "repo_dir"
+# Sets: GIT_OUTPUT with status info
+# Returns: 0 on success
+git_status() {
+    local repo_dir="$1"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        GIT_ERROR="Not a git repository: $repo_dir"
+        return 1
+    fi
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" status --porcelain 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Check if repo has uncommitted changes
+# Usage: if git_is_dirty "repo_dir"; then ...
+git_is_dirty() {
+    local repo_dir="$1"
+
+    git_status "$repo_dir" || return 1
+    [[ -n "$GIT_OUTPUT" ]]
+}
+
+# Get current branch name
+# Usage: branch=$(git_current_branch "repo_dir")
+git_current_branch() {
+    local repo_dir="$1"
+
+    git -C "$repo_dir" rev-parse --abbrev-ref HEAD 2>/dev/null
+}
+
+# Create a new branch
+# Usage: git_branch "repo_dir" "branch_name"
+# Returns: 0 on success
+git_branch() {
+    local repo_dir="$1"
+    local branch_name="$2"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        GIT_ERROR="Not a git repository: $repo_dir"
+        return 1
+    fi
+
+    # Check if branch already exists
+    if git -C "$repo_dir" rev-parse --verify "$branch_name" >/dev/null 2>&1; then
+        GIT_ERROR="Branch already exists: $branch_name"
+        return 1
+    fi
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" checkout -b "$branch_name" 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Checkout existing branch
+# Usage: git_checkout "repo_dir" "branch_name"
+# Returns: 0 on success
+git_checkout() {
+    local repo_dir="$1"
+    local branch_name="$2"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        GIT_ERROR="Not a git repository: $repo_dir"
+        return 1
+    fi
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" checkout "$branch_name" 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Pull latest changes
+# Usage: git_pull "repo_dir" [--rebase]
+# Returns: 0 on success
+git_pull() {
+    local repo_dir="$1"
+    local rebase="${2:-}"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        GIT_ERROR="Not a git repository: $repo_dir"
+        return 1
+    fi
+
+    local args=()
+    [[ "$rebase" == "--rebase" ]] && args+=("--rebase")
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" pull "${args[@]}" 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Fetch from remote
+# Usage: git_fetch "repo_dir"
+git_fetch() {
+    local repo_dir="$1"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        GIT_ERROR="Not a git repository: $repo_dir"
+        return 1
+    fi
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" fetch 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Get ahead/behind counts relative to upstream
+# Usage: git_ahead_behind "repo_dir"
+# Sets: GIT_AHEAD, GIT_BEHIND
+GIT_AHEAD=0
+GIT_BEHIND=0
+
+git_ahead_behind() {
+    local repo_dir="$1"
+
+    GIT_AHEAD=0
+    GIT_BEHIND=0
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        return 1
+    fi
+
+    local upstream
+    upstream=$(git -C "$repo_dir" rev-parse --abbrev-ref '@{upstream}' 2>/dev/null) || return 0
+
+    local counts
+    counts=$(git -C "$repo_dir" rev-list --left-right --count "$upstream...HEAD" 2>/dev/null) || return 0
+
+    GIT_BEHIND=$(echo "$counts" | cut -f1)
+    GIT_AHEAD=$(echo "$counts" | cut -f2)
+
+    return 0
+}
+
+# Get remote URL
+# Usage: url=$(git_remote_url "repo_dir")
+git_remote_url() {
+    local repo_dir="$1"
+
+    git -C "$repo_dir" remote get-url origin 2>/dev/null
+}
+
+# Check if branch exists (local or remote)
+# Usage: if git_branch_exists "repo_dir" "branch_name"; then ...
+git_branch_exists() {
+    local repo_dir="$1"
+    local branch_name="$2"
+
+    git -C "$repo_dir" rev-parse --verify "$branch_name" >/dev/null 2>&1 ||
+    git -C "$repo_dir" rev-parse --verify "origin/$branch_name" >/dev/null 2>&1
+}
+
+# Stash changes
+# Usage: git_stash "repo_dir"
+git_stash() {
+    local repo_dir="$1"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" stash 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Pop stash
+# Usage: git_stash_pop "repo_dir"
+git_stash_pop() {
+    local repo_dir="$1"
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" stash pop 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# Get short commit hash
+# Usage: hash=$(git_short_hash "repo_dir")
+git_short_hash() {
+    local repo_dir="$1"
+
+    git -C "$repo_dir" rev-parse --short HEAD 2>/dev/null
+}
+
+# Run arbitrary git command
+# Usage: git_exec "repo_dir" "command" "args..."
+git_exec() {
+    local repo_dir="$1"
+    shift
+    local cmd=("$@")
+
+    GIT_OUTPUT=""
+    GIT_ERROR=""
+
+    if [[ ! -d "$repo_dir/.git" ]]; then
+        GIT_ERROR="Not a git repository: $repo_dir"
+        return 1
+    fi
+
+    if ! GIT_OUTPUT=$(git -C "$repo_dir" "${cmd[@]}" 2>&1); then
+        GIT_ERROR="$GIT_OUTPUT"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/scan.sh ===
+# Revo CLI - Repo Scanner
+# Detects language, framework, routes, and metadata per repo.
+# Uses globals to avoid subshells (bash 3.2 compatibility).
+
+SCAN_NAME=""
+SCAN_LANG=""
+SCAN_FRAMEWORK=""
+SCAN_ROUTES=""
+SCAN_DESCRIPTION=""
+SCAN_HAS_CLAUDE_MD=0
+SCAN_HAS_DOCKER=0
+
+# Reset all SCAN_* globals
+scan_reset() {
+    SCAN_NAME=""
+    SCAN_LANG=""
+    SCAN_FRAMEWORK=""
+    SCAN_ROUTES=""
+    SCAN_DESCRIPTION=""
+    SCAN_HAS_CLAUDE_MD=0
+    SCAN_HAS_DOCKER=0
+}
+
+# Extract a top-level JSON string value from a file.
+# Usage: val=$(_scan_json_string "path/to/file.json" "name")
+# Handles simple cases only; no nested objects.
+_scan_json_string() {
+    local file="$1"
+    local key="$2"
+    local line
+    # Match: "key": "value"  (value may contain escaped chars but no quotes)
+    line=$(grep -m1 -E "\"$key\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" "$file" 2>/dev/null || true)
+    [[ -z "$line" ]] && return 1
+    # Strip to the value
+    line="${line#*\"$key\"}"
+    line="${line#*:}"
+    line="${line#*\"}"
+    line="${line%%\"*}"
+    printf '%s' "$line"
+}
+
+# Returns 0 if the package.json has "dep_name" anywhere in a dependencies block
+_scan_pkg_has_dep() {
+    local file="$1"
+    local dep="$2"
+    grep -q "\"$dep\"[[:space:]]*:" "$file" 2>/dev/null
+}
+
+# Detect framework from package.json dependencies
+_scan_node_framework() {
+    local file="$1"
+    if _scan_pkg_has_dep "$file" "next"; then
+        printf 'Next.js'
+    elif _scan_pkg_has_dep "$file" "nuxt"; then
+        printf 'Nuxt'
+    elif _scan_pkg_has_dep "$file" "@remix-run/react"; then
+        printf 'Remix'
+    elif _scan_pkg_has_dep "$file" "@sveltejs/kit"; then
+        printf 'SvelteKit'
+    elif _scan_pkg_has_dep "$file" "astro"; then
+        printf 'Astro'
+    elif _scan_pkg_has_dep "$file" "vite"; then
+        printf 'Vite'
+    elif _scan_pkg_has_dep "$file" "nestjs" || _scan_pkg_has_dep "$file" "@nestjs/core"; then
+        printf 'NestJS'
+    elif _scan_pkg_has_dep "$file" "fastify"; then
+        printf 'Fastify'
+    elif _scan_pkg_has_dep "$file" "express"; then
+        printf 'Express'
+    elif _scan_pkg_has_dep "$file" "hono"; then
+        printf 'Hono'
+    elif _scan_pkg_has_dep "$file" "react"; then
+        printf 'React'
+    elif _scan_pkg_has_dep "$file" "vue"; then
+        printf 'Vue'
+    elif _scan_pkg_has_dep "$file" "svelte"; then
+        printf 'Svelte'
+    fi
+}
+
+# Detect framework from Python dependency files
+_scan_python_framework() {
+    local repo_dir="$1"
+    local files=()
+    [[ -f "$repo_dir/requirements.txt" ]] && files+=("$repo_dir/requirements.txt")
+    [[ -f "$repo_dir/pyproject.toml" ]] && files+=("$repo_dir/pyproject.toml")
+    [[ -f "$repo_dir/Pipfile" ]] && files+=("$repo_dir/Pipfile")
+
+    [[ ${#files[@]} -eq 0 ]] && return
+
+    if grep -qiE '(^|[^a-z])django([^a-z]|$)' "${files[@]}" 2>/dev/null; then
+        printf 'Django'
+    elif grep -qiE '(^|[^a-z])fastapi([^a-z]|$)' "${files[@]}" 2>/dev/null; then
+        printf 'FastAPI'
+    elif grep -qiE '(^|[^a-z])flask([^a-z]|$)' "${files[@]}" 2>/dev/null; then
+        printf 'Flask'
+    elif grep -qiE '(^|[^a-z])starlette([^a-z]|$)' "${files[@]}" 2>/dev/null; then
+        printf 'Starlette'
+    fi
+}
+
+# List route files in common route directories.
+# Returns comma-separated list (max 6 files, basename only).
+_scan_list_routes() {
+    local repo_dir="$1"
+    local dirs=(
+        "src/routes"
+        "src/api"
+        "src/controllers"
+        "app/api"
+        "app/routes"
+        "routes"
+        "api"
+        "pages/api"
+    )
+
+    local found=()
+    local dir
+    for dir in "${dirs[@]}"; do
+        local full="$repo_dir/$dir"
+        [[ ! -d "$full" ]] && continue
+
+        # Find code files (not tests), max depth 2
+        local file
+        while IFS= read -r file; do
+            [[ -z "$file" ]] && continue
+            [[ "$file" == *".test."* ]] && continue
+            [[ "$file" == *".spec."* ]] && continue
+            found+=("$(basename "$file")")
+            # Cap the number of results
+            [[ ${#found[@]} -ge 6 ]] && break
+        done < <(find "$full" -maxdepth 2 -type f \( -name "*.ts" -o -name "*.js" -o -name "*.tsx" -o -name "*.jsx" -o -name "*.py" -o -name "*.go" -o -name "*.rs" \) 2>/dev/null | sort)
+
+        [[ ${#found[@]} -ge 6 ]] && break
+    done
+
+    # Join as comma-separated
+    local result=""
+    local f
+    for f in "${found[@]}"; do
+        if [[ -z "$result" ]]; then
+            result="$f"
+        else
+            result="$result, $f"
+        fi
+    done
+    printf '%s' "$result"
+}
+
+# First non-empty, non-heading line of README.md (trimmed, first 100 chars)
+_scan_readme_description() {
+    local readme="$1"
+    [[ ! -f "$readme" ]] && return
+
+    local line
+    while IFS= read -r line || [[ -n "$line" ]]; do
+        # Skip empty/whitespace
+        [[ -z "${line// }" ]] && continue
+        # Skip heading lines
+        [[ "$line" =~ ^[[:space:]]*# ]] && continue
+        # Skip HTML tags (often used for logos/badges at the top)
+        [[ "$line" =~ ^[[:space:]]*\< ]] && continue
+        # Skip badge lines
+        [[ "$line" =~ ^[[:space:]]*\[!\[ ]] && continue
+
+        # Trim
+        line="${line#"${line%%[![:space:]]*}"}"
+        line="${line%"${line##*[![:space:]]}"}"
+
+        # Cap length
+        if [[ ${#line} -gt 100 ]]; then
+            line="${line:0:100}..."
+        fi
+        printf '%s' "$line"
+        return 0
+    done < "$readme"
+}
+
+# Scan a repository directory and populate SCAN_* globals.
+# Usage: scan_repo "/path/to/repo"
+scan_repo() {
+    local repo_dir="$1"
+    scan_reset
+
+    [[ ! -d "$repo_dir" ]] && return 1
+
+    # Node.js
+    if [[ -f "$repo_dir/package.json" ]]; then
+        SCAN_LANG="Node.js"
+        SCAN_NAME=$(_scan_json_string "$repo_dir/package.json" "name" || true)
+        SCAN_FRAMEWORK=$(_scan_node_framework "$repo_dir/package.json")
+    fi
+
+    # Python
+    if [[ -z "$SCAN_LANG" ]] && { [[ -f "$repo_dir/pyproject.toml" ]] || [[ -f "$repo_dir/requirements.txt" ]] || [[ -f "$repo_dir/Pipfile" ]]; }; then
+        SCAN_LANG="Python"
+        if [[ -f "$repo_dir/pyproject.toml" ]]; then
+            local pyname
+            pyname=$(grep -m1 -E '^[[:space:]]*name[[:space:]]*=' "$repo_dir/pyproject.toml" 2>/dev/null | sed -E 's/.*=[[:space:]]*"([^"]*)".*/\1/' || true)
+            [[ -n "$pyname" ]] && SCAN_NAME="$pyname"
+        fi
+        SCAN_FRAMEWORK=$(_scan_python_framework "$repo_dir")
+    fi
+
+    # Go
+    if [[ -z "$SCAN_LANG" ]] && [[ -f "$repo_dir/go.mod" ]]; then
+        SCAN_LANG="Go"
+        SCAN_NAME=$(grep -m1 '^module ' "$repo_dir/go.mod" 2>/dev/null | awk '{print $2}' || true)
+    fi
+
+    # Rust
+    if [[ -z "$SCAN_LANG" ]] && [[ -f "$repo_dir/Cargo.toml" ]]; then
+        SCAN_LANG="Rust"
+        SCAN_NAME=$(grep -m1 -E '^[[:space:]]*name[[:space:]]*=' "$repo_dir/Cargo.toml" 2>/dev/null | sed -E 's/.*=[[:space:]]*"([^"]*)".*/\1/' || true)
+    fi
+
+    # Routes
+    SCAN_ROUTES=$(_scan_list_routes "$repo_dir")
+
+    # README description
+    if [[ -f "$repo_dir/README.md" ]]; then
+        SCAN_DESCRIPTION=$(_scan_readme_description "$repo_dir/README.md")
+    elif [[ -f "$repo_dir/readme.md" ]]; then
+        SCAN_DESCRIPTION=$(_scan_readme_description "$repo_dir/readme.md")
+    fi
+
+    # CLAUDE.md
+    if [[ -f "$repo_dir/CLAUDE.md" ]]; then
+        SCAN_HAS_CLAUDE_MD=1
+    fi
+
+    # Docker
+    if [[ -f "$repo_dir/Dockerfile" ]] || [[ -f "$repo_dir/docker-compose.yml" ]] || [[ -f "$repo_dir/docker-compose.yaml" ]] || [[ -f "$repo_dir/compose.yml" ]] || [[ -f "$repo_dir/compose.yaml" ]]; then
+        SCAN_HAS_DOCKER=1
+    fi
+
+    return 0
+}
+
+# === lib/commands/init.sh ===
+# Revo CLI - init command
+# Interactive workspace initialization
+
+cmd_init() {
+    local workspace_name=""
+
+    # Check if already initialized
+    if [[ -f "revo.yaml" ]] || [[ -f "mars.yaml" ]]; then
+        ui_step_error "Workspace already initialized in this directory"
+        return 1
+    fi
+
+    ui_intro "Revo - Claude-first Multi-Repo Workspace"
+
+    # Get workspace name
+    ui_step "Workspace name?"
+    printf '%s  ' "$(ui_bar)"
+    read -r workspace_name
+
+    if [[ -z "$workspace_name" ]]; then
+        ui_outro_cancel "Cancelled - workspace name is required"
+        return 1
+    fi
+
+    ui_step_done "Workspace:" "$workspace_name"
+    ui_bar_line
+
+    # Initialize workspace
+    if ! config_init "$workspace_name"; then
+        ui_step_error "Failed to initialize workspace"
+        return 1
+    fi
+
+    ui_step_done "Created revo.yaml"
+    ui_step_done "Created .gitignore"
+    ui_step_done "Created repos/ directory"
+
+    ui_outro "Workspace initialized! Run 'revo add <url>' to add repositories."
+
+    return 0
+}
+
+# === lib/commands/clone.sh ===
+# Revo CLI - clone command
+# Clone configured repositories with per-repo progress
+
+cmd_clone() {
+    local tag=""
+    local force=0
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --force|-f)
+                force=1
+                shift
+                ;;
+            *)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+        esac
+    done
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Clone Repositories"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        if [[ -n "$tag" ]]; then
+            ui_step_error "No repositories found with tag: $tag"
+        else
+            ui_step_error "No repositories configured. Run 'revo add <url>' first."
+        fi
+        ui_outro_cancel "Nothing to clone"
+        return 1
+    fi
+
+    # Count total repos
+    local total=0
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+        total=$((total + 1))
+    done <<< "$repos"
+
+    local current=0
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+
+    # Clone each repo with spinner feedback
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+        current=$((current + 1))
+
+        local url
+        url=$(yaml_get_url "$repo")
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        # Already cloned?
+        if [[ -d "$full_path" ]] && [[ $force -eq 0 ]]; then
+            ui_step_done "Already cloned:" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Remove existing directory if force
+        if [[ -d "$full_path" ]] && [[ $force -eq 1 ]]; then
+            rm -rf "$full_path"
+        fi
+
+        # Show spinner while cloning
+        ui_spinner_start "Cloning $path... ($current/$total)"
+
+        local clone_err
+        if clone_err=$(git clone --quiet "$url" "$full_path" 2>&1); then
+            ui_spinner_stop
+            ui_step_done "Cloned:" "$path"
+            success_count=$((success_count + 1))
+        else
+            ui_spinner_error "Failed to clone: $path"
+            if [[ -n "$clone_err" ]]; then
+                ui_info "$(ui_dim "$clone_err")"
+            fi
+            fail_count=$((fail_count + 1))
+        fi
+    done <<< "$repos"
+
+    # Auto-generate workspace CLAUDE.md on first successful clone
+    if [[ $fail_count -eq 0 ]] && [[ $success_count -gt 0 ]]; then
+        context_autogenerate_if_missing
+    fi
+
+    # Summary
+    ui_bar_line
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Cloned $success_count repositories successfully"
+        if [[ $skip_count -gt 0 ]]; then
+            msg="$msg, $skip_count already cloned"
+        fi
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "Cloned $success_count, failed $fail_count"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/status.sh ===
+# Revo CLI - status command
+# Show git status across all repositories
+
+cmd_status() {
+    local tag=""
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            *)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+        esac
+    done
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Repository Status"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to show"
+        return 1
+    fi
+
+    # Table header
+    ui_table_widths 24 20 12 14
+    ui_table_header "Repository" "Branch" "Status" "Sync"
+
+    local not_cloned=0
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_table_row "$path" "$(ui_dim "not cloned")" "-" "-"
+            not_cloned=$((not_cloned + 1))
+            continue
+        fi
+
+        # Get branch
+        local branch
+        branch=$(git_current_branch "$full_path")
+
+        # Get dirty status
+        local status_text
+        if git_is_dirty "$full_path"; then
+            status_text="$(ui_yellow "dirty")"
+        else
+            status_text="$(ui_green "clean")"
+        fi
+
+        # Get ahead/behind
+        git_ahead_behind "$full_path"
+        local sync_text=""
+
+        if [[ $GIT_AHEAD -gt 0 ]] && [[ $GIT_BEHIND -gt 0 ]]; then
+            sync_text="$(ui_yellow "↑$GIT_AHEAD ↓$GIT_BEHIND")"
+        elif [[ $GIT_AHEAD -gt 0 ]]; then
+            sync_text="$(ui_cyan "↑$GIT_AHEAD")"
+        elif [[ $GIT_BEHIND -gt 0 ]]; then
+            sync_text="$(ui_yellow "↓$GIT_BEHIND")"
+        else
+            sync_text="$(ui_green "synced")"
+        fi
+
+        ui_table_row "$path" "$branch" "$status_text" "$sync_text"
+    done <<< "$repos"
+
+    ui_bar_line
+
+    if [[ $not_cloned -gt 0 ]]; then
+        ui_info "$(ui_dim "$not_cloned repository(ies) not cloned. Run 'revo clone' to clone them.")"
+    fi
+
+    ui_outro "Status complete"
+
+    return 0
+}
+
+# === lib/commands/branch.sh ===
+# Revo CLI - branch command
+# Create a new branch across repositories
+
+cmd_branch() {
+    local branch_name=""
+    local tag=""
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$branch_name" ]]; then
+                    branch_name="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$branch_name" ]]; then
+        ui_step_error "Usage: revo branch <branch-name> [--tag TAG]"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Create Branch: $branch_name"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to do"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Check if branch already exists
+        if git_branch_exists "$full_path" "$branch_name"; then
+            # Try to checkout instead
+            if git_checkout "$full_path" "$branch_name"; then
+                ui_step_done "Checked out existing:" "$path → $branch_name"
+                success_count=$((success_count + 1))
+            else
+                ui_step_error "Failed to checkout existing branch: $path"
+                fail_count=$((fail_count + 1))
+            fi
+            continue
+        fi
+
+        # Create new branch
+        if git_branch "$full_path" "$branch_name"; then
+            ui_step_done "Created:" "$path → $branch_name"
+            success_count=$((success_count + 1))
+        else
+            ui_step_error "Failed: $path - $GIT_ERROR"
+            fail_count=$((fail_count + 1))
+        fi
+    done <<< "$repos"
+
+    ui_bar_line
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Branch '$branch_name' created on $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count succeeded, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/checkout.sh ===
+# Revo CLI - checkout command
+# Checkout a branch across repositories
+
+cmd_checkout() {
+    local branch_name=""
+    local tag=""
+    local force=0
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --force|-f)
+                force=1
+                shift
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$branch_name" ]]; then
+                    branch_name="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$branch_name" ]]; then
+        ui_step_error "Usage: revo checkout <branch-name> [--tag TAG] [--force]"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Checkout Branch: $branch_name"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to do"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+    local dirty_repos=()
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Check for uncommitted changes
+        if git_is_dirty "$full_path" && [[ $force -eq 0 ]]; then
+            ui_step_error "Uncommitted changes: $path"
+            dirty_repos+=("$path")
+            fail_count=$((fail_count + 1))
+            continue
+        fi
+
+        # Check if branch exists
+        if ! git_branch_exists "$full_path" "$branch_name"; then
+            ui_step_error "Branch not found: $path"
+            fail_count=$((fail_count + 1))
+            continue
+        fi
+
+        # Checkout
+        if git_checkout "$full_path" "$branch_name"; then
+            ui_step_done "Checked out:" "$path → $branch_name"
+            success_count=$((success_count + 1))
+        else
+            ui_step_error "Failed: $path - $GIT_ERROR"
+            fail_count=$((fail_count + 1))
+        fi
+    done <<< "$repos"
+
+    ui_bar_line
+
+    if [[ ${#dirty_repos[@]} -gt 0 ]]; then
+        ui_info "$(ui_yellow "Hint: Use --force to checkout despite uncommitted changes")"
+    fi
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Checked out '$branch_name' on $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count succeeded, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/sync.sh ===
+# Revo CLI - sync command
+# Pull latest changes across repositories
+
+cmd_sync() {
+    local tag=""
+    local rebase=0
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --rebase|-r)
+                rebase=1
+                shift
+                ;;
+            *)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+        esac
+    done
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Sync Repositories"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to sync"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+    local conflict_repos=()
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Fetch first
+        git_fetch "$full_path"
+
+        # Pull
+        local pull_args=""
+        [[ $rebase -eq 1 ]] && pull_args="--rebase"
+
+        if git_pull "$full_path" $pull_args; then
+            # Check what happened
+            if [[ "$GIT_OUTPUT" == *"Already up to date"* ]]; then
+                ui_step_done "Up to date:" "$path"
+            else
+                ui_step_done "Updated:" "$path"
+            fi
+            success_count=$((success_count + 1))
+        else
+            # Check for conflicts
+            if [[ "$GIT_ERROR" == *"conflict"* ]] || [[ "$GIT_ERROR" == *"CONFLICT"* ]]; then
+                ui_step_error "Conflict: $path"
+                conflict_repos+=("$path")
+            else
+                ui_step_error "Failed: $path"
+            fi
+            fail_count=$((fail_count + 1))
+        fi
+    done <<< "$repos"
+
+    ui_bar_line
+
+    if [[ ${#conflict_repos[@]} -gt 0 ]]; then
+        ui_info "$(ui_yellow "Repositories with conflicts:")"
+        for r in "${conflict_repos[@]}"; do
+            ui_info "  $(ui_yellow "$r")"
+        done
+    fi
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Synced $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count synced, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/exec.sh ===
+# Revo CLI - exec command
+# Run command in each repository
+
+cmd_exec() {
+    local command=""
+    local tag=""
+    local quiet=0
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --quiet|-q)
+                quiet=1
+                shift
+                ;;
+            --)
+                shift
+                command="$*"
+                break
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$command" ]]; then
+                    command="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$command" ]]; then
+        ui_step_error "Usage: revo exec \"<command>\" [--tag TAG]"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Execute: $command"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to do"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        ui_step "Running in: $path"
+        ui_bar_line
+
+        # Execute command in repo directory
+        local output
+        local exit_code
+
+        if output=$(cd "$full_path" && eval "$command" 2>&1); then
+            exit_code=0
+        else
+            exit_code=$?
+        fi
+
+        # Show output if not quiet
+        if [[ $quiet -eq 0 ]] && [[ -n "$output" ]]; then
+            while IFS= read -r line; do
+                printf '%s  %s\n' "$(ui_bar)" "$(ui_dim "$line")"
+            done <<< "$output"
+        fi
+
+        if [[ $exit_code -eq 0 ]]; then
+            ui_step_done "Success:" "$path"
+            success_count=$((success_count + 1))
+        else
+            ui_step_error "Failed (exit $exit_code): $path"
+            fail_count=$((fail_count + 1))
+        fi
+
+        ui_bar_line
+    done <<< "$repos"
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Executed on $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count succeeded, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/add.sh ===
+# Revo CLI - add command
+# Add a repository to the workspace configuration
+
+cmd_add() {
+    local url=""
+    local path=""
+    local tags=""
+    local deps=""
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tags)
+                tags="$2"
+                shift 2
+                ;;
+            --path)
+                path="$2"
+                shift 2
+                ;;
+            --depends-on)
+                deps="$2"
+                shift 2
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$url" ]]; then
+                    url="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$url" ]]; then
+        ui_step_error "Usage: revo add <url> [--tags tag1,tag2] [--path custom-path] [--depends-on repo1,repo2]"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    # Derive path from URL if not provided
+    if [[ -z "$path" ]]; then
+        path=$(yaml_path_from_url "$url")
+    fi
+
+    # Check if repo already exists
+    local i
+    for ((i = 0; i < YAML_REPO_COUNT; i++)); do
+        local existing_url
+        existing_url=$(yaml_get_url "$i")
+        if [[ "$existing_url" == "$url" ]]; then
+            ui_step_error "Repository already configured: $url"
+            return 1
+        fi
+
+        local existing_path
+        existing_path=$(yaml_get_path "$i")
+        if [[ "$existing_path" == "$path" ]]; then
+            ui_step_error "Path already in use: $path"
+            return 1
+        fi
+    done
+
+    ui_intro "Revo - Add Repository"
+
+    # Add to config
+    yaml_add_repo "$url" "$path" "$tags" "$deps"
+
+    # Save config
+    config_save
+
+    ui_step_done "Added repository:" "$path"
+
+    if [[ -n "$tags" ]]; then
+        ui_info "Tags: $tags"
+    fi
+
+    if [[ -n "$deps" ]]; then
+        ui_info "Depends on: $deps"
+    fi
+
+    ui_bar_line
+    ui_info "$(ui_dim "Run 'revo clone' to clone the repository")"
+
+    ui_outro "Repository added to workspace"
+
+    return 0
+}
+
+# === lib/commands/list.sh ===
+# Revo CLI - list command
+# List configured repositories
+
+cmd_list() {
+    local tag=""
+
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            *)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+        esac
+    done
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Configured Repositories"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        if [[ -n "$tag" ]]; then
+            ui_info "No repositories found with tag: $tag"
+        else
+            ui_info "No repositories configured"
+            ui_bar_line
+            ui_info "$(ui_dim "Run 'revo add <url>' to add a repository")"
+        fi
+        ui_outro "List complete"
+        return 0
+    fi
+
+    # Table header
+    ui_table_widths 24 24 10
+    ui_table_header "Path" "Tags" "Cloned"
+
+    local total=0
+    local cloned=0
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+        total=$((total + 1))
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local tags
+        tags=$(yaml_get_tags "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        local cloned_text
+        if [[ -d "$full_path" ]]; then
+            cloned_text="$(ui_green "yes")"
+            cloned=$((cloned + 1))
+        else
+            cloned_text="$(ui_dim "no")"
+        fi
+
+        local tags_text
+        if [[ -n "$tags" ]]; then
+            tags_text="$tags"
+        else
+            tags_text="$(ui_dim "-")"
+        fi
+
+        ui_table_row "$path" "$tags_text" "$cloned_text"
+    done <<< "$repos"
+
+    ui_bar_line
+    ui_info "Total: $total repositories, $cloned cloned"
+
+    ui_outro "List complete"
+
+    return 0
+}
+
+# === lib/commands/context.sh ===
+# Revo CLI - context command
+# Scans all cloned repos and writes a workspace-level CLAUDE.md.
+
+# Topological sort over YAML_REPO_DEPS.
+# Sets CONTEXT_ORDER to newline-separated repo indices (roots first).
+# Sets CONTEXT_CYCLE=1 if a cycle was detected (remaining nodes are appended in input order).
+CONTEXT_ORDER=""
+CONTEXT_CYCLE=0
+
+_context_topo_sort() {
+    CONTEXT_ORDER=""
+    CONTEXT_CYCLE=0
+
+    local n="$YAML_REPO_COUNT"
+    [[ $n -eq 0 ]] && return 0
+
+    # placed[i]=1 once emitted
+    local placed=()
+    local i
+    for ((i = 0; i < n; i++)); do
+        placed[$i]=0
+    done
+
+    local remaining=$n
+    local order=""
+
+    # Repeat: find a node whose deps are all placed (or missing)
+    while [[ $remaining -gt 0 ]]; do
+        local made_progress=0
+        for ((i = 0; i < n; i++)); do
+            [[ ${placed[$i]} -eq 1 ]] && continue
+
+            local deps="${YAML_REPO_DEPS[$i]:-}"
+            local all_ready=1
+
+            if [[ -n "$deps" ]]; then
+                # Iterate over comma-separated dep names
+                local dep
+                local old_ifs="$IFS"
+                IFS=','
+                for dep in $deps; do
+                    [[ -z "$dep" ]] && continue
+                    local dep_idx
+                    dep_idx=$(yaml_find_by_name "$dep")
+                    # If the dep isn't in our config, ignore it
+                    if [[ "$dep_idx" -lt 0 ]]; then
+                        continue
+                    fi
+                    if [[ ${placed[$dep_idx]} -eq 0 ]]; then
+                        all_ready=0
+                        break
+                    fi
+                done
+                IFS="$old_ifs"
+            fi
+
+            if [[ $all_ready -eq 1 ]]; then
+                if [[ -z "$order" ]]; then
+                    order="$i"
+                else
+                    order="$order"$'\n'"$i"
+                fi
+                placed[$i]=1
+                remaining=$((remaining - 1))
+                made_progress=1
+            fi
+        done
+
+        if [[ $made_progress -eq 0 ]]; then
+            # Cycle or unresolvable: append remaining in input order and stop
+            CONTEXT_CYCLE=1
+            for ((i = 0; i < n; i++)); do
+                if [[ ${placed[$i]} -eq 0 ]]; then
+                    if [[ -z "$order" ]]; then
+                        order="$i"
+                    else
+                        order="$order"$'\n'"$i"
+                    fi
+                    placed[$i]=1
+                fi
+            done
+            remaining=0
+        fi
+    done
+
+    CONTEXT_ORDER="$order"
+    return 0
+}
+
+# Write the workspace CLAUDE.md to the given path.
+# Usage: _context_write_file "/path/to/CLAUDE.md"
+_context_write_file() {
+    local output="$1"
+    local workspace
+    workspace=$(config_workspace_name)
+
+    # Start file
+    {
+        printf '# Workspace Context (auto-generated by revo)\n'
+        printf '\n'
+        printf 'This workspace contains multiple repositories managed by revo.\n'
+        if [[ -n "$workspace" ]]; then
+            printf 'Workspace: **%s**\n' "$workspace"
+        fi
+        printf '\n'
+        printf '> This file is regenerated by `revo context`. Manual edits below the\n'
+        printf '> `## Agent Instructions` section will be preserved across regeneration.\n'
+        printf '\n'
+        printf '## Repos\n'
+        printf '\n'
+    } > "$output"
+
+    # Per-repo details
+    local i
+    for ((i = 0; i < YAML_REPO_COUNT; i++)); do
+        local path tags deps url full_path
+        path=$(yaml_get_path "$i")
+        tags=$(yaml_get_tags "$i")
+        deps=$(yaml_get_deps "$i")
+        url=$(yaml_get_url "$i")
+        full_path="$REVO_REPOS_DIR/$path"
+
+        {
+            printf '### %s\n' "$path"
+
+            if [[ -n "$tags" ]]; then
+                printf -- '- **Tags:** %s\n' "$tags"
+            fi
+            printf -- '- **Path:** repos/%s\n' "$path"
+            if [[ -n "$deps" ]]; then
+                printf -- '- **Depends on:** %s\n' "$deps"
+            fi
+        } >> "$output"
+
+        if [[ -d "$full_path" ]]; then
+            scan_repo "$full_path"
+
+            if [[ -n "$SCAN_LANG" ]]; then
+                if [[ -n "$SCAN_NAME" ]]; then
+                    printf -- '- **Package:** %s (%s)\n' "$SCAN_NAME" "$SCAN_LANG" >> "$output"
+                else
+                    printf -- '- **Language:** %s\n' "$SCAN_LANG" >> "$output"
+                fi
+            fi
+
+            if [[ -n "$SCAN_FRAMEWORK" ]]; then
+                printf -- '- **Framework:** %s\n' "$SCAN_FRAMEWORK" >> "$output"
+            fi
+
+            if [[ -n "$SCAN_ROUTES" ]]; then
+                printf -- '- **API routes:** %s\n' "$SCAN_ROUTES" >> "$output"
+            fi
+
+            if [[ -n "$SCAN_DESCRIPTION" ]]; then
+                printf -- '- **Description:** %s\n' "$SCAN_DESCRIPTION" >> "$output"
+            fi
+
+            if [[ $SCAN_HAS_CLAUDE_MD -eq 1 ]]; then
+                printf -- '- **Has CLAUDE.md:** yes (repo-level context available)\n' >> "$output"
+            fi
+
+            if [[ $SCAN_HAS_DOCKER -eq 1 ]]; then
+                printf -- '- **Containerized:** yes\n' >> "$output"
+            fi
+        else
+            printf -- '- **Status:** not cloned (run `revo clone`)\n' >> "$output"
+            if [[ -n "$url" ]]; then
+                printf -- '- **URL:** %s\n' "$url" >> "$output"
+            fi
+        fi
+
+        printf '\n' >> "$output"
+    done
+
+    # Dependency order
+    {
+        printf '## Dependency Order\n'
+        printf '\n'
+        printf 'When making cross-repo changes, follow this order:\n'
+        printf '\n'
+    } >> "$output"
+
+    _context_topo_sort
+
+    local step=1
+    local idx
+    while IFS= read -r idx; do
+        [[ -z "$idx" ]] && continue
+        local path deps
+        path=$(yaml_get_path "$idx")
+        deps=$(yaml_get_deps "$idx")
+        if [[ -n "$deps" ]]; then
+            printf '%d. **%s** (after: %s)\n' "$step" "$path" "$deps" >> "$output"
+        else
+            printf '%d. **%s**\n' "$step" "$path" >> "$output"
+        fi
+        step=$((step + 1))
+    done <<< "$CONTEXT_ORDER"
+
+    if [[ $CONTEXT_CYCLE -eq 1 ]]; then
+        printf '\n> Warning: a dependency cycle was detected. Listed in best-effort order.\n' >> "$output"
+    fi
+
+    # Agent instructions
+    {
+        printf '\n'
+        printf '## Agent Instructions\n'
+        printf '\n'
+        printf 'When working in this workspace:\n'
+        printf '\n'
+        printf '1. Read this file first to understand the repo structure\n'
+        printf '2. Check `.revo/features/` for active feature contexts\n'
+        printf '3. Follow the dependency order above when making cross-repo changes\n'
+        printf '4. Each repo may have its own CLAUDE.md with repo-specific instructions\n'
+        printf '5. Use `revo status` to check state across all repos\n'
+        printf '6. Use `revo commit "msg"` to commit across all repos at once\n'
+        printf '7. Use `revo feature <name>` to start a coordinated feature workspace\n'
+        printf '8. Use `revo pr "title"` to open coordinated pull requests\n'
+    } >> "$output"
+}
+
+cmd_context() {
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h)
+                printf 'Usage: revo context\n\n'
+                printf 'Scan repos and regenerate workspace CLAUDE.md with framework,\n'
+                printf 'routes, and dependency order for Claude Code to consume.\n'
+                return 0
+                ;;
+            *)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+        esac
+    done
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Generate Workspace CLAUDE.md"
+
+    if [[ $YAML_REPO_COUNT -eq 0 ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to scan"
+        return 1
+    fi
+
+    local output="$REVO_WORKSPACE_ROOT/CLAUDE.md"
+
+    ui_spinner_start "Scanning $YAML_REPO_COUNT repositories..."
+    _context_write_file "$output"
+    ui_spinner_stop
+    ui_step_done "Scanned:" "$YAML_REPO_COUNT repositories"
+    ui_step_done "Wrote:" "CLAUDE.md"
+
+    if [[ $CONTEXT_CYCLE -eq 1 ]]; then
+        ui_step_error "Dependency cycle detected - see CLAUDE.md for order"
+    fi
+
+    ui_outro "Context generated. Point Claude Code at this workspace."
+
+    return 0
+}
+
+# Called automatically from cmd_clone if CLAUDE.md does not yet exist.
+context_autogenerate_if_missing() {
+    [[ -z "$REVO_WORKSPACE_ROOT" ]] && return 0
+    local output="$REVO_WORKSPACE_ROOT/CLAUDE.md"
+    [[ -f "$output" ]] && return 0
+    [[ $YAML_REPO_COUNT -eq 0 ]] && return 0
+
+    _context_write_file "$output"
+    ui_info "$(ui_dim "Auto-generated CLAUDE.md for Claude Code")"
+    return 0
+}
+
+# === lib/commands/feature.sh ===
+# Revo CLI - feature command
+# Creates a coordinated feature branch and writes a feature context file.
+
+cmd_feature() {
+    local name=""
+    local tag=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --help|-h)
+                printf 'Usage: revo feature <name> [--tag TAG]\n\n'
+                printf 'Creates feature/<name> on matching repos and writes\n'
+                printf '.revo/features/<name>.md as a shared context file.\n'
+                return 0
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$name" ]]; then
+                    name="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$name" ]]; then
+        ui_step_error "Usage: revo feature <name> [--tag TAG]"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    local branch="feature/$name"
+    ui_intro "Revo - Feature: $name"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories match"
+        ui_outro_cancel "Nothing to do"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+    local involved_indices=()
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        involved_indices+=("$repo")
+
+        if git_branch_exists "$full_path" "$branch"; then
+            if git_checkout "$full_path" "$branch"; then
+                ui_step_done "Checked out existing:" "$path → $branch"
+                success_count=$((success_count + 1))
+            else
+                ui_step_error "Failed to checkout existing branch: $path"
+                fail_count=$((fail_count + 1))
+            fi
+            continue
+        fi
+
+        if git_branch "$full_path" "$branch"; then
+            ui_step_done "Created:" "$path → $branch"
+            success_count=$((success_count + 1))
+        else
+            ui_step_error "Failed: $path - $GIT_ERROR"
+            fail_count=$((fail_count + 1))
+        fi
+    done <<< "$repos"
+
+    # Write feature context file
+    local feature_dir="$REVO_WORKSPACE_ROOT/.revo/features"
+    mkdir -p "$feature_dir"
+    local feature_file="$feature_dir/$name.md"
+
+    if [[ -f "$feature_file" ]]; then
+        ui_step_done "Feature file exists:" ".revo/features/$name.md"
+    else
+        local timestamp
+        timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+        {
+            printf '# Feature: %s\n' "$name"
+            printf '\n'
+            printf '## Status\n'
+            printf '- Created: %s\n' "$timestamp"
+            printf '- Branch: %s\n' "$branch"
+            if [[ -n "$tag" ]]; then
+                printf '- Tag filter: %s\n' "$tag"
+            fi
+            printf '\n'
+            printf '## Repos\n'
+
+            local idx
+            for idx in "${involved_indices[@]}"; do
+                local rpath rtags
+                rpath=$(yaml_get_path "$idx")
+                rtags=$(yaml_get_tags "$idx")
+                if [[ -n "$rtags" ]]; then
+                    printf -- '- %s (tags: %s)\n' "$rpath" "$rtags"
+                else
+                    printf -- '- %s\n' "$rpath"
+                fi
+            done
+
+            printf '\n'
+            printf '## Plan\n'
+            printf '<!-- Describe what this feature does across repos -->\n'
+            printf '<!-- The agent will read this to understand the scope -->\n'
+            printf '\n'
+            printf '## Changes\n'
+            printf '<!-- Track what has been done in each repo -->\n'
+            printf '\n'
+            printf '## Dependencies\n'
+            printf '<!-- Note cross-repo dependencies -->\n'
+        } > "$feature_file"
+
+        ui_step_done "Wrote:" ".revo/features/$name.md"
+    fi
+
+    ui_bar_line
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Feature '$name' ready on $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_info "$(ui_dim "Next: edit .revo/features/$name.md with the plan,")"
+        ui_info "$(ui_dim "then ask Claude Code to work in $REVO_WORKSPACE_ROOT")"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count succeeded, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/commit.sh ===
+# Revo CLI - commit command
+# Commit across dirty repos with the same message.
+
+cmd_commit() {
+    local message=""
+    local tag=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --help|-h)
+                printf 'Usage: revo commit <message> [--tag TAG]\n\n'
+                printf 'Stages and commits changes across dirty repos with the same message.\n'
+                return 0
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$message" ]]; then
+                    message="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$message" ]]; then
+        ui_step_error "Usage: revo commit <message> [--tag TAG]"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Commit: $message"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to commit"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        if ! git_is_dirty "$full_path"; then
+            ui_step_done "Clean (skipped):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Stage
+        if ! git_exec "$full_path" add -A; then
+            ui_step_error "Failed to stage: $path - $GIT_ERROR"
+            fail_count=$((fail_count + 1))
+            continue
+        fi
+
+        # Commit
+        if git_exec "$full_path" commit -m "$message"; then
+            ui_step_done "Committed:" "$path"
+            success_count=$((success_count + 1))
+        else
+            ui_step_error "Failed: $path - $GIT_ERROR"
+            fail_count=$((fail_count + 1))
+        fi
+    done <<< "$repos"
+
+    ui_bar_line
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Committed on $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count committed, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/push.sh ===
+# Revo CLI - push command
+# Pushes current branch across repositories.
+
+cmd_push() {
+    local tag=""
+    local set_upstream=1
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --no-upstream)
+                set_upstream=0
+                shift
+                ;;
+            --help|-h)
+                printf 'Usage: revo push [--tag TAG]\n\n'
+                printf 'Pushes current branch of each repo to origin.\n'
+                printf 'Sets upstream automatically the first time.\n'
+                return 0
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                ui_step_error "Unexpected argument: $1"
+                return 1
+                ;;
+        esac
+    done
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Push Repositories"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to push"
+        return 1
+    fi
+
+    local success_count=0
+    local skip_count=0
+    local fail_count=0
+
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        local branch
+        branch=$(git_current_branch "$full_path")
+        if [[ -z "$branch" ]] || [[ "$branch" == "HEAD" ]]; then
+            ui_step_error "Detached HEAD: $path"
+            fail_count=$((fail_count + 1))
+            continue
+        fi
+
+        # Check if upstream already exists
+        local has_upstream=0
+        if git -C "$full_path" rev-parse --abbrev-ref '@{upstream}' >/dev/null 2>&1; then
+            has_upstream=1
+        fi
+
+        if [[ $has_upstream -eq 1 ]]; then
+            if git_exec "$full_path" push; then
+                ui_step_done "Pushed:" "$path → $branch"
+                success_count=$((success_count + 1))
+            else
+                ui_step_error "Failed: $path - $GIT_ERROR"
+                fail_count=$((fail_count + 1))
+            fi
+        else
+            if [[ $set_upstream -eq 1 ]]; then
+                if git_exec "$full_path" push -u origin "$branch"; then
+                    ui_step_done "Pushed (set upstream):" "$path → $branch"
+                    success_count=$((success_count + 1))
+                else
+                    ui_step_error "Failed: $path - $GIT_ERROR"
+                    fail_count=$((fail_count + 1))
+                fi
+            else
+                ui_step_error "No upstream and --no-upstream set: $path"
+                fail_count=$((fail_count + 1))
+            fi
+        fi
+    done <<< "$repos"
+
+    ui_bar_line
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Pushed $success_count repo(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "$success_count pushed, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === lib/commands/pr.sh ===
+# Revo CLI - pr command
+# Creates coordinated pull requests across repos via the gh CLI.
+
+cmd_pr() {
+    local title=""
+    local tag=""
+    local body=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --tag)
+                tag="$2"
+                shift 2
+                ;;
+            --body)
+                body="$2"
+                shift 2
+                ;;
+            --help|-h)
+                printf 'Usage: revo pr <title> [--tag TAG] [--body BODY]\n\n'
+                printf 'Creates pull requests across repos on non-main branches using gh CLI.\n'
+                printf 'After all PRs are created, appends cross-reference links to each body.\n'
+                return 0
+                ;;
+            -*)
+                ui_step_error "Unknown option: $1"
+                return 1
+                ;;
+            *)
+                if [[ -z "$title" ]]; then
+                    title="$1"
+                else
+                    ui_step_error "Unexpected argument: $1"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$title" ]]; then
+        ui_step_error "Usage: revo pr <title> [--tag TAG] [--body BODY]"
+        return 1
+    fi
+
+    if ! command -v gh >/dev/null 2>&1; then
+        ui_step_error "gh CLI not found. Install from https://cli.github.com/"
+        return 1
+    fi
+
+    config_require_workspace || return 1
+
+    ui_intro "Revo - Create PRs: $title"
+
+    local repos
+    repos=$(config_get_repos "$tag")
+
+    if [[ -z "$repos" ]]; then
+        ui_step_error "No repositories configured"
+        ui_outro_cancel "Nothing to do"
+        return 1
+    fi
+
+    # Parallel arrays to collect PR results (bash 3.2)
+    local pr_paths=()
+    local pr_urls=()
+    local pr_numbers=()
+
+    local default_body="$body"
+    if [[ -z "$default_body" ]]; then
+        default_body="Coordinated PR created by \`revo pr\`."
+    fi
+
+    local skip_count=0
+    local fail_count=0
+
+    # --- Pass 1: create PRs ---
+    while IFS= read -r repo; do
+        [[ -z "$repo" ]] && continue
+
+        local path
+        path=$(yaml_get_path "$repo")
+        local full_path="$REVO_REPOS_DIR/$path"
+
+        if [[ ! -d "$full_path" ]]; then
+            ui_step_done "Skipped (not cloned):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        local branch
+        branch=$(git_current_branch "$full_path")
+        if [[ -z "$branch" ]] || [[ "$branch" == "main" ]] || [[ "$branch" == "master" ]]; then
+            ui_step_done "Skipped (on main/master):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Skip if no commits ahead of upstream (push required first)
+        git_ahead_behind "$full_path"
+        local has_upstream=0
+        if git -C "$full_path" rev-parse --abbrev-ref '@{upstream}' >/dev/null 2>&1; then
+            has_upstream=1
+        fi
+
+        if [[ $has_upstream -eq 1 ]] && [[ $GIT_AHEAD -eq 0 ]]; then
+            ui_step_done "Skipped (no changes ahead of upstream):" "$path"
+            skip_count=$((skip_count + 1))
+            continue
+        fi
+
+        # Create PR via gh
+        local pr_title="[revo] $title"
+        local output
+        if output=$(cd "$full_path" && gh pr create --title "$pr_title" --body "$default_body" 2>&1); then
+            local url
+            url=$(printf '%s' "$output" | grep -Eo 'https://github\.com/[^ ]+/pull/[0-9]+' | tail -1)
+            if [[ -z "$url" ]]; then
+                url="$output"
+            fi
+            pr_paths+=("$path")
+            pr_urls+=("$url")
+            local number
+            number="${url##*/}"
+            pr_numbers+=("$number")
+            ui_step_done "Opened PR:" "$path → $url"
+        else
+            # Maybe a PR already exists
+            local existing
+            existing=$(cd "$full_path" && gh pr view --json url -q .url 2>/dev/null || true)
+            if [[ -n "$existing" ]]; then
+                pr_paths+=("$path")
+                pr_urls+=("$existing")
+                local number
+                number="${existing##*/}"
+                pr_numbers+=("$number")
+                ui_step_done "Existing PR:" "$path → $existing"
+            else
+                ui_step_error "Failed: $path"
+                ui_info "$(ui_dim "$output")"
+                fail_count=$((fail_count + 1))
+            fi
+        fi
+    done <<< "$repos"
+
+    # --- Pass 2: append cross-references if >1 PR ---
+    if [[ ${#pr_paths[@]} -gt 1 ]]; then
+        ui_bar_line
+        ui_step "Linking PRs with cross-references..."
+
+        # Build cross-reference block
+        local xref
+        xref=$'\n\n---\n**Coordinated PRs (revo):**\n'
+        local i
+        for ((i = 0; i < ${#pr_paths[@]}; i++)); do
+            xref+="- ${pr_paths[$i]}: ${pr_urls[$i]}"$'\n'
+        done
+
+        for ((i = 0; i < ${#pr_paths[@]}; i++)); do
+            local repo_path="${pr_paths[$i]}"
+            local pr_number="${pr_numbers[$i]}"
+            local full_path="$REVO_REPOS_DIR/$repo_path"
+            local combined_body="$default_body$xref"
+
+            if (cd "$full_path" && gh pr edit "$pr_number" --body "$combined_body" >/dev/null 2>&1); then
+                ui_step_done "Linked:" "$repo_path"
+            else
+                ui_step_error "Failed to link: $repo_path"
+            fi
+        done
+    fi
+
+    ui_bar_line
+
+    if [[ $fail_count -eq 0 ]]; then
+        local msg="Opened ${#pr_paths[@]} PR(s)"
+        [[ $skip_count -gt 0 ]] && msg+=", $skip_count skipped"
+        ui_outro "$msg"
+    else
+        ui_outro_cancel "${#pr_paths[@]} opened, $fail_count failed"
+        return 1
+    fi
+
+    return 0
+}
+
+# === Main ===
+# --- Help ---
+show_help() {
+    cat << EOF
+Revo - Claude-first multi-repo workspace manager v$REVO_VERSION
+
+Usage: revo <command> [options]
+
+Workspace commands:
+  init                        Initialize a new workspace
+  add URL [--tags TAGS]       Add a repository to the workspace
+  clone [--tag TAG]           Clone configured repositories
+  list [--tag TAG]            List configured repositories
+  status [--tag TAG]          Show status of all repositories
+  sync [--tag TAG]            Pull latest changes on repositories
+  branch NAME [--tag TAG]     Create a branch on repositories
+  checkout BRANCH [--tag TAG] Checkout a branch on repositories
+  exec "CMD" [--tag TAG]      Run a command in each repository
+
+Claude-first commands:
+  context                     Scan repos and regenerate workspace CLAUDE.md
+  feature NAME [--tag TAG]    Create feature branch + context file across repos
+  commit MSG [--tag TAG]      Commit changes across dirty repos
+  push [--tag TAG]            Push branches across repositories
+  pr TITLE [--tag TAG]        Create coordinated PRs via gh CLI
+
+Options:
+  --tag TAG       Filter repositories by tag
+  --tags TAGS     Comma-separated list of tags (for add)
+  --force, -f     Force operation (clone, checkout)
+  --rebase, -r    Use rebase when syncing
+  --quiet, -q     Suppress command output (exec)
+  --body TEXT     PR body (pr)
+  --help, -h      Show this help
+  --version, -v   Show version
+
+Examples:
+  revo init
+  revo add git@github.com:org/shared-types.git --tags shared
+  revo add git@github.com:org/backend.git --tags backend,api
+  revo clone
+  revo context                                    # regenerate CLAUDE.md
+  revo feature clock-student --tag backend        # coordinated branch
+  revo commit "wire up clock endpoint"
+  revo push
+  revo pr "Clock endpoint for students" --tag backend
+
+Documentation: https://github.com/marcus.salinas/revo
+EOF
+}
+
+show_version() {
+    printf 'Revo v%s\n' "$REVO_VERSION"
+}
+
+# --- Main ---
+main() {
+    local command="${1:-}"
+
+    # Handle no arguments
+    if [[ -z "$command" ]]; then
+        show_help
+        return 0
+    fi
+
+    # Shift off the command
+    shift || true
+
+    case "$command" in
+        init)
+            cmd_init "$@"
+            ;;
+        clone)
+            cmd_clone "$@"
+            ;;
+        status)
+            cmd_status "$@"
+            ;;
+        branch)
+            cmd_branch "$@"
+            ;;
+        checkout)
+            cmd_checkout "$@"
+            ;;
+        sync)
+            cmd_sync "$@"
+            ;;
+        exec)
+            cmd_exec "$@"
+            ;;
+        add)
+            cmd_add "$@"
+            ;;
+        list)
+            cmd_list "$@"
+            ;;
+        context)
+            cmd_context "$@"
+            ;;
+        feature)
+            cmd_feature "$@"
+            ;;
+        commit)
+            cmd_commit "$@"
+            ;;
+        push)
+            cmd_push "$@"
+            ;;
+        pr)
+            cmd_pr "$@"
+            ;;
+        --help|-h|help)
+            show_help
+            ;;
+        --version|-v|version)
+            show_version
+            ;;
+        *)
+            printf 'Unknown command: %s\n\n' "$command" >&2
+            show_help >&2
+            return 1
+            ;;
+    esac
+}
+
+main "$@"