@vikasagarwal101/skill-sync 1.0.0

package/install.sh

@@ -0,0 +1,516 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# skill-sync installer
+# Usage: ./install.sh [options]
+#   --with-rules <agents>  Register rules (non-interactive). Agents: opencode,claude,codex,kilo,gemini,auggie,devin,all
+#   --no-rules             Skip agent rule registration (CLI only)
+#   --uninstall            Remove everything (prompts for rule removal)
+#   (no flags)             Interactive: prompt for each detected agent
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BIN_DIR="${SKILLSYNC_BIN_DIR:-$HOME/.local/bin}"
+CONFIG_DIR="${SKILLSYNC_CONFIG_DIR:-$HOME/.config/skill-sync}"
+
+# Agent paths
+OPENCODE_CONFIG="$HOME/.config/opencode/opencode.json"
+OPENCODE_RULES_DIR="$HOME/.config/opencode/rules"
+CLAUDE_DIR="$HOME/.claude"
+CLAUDE_RULES_DIR="$CLAUDE_DIR/rules"
+CLAUDE_MD="$CLAUDE_DIR/CLAUDE.md"
+CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+CODEX_AGENTS_MD="$CODEX_HOME/AGENTS.md"
+KILO_CONFIG_DIR="$HOME/.config/kilo"
+KILO_RULES_DIR="$KILO_CONFIG_DIR/rules"
+KILO_CONFIG="$KILO_CONFIG_DIR/kilo.jsonc"
+GEMINI_DIR="$HOME/.gemini"
+GEMINI_RULES_DIR="$GEMINI_DIR/rules"
+GEMINI_MD="$GEMINI_DIR/GEMINI.md"
+AUGMENT_DIR="$HOME/.augment"
+AUGMENT_RULES_DIR="$AUGMENT_DIR/rules"
+DEVIN_DIR="$HOME/.devin"
+DEVIN_AGENTS_MD="$DEVIN_DIR/AGENTS.md"
+ANTIGRAVITY_DIR="$HOME/.gemini/antigravity"
+
+# Codex AGENTS.md section markers
+CODEX_SECTION_START="<!-- SKILL_SYNC_START -->"
+CODEX_SECTION_END="<!-- SKILL_SYNC_END -->"
+# Shared markers for codex + devin (same pattern)
+SECTION_START="<!-- SKILL_SYNC_START -->"
+SECTION_END="<!-- SKILL_SYNC_END -->"
+
+# Defaults
+UNINSTALL=false
+RULES_MODE="prompt"
+RULES_AGENTS=""
+
+# Parse args
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --uninstall)  UNINSTALL=true; shift ;;
+        --with-rules) RULES_MODE="with"; RULES_AGENTS="${2:-all}"; shift 2 ;;
+        --no-rules)   RULES_MODE="without"; shift ;;
+        *) shift ;;
+    esac
+done
+
+info() { echo "  $*"; }
+
+prompt_yesno() {
+    local question="$1" default="${2:-y}"
+    local hint
+    [ "$default" = "y" ] && hint="[Y/n]" || hint="[y/N]"
+    printf "%s %s " "$question" "$hint" >&2
+    read -r answer </dev/tty 2>/dev/null || answer="$default"
+    answer="${answer:-$default}"
+    [[ "$answer" =~ ^[Yy] ]] && return 0 || return 1
+}
+
+# ── Agent detection ──
+
+agent_exists() {
+    case "$1" in
+        opencode)    [ -d "$HOME/.config/opencode" ] ;;
+        claude)      [ -d "$CLAUDE_DIR" ] ;;
+        codex)       [ -d "$CODEX_HOME" ] ;;
+        kilo)        [ -d "$KILO_CONFIG_DIR" ] ;;
+        gemini)      [ -d "$GEMINI_DIR" ] ;;
+        auggie)      [ -d "$AUGMENT_DIR" ] ;;
+        devin)       [ -d "$DEVIN_DIR" ] ;;
+        antigravity) [ -d "$ANTIGRAVITY_DIR" ] ;;
+    esac
+}
+
+list_agents() {
+    local found=()
+    for agent in opencode claude codex kilo gemini auggie devin antigravity; do
+        agent_exists "$agent" && found+=("$agent")
+    done
+    echo "${found[*]:-}"
+}
+
+agent_wants() {
+    # Check if agent is in the selected list
+    local agent="$1"
+    [[ "$RULES_AGENTS" == *"all"* ]] && return 0
+    [[ "$RULES_AGENTS" == *"$agent"* ]] && return 0
+    return 1
+}
+
+# ── OpenCode registration ──
+
+register_opencode() {
+    _register_rule_file "$OPENCODE_RULES_DIR" "opencode"
+    if [ -f "$OPENCODE_CONFIG" ]; then
+        if ! grep -q 'skill-sync.md' "$OPENCODE_CONFIG"; then
+            sed -i '/]/i\    "~/.config/opencode/rules/skill-sync.md"' "$OPENCODE_CONFIG" 2>/dev/null || true
+            info "✅ Added to opencode.json instructions"
+        else
+            info "   Already in opencode.json"
+        fi
+    fi
+}
+
+unregister_opencode() {
+    rm -f "$OPENCODE_RULES_DIR/skill-sync.md" && info "Removed opencode rule"
+    if [ -f "$OPENCODE_CONFIG" ]; then
+        local tmp; tmp=$(mktemp)
+        grep -v 'skill-sync.md' "$OPENCODE_CONFIG" > "$tmp" || true
+        cp "$tmp" "$OPENCODE_CONFIG" && rm "$tmp"
+        info "Removed from opencode.json"
+    fi
+}
+
+# ── Claude Code registration ──
+
+register_claude() {
+    _register_rule_file "$CLAUDE_RULES_DIR" "claude"
+    if [ -f "$CLAUDE_MD" ]; then
+        if ! grep -q '@rules/skill-sync.md' "$CLAUDE_MD"; then
+            local last_import_line
+            last_import_line=$(grep -n '@rules/' "$CLAUDE_MD" | tail -1 | cut -d: -f1)
+            if [ -n "$last_import_line" ]; then
+                sed -i "${last_import_line}a\\@rules/skill-sync.md" "$CLAUDE_MD"
+            else
+                echo "" >> "$CLAUDE_MD"
+                echo "## Skill Management" >> "$CLAUDE_MD"
+                echo "@rules/skill-sync.md" >> "$CLAUDE_MD"
+            fi
+            info "✅ Added @rules/skill-sync.md to CLAUDE.md"
+        else
+            info "   Already in CLAUDE.md"
+        fi
+    else
+        mkdir -p "$CLAUDE_DIR"
+        cat > "$CLAUDE_MD" << 'EOF'
+# Claude Code Instructions
+
+## Skill Management
+
+@rules/skill-sync.md
+EOF
+        info "✅ Created CLAUDE.md with skill-sync rule"
+    fi
+}
+
+unregister_claude() {
+    rm -f "$CLAUDE_RULES_DIR/skill-sync.md" && info "Removed claude rule file"
+    if [ -f "$CLAUDE_MD" ]; then
+        local tmp; tmp=$(mktemp)
+        grep -v '@rules/skill-sync.md' "$CLAUDE_MD" > "$tmp" || true
+        cp "$tmp" "$CLAUDE_MD" && rm "$tmp"
+        info "Removed from CLAUDE.md"
+    fi
+}
+
+# ── Codex registration ──
+
+register_codex() {
+    mkdir -p "$CODEX_HOME"
+    _register_section "$CODEX_AGENTS_MD" "codex (~/.codex/AGENTS.md)"
+}
+
+unregister_codex() {
+    _unregister_section "$CODEX_AGENTS_MD"
+}
+
+# ── Shared marker-section helper (codex, devin) ──
+
+_register_section() {
+    local target_file="$1" target_name="$2"
+    mkdir -p "$(dirname "$target_file")"
+
+    local section
+    section=$(cat << EOF
+$SECTION_START
+
+## Skill Management — \`skill-sync\`
+
+**Use \`skill-sync\` for all skill deployment and syncing.** Do not \`cp -r\` skills between directories manually — \`skill-sync\` tracks what syncs where via a manifest and prevents drift.
+
+The CLI is self-documenting — run \`skill-sync help\` for the full command reference.
+
+**Quick reference:**
+\`\`\`bash
+skill-sync                    # sync all tracked skills
+skill-sync add <name>         # deploy skill to a target
+skill-sync create <name>      # scaffold new skill
+skill-sync search <query>     # find skills by keyword
+skill-sync doctor             # full health check
+\`\`\`
+$SECTION_END
+EOF
+)
+
+    if [ -f "$target_file" ] && grep -q "$SECTION_START" "$target_file"; then
+        local tmp; tmp=$(mktemp)
+        awk -v start="$SECTION_START" -v end="$SECTION_END" -v section="$section" '
+            $0 ~ start { print section; in_section=1; next }
+            in_section && $0 ~ end { in_section=0; next }
+            !in_section
+        ' "$target_file" > "$tmp"
+        cp "$tmp" "$target_file" && rm "$tmp"
+        info "✅ Updated $target_name section"
+    else
+        echo "" >> "$target_file"
+        echo "$section" >> "$target_file"
+        info "✅ Added section to $target_file"
+    fi
+}
+
+_unregister_section() {
+    local target_file="$1"
+    if [ -f "$target_file" ] && grep -q "$SECTION_START" "$target_file"; then
+        local tmp; tmp=$(mktemp)
+        awk -v start="$SECTION_START" -v end="$SECTION_END" '
+            $0 ~ start { skip=1; next }
+            skip && $0 ~ end { skip=0; next }
+            !skip
+        ' "$target_file" > "$tmp"
+        cp "$tmp" "$target_file" && rm "$tmp"
+        info "Removed section from $target_file"
+    fi
+}
+
+# ── Shared rule-file helper (opencode, claude, kilo, gemini, auggie) ──
+
+_register_rule_file() {
+    local rules_dir="$1" agent_name="$2"
+    mkdir -p "$rules_dir"
+
+    if [ -f "$rules_dir/skill-sync.md" ]; then
+        if ! diff -q "$SCRIPT_DIR/rules/skill-sync.md" "$rules_dir/skill-sync.md" >/dev/null 2>&1; then
+            cp "$SCRIPT_DIR/rules/skill-sync.md" "$rules_dir/skill-sync.md"
+            info "✅ Updated $agent_name rule file"
+        else
+            info "   Rule file already current"
+        fi
+    else
+        cp "$SCRIPT_DIR/rules/skill-sync.md" "$rules_dir/skill-sync.md"
+        info "✅ Installed $agent_name rule → $rules_dir/skill-sync.md"
+    fi
+}
+
+_unregister_rule_file() {
+    local rules_dir="$1" agent_name="$2"
+    rm -f "$rules_dir/skill-sync.md" && info "Removed $agent_name rule file"
+}
+
+# ── Kilo Code registration ──
+
+register_kilo() {
+    _register_rule_file "$KILO_RULES_DIR" "kilo"
+
+    if [ ! -f "$KILO_CONFIG" ]; then
+        # Create minimal kilo.jsonc
+        mkdir -p "$KILO_CONFIG_DIR"
+        cat > "$KILO_CONFIG" << 'EOF'
+{
+  "instructions": [
+    "~/.config/kilo/rules/skill-sync.md"
+  ]
+}
+EOF
+        info "✅ Created kilo.jsonc with skill-sync instruction"
+    elif grep -q 'skill-sync.md' "$KILO_CONFIG"; then
+        info "   Already in kilo.jsonc"
+    elif grep -q '"instructions"' "$KILO_CONFIG"; then
+        # Add to existing instructions array (before its closing ])
+        local tmp; tmp=$(mktemp)
+        awk '
+            /^  "instructions"/ { in_instr=1 }
+            in_instr && /\]/ {
+                sub(/\]/, "    \"~/.config/kilo/rules/skill-sync.md\"\n  ]")
+                in_instr=0
+            }
+            { print }
+        ' "$KILO_CONFIG" > "$tmp"
+        cp "$tmp" "$KILO_CONFIG" && rm "$tmp"
+        info "✅ Added to kilo.jsonc instructions"
+    else
+        # No instructions key — add one after opening {
+        local tmp; tmp=$(mktemp)
+        awk 'NR==1{print; print "  \"instructions\": ["; print "    \"~/.config/kilo/rules/skill-sync.md\""; print "  ],"; next} {print}' "$KILO_CONFIG" > "$tmp"
+        cp "$tmp" "$KILO_CONFIG" && rm "$tmp"
+        info "✅ Added instructions array to kilo.jsonc"
+    fi
+}
+
+unregister_kilo() {
+    _unregister_rule_file "$KILO_RULES_DIR" "kilo"
+    if [ -f "$KILO_CONFIG" ]; then
+        local tmp; tmp=$(mktemp)
+        grep -v 'skill-sync.md' "$KILO_CONFIG" > "$tmp" || true
+        cp "$tmp" "$KILO_CONFIG" && rm "$tmp"
+        info "Removed from kilo.jsonc"
+    fi
+}
+
+# ── Gemini CLI registration ──
+
+register_gemini() {
+    _register_rule_file "$GEMINI_RULES_DIR" "gemini"
+    if [ -f "$GEMINI_MD" ]; then
+        if ! grep -q '@rules/skill-sync.md' "$GEMINI_MD"; then
+            echo "" >> "$GEMINI_MD"
+            echo "@rules/skill-sync.md" >> "$GEMINI_MD"
+            info "✅ Added @rules/skill-sync.md to GEMINI.md"
+        else
+            info "   Already in GEMINI.md"
+        fi
+    else
+        mkdir -p "$GEMINI_DIR"
+        echo "@rules/skill-sync.md" > "$GEMINI_MD"
+        info "✅ Created GEMINI.md with skill-sync import"
+    fi
+}
+
+unregister_gemini() {
+    _unregister_rule_file "$GEMINI_RULES_DIR" "gemini"
+    if [ -f "$GEMINI_MD" ]; then
+        local tmp; tmp=$(mktemp)
+        grep -v '@rules/skill-sync.md' "$GEMINI_MD" > "$tmp" || true
+        cp "$tmp" "$GEMINI_MD" && rm "$tmp"
+        info "Removed from GEMINI.md"
+    fi
+}
+
+# ── Auggie (Augment Code) registration ──
+
+register_auggie() {
+    _register_rule_file "$AUGMENT_RULES_DIR" "auggie"
+    info "   (auto-discovered by Auggie — no config change needed)"
+}
+
+unregister_auggie() {
+    _unregister_rule_file "$AUGMENT_RULES_DIR" "auggie"
+}
+
+# ── Devin CLI registration ──
+
+register_devin() {
+    _register_section "$DEVIN_AGENTS_MD" "devin"
+}
+
+unregister_devin() {
+    _unregister_section "$DEVIN_AGENTS_MD"
+}
+
+# ── Generic register/unregister dispatchers ──
+
+do_register() {
+    local agent="$1"
+    case "$agent" in
+        opencode) register_opencode ;;
+        claude)   register_claude ;;
+        codex)    register_codex ;;
+        kilo)     register_kilo ;;
+        gemini)   register_gemini ;;
+        auggie)   register_auggie ;;
+        devin)    register_devin ;;
+        antigravity) info "⏭️  Antigravity reads AGENTS.md + scans ~/.agents/skills/ natively — no registration needed" ;;
+    esac
+}
+
+do_unregister() {
+    local agent="$1"
+    case "$agent" in
+        opencode) unregister_opencode ;;
+        claude)   unregister_claude ;;
+        codex)    unregister_codex ;;
+        kilo)     unregister_kilo ;;
+        gemini)   unregister_gemini ;;
+        auggie)   unregister_auggie ;;
+        devin)    unregister_devin ;;
+        antigravity) ;; # nothing to unregister
+    esac
+}
+
+# ── Uninstall ──
+
+do_uninstall() {
+    echo "Uninstalling skill-sync..."
+    echo ""
+
+    rm -f "$BIN_DIR/skill-sync" && info "Removed CLI from $BIN_DIR/"
+    rm -rf "$CONFIG_DIR" && info "Removed config from $CONFIG_DIR/"
+
+    # Check each agent for existing registrations
+    echo ""
+    echo "Checking agent registrations..."
+    for agent in opencode claude codex kilo gemini auggie devin; do
+        if agent_exists "$agent"; then
+            local has_reg=false
+            case "$agent" in
+                opencode) [ -f "$OPENCODE_RULES_DIR/skill-sync.md" ] && has_reg=true ;;
+                claude)   [ -f "$CLAUDE_RULES_DIR/skill-sync.md" ] && has_reg=true ;;
+                codex)    grep -q "$SECTION_START" "$CODEX_AGENTS_MD" 2>/dev/null && has_reg=true ;;
+                kilo)     [ -f "$KILO_RULES_DIR/skill-sync.md" ] && has_reg=true ;;
+                gemini)   [ -f "$GEMINI_RULES_DIR/skill-sync.md" ] && has_reg=true ;;
+                auggie)   [ -f "$AUGMENT_RULES_DIR/skill-sync.md" ] && has_reg=true ;;
+                devin)    grep -q "$SECTION_START" "$DEVIN_AGENTS_MD" 2>/dev/null && has_reg=true ;;
+            esac
+
+            if $has_reg; then
+                if [ "$RULES_MODE" = "with" ] || { [ "$RULES_MODE" = "prompt" ] && prompt_yesno "Remove $agent registration?" "y"; }; then
+                    do_unregister "$agent"
+                else
+                    info "Kept $agent registration"
+                fi
+            fi
+        fi
+    done
+
+    echo ""
+    echo "Uninstalled. Skill directories are untouched."
+    exit 0
+}
+
+# ── Install ──
+
+do_install() {
+    echo "Installing skill-sync..."
+    echo ""
+
+    # 1. CLI (always) — bundle lib modules into single file
+    mkdir -p "$BIN_DIR"
+    {
+        echo '#!/usr/bin/env bash'
+        echo 'set -euo pipefail'
+        echo ''
+        for _lib in core sync authoring inspect health targets; do
+            cat "$SCRIPT_DIR/lib/$_lib.sh" 2>/dev/null || true
+            echo ''
+        done
+        # Dispatch (everything from Main dispatch onward)
+        awk '/^# ── Main dispatch/{p=1} p' "$SCRIPT_DIR/skill-sync"
+    } > "$BIN_DIR/skill-sync"
+    chmod +x "$BIN_DIR/skill-sync"
+    info "✅ CLI installed → $BIN_DIR/skill-sync"
+
+    # 2. Config dir (always)
+    mkdir -p "$CONFIG_DIR"
+    info "✅ Config dir → $CONFIG_DIR/"
+
+    # 3. Agent rule registration
+    local found
+    found=$(list_agents)
+
+    if [ -z "$found" ]; then
+        echo ""
+        info "No AI agents detected — CLI installed without rule registration"
+    elif [ "$RULES_MODE" = "without" ]; then
+        echo ""
+        info "⏭️  Skipped agent rule registration (--no-rules)"
+        info "   Register later with: ./install.sh --with-rules all"
+    else
+        echo ""
+        echo "Detected agents: ${found// /, }"
+        echo ""
+
+        for agent in $found; do
+            local should_register=false
+
+            if [ "$RULES_MODE" = "with" ]; then
+                agent_wants "$agent" && should_register=true
+            elif [ "$RULES_MODE" = "prompt" ]; then
+                local desc=""
+                case "$agent" in
+                    opencode)    desc="rule file + opencode.json" ;;
+                    claude)      desc="rule file + CLAUDE.md import" ;;
+                    codex)       desc="AGENTS.md section" ;;
+                    kilo)        desc="rule file + kilo.jsonc instructions" ;;
+                    gemini)      desc="rule file + GEMINI.md import" ;;
+                    auggie)      desc="rule file (auto-discovered)" ;;
+                    devin)       desc="AGENTS.md section" ;;
+                    antigravity) desc="automatic — no registration needed" ;;
+                esac
+                if prompt_yesno "  Register with $agent ($desc)?" "y"; then
+                    should_register=true
+                fi
+            fi
+
+            if $should_register; then
+                do_register "$agent"
+            else
+                info "  ⏭️  Skipped $agent"
+            fi
+        done
+    fi
+
+    echo ""
+    info "💡 Run 'skill-sync help' anytime for full command reference"
+
+    # 4. Generate manifest
+    echo ""
+    "$BIN_DIR/skill-sync" init 2>/dev/null || true
+
+    echo ""
+    echo "Installation complete!"
+    echo "Verify with: skill-sync doctor"
+}
+
+# ── Main ──
+
+$UNINSTALL && do_uninstall
+do_install