@dtt_siye/atool 1.1.0

package/lib/detect-stack.sh

@@ -0,0 +1,354 @@
+#!/usr/bin/env bash
+# aTool - lib/detect-stack.sh
+# Technology stack detection engine (10 categories)
+
+set -euo pipefail
+
+# Detect technology stack for a project directory
+# Args: PROJECT_DIR
+# Outputs: STACK_TYPE (e.g. "java-spring", "web-nextjs", "generic")
+detect_stack() {
+    local project_dir="$1"
+    local stack=""
+    local confidence=0
+    local signals=""
+
+    # ── Java / Spring Boot ──────────────────────────────────────────────
+    if [[ -f "$project_dir/pom.xml" ]]; then
+        if grep -q "spring-boot" "$project_dir/pom.xml" 2>/dev/null; then
+            stack="java-spring"
+            confidence=95
+            signals="pom.xml + spring-boot"
+        elif ! grep -q "com.android" "$project_dir/pom.xml" 2>/dev/null; then
+            stack="java"
+            confidence=90
+            signals="pom.xml"
+        fi
+    fi
+
+    if [[ -f "$project_dir/build.gradle" || -f "$project_dir/build.gradle.kts" ]]; then
+        local gradle_file
+        gradle_file="$project_dir/build.gradle"
+        [[ -f "$project_dir/build.gradle.kts" ]] && gradle_file="$project_dir/build.gradle.kts"
+
+        if grep -q "com.android" "$gradle_file" 2>/dev/null; then
+            if [[ "$confidence" -lt 95 ]]; then
+                stack="android-kotlin"
+                confidence=95
+                signals="build.gradle + com.android"
+            fi
+        elif [[ "$stack" != "java-spring" && "$confidence" -lt 90 ]]; then
+            stack="java"
+            confidence=90
+            signals="build.gradle"
+        fi
+    fi
+
+    # ── Android / Kotlin ────────────────────────────────────────────────
+    if [[ -f "$project_dir/AndroidManifest.xml" ]]; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="android-kotlin"
+            confidence=95
+            signals="AndroidManifest.xml"
+        fi
+    fi
+
+    if [[ -f "$project_dir/build.gradle" || -f "$project_dir/build.gradle.kts" ]]; then
+        local gradle_file2
+        gradle_file2="$project_dir/build.gradle"
+        [[ -f "$project_dir/build.gradle.kts" ]] && gradle_file2="$project_dir/build.gradle.kts"
+        if grep -q "android {" "$gradle_file2" 2>/dev/null || grep -q "android{" "$gradle_file2" 2>/dev/null; then
+            if [[ "$confidence" -lt 95 ]]; then
+                stack="android-kotlin"
+                confidence=95
+                signals="build.gradle + android plugin"
+            fi
+        fi
+    fi
+
+    # ── HarmonyOS / ArkTS ───────────────────────────────────────────────
+    if [[ -f "$project_dir/oh-package.json5" || -f "$project_dir/build-profile.json5" ]]; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="harmony"
+            confidence=95
+            signals="oh-package.json5 / build-profile.json5"
+        fi
+    fi
+
+    # ── Tauri (Rust + Web Desktop) ──────────────────────────────────────
+    if [[ -d "$project_dir/src-tauri" ]] && [[ -f "$project_dir/src-tauri/Cargo.toml" ]]; then
+        if [[ "$confidence" -lt 98 ]]; then
+            stack="rust-tauri"
+            confidence=98
+            signals="src-tauri/Cargo.toml"
+            if [[ -f "$project_dir/package.json" ]]; then
+                if grep -q '"@tauri-apps/api"' "$project_dir/package.json" 2>/dev/null || \
+                   grep -q '"@tauri-apps/cli"' "$project_dir/package.json" 2>/dev/null; then
+                    signals="src-tauri/Cargo.toml + @tauri-apps"
+                fi
+            fi
+        fi
+    fi
+
+    # ── Web Frameworks ──────────────────────────────────────────────────
+    if [[ -f "$project_dir/package.json" ]]; then
+        local pkg_json="$project_dir/package.json"
+
+        if grep -q '"next"' "$pkg_json" 2>/dev/null; then
+            if [[ "$confidence" -lt 95 ]]; then
+                stack="web-nextjs"
+                confidence=95
+                signals="package.json + next"
+            fi
+        elif grep -q '"react"' "$pkg_json" 2>/dev/null; then
+            if [[ "$confidence" -lt 90 ]]; then
+                stack="web-react"
+                confidence=90
+                signals="package.json + react"
+            fi
+        elif grep -q '"vue"' "$pkg_json" 2>/dev/null || grep -q '"nuxt"' "$pkg_json" 2>/dev/null; then
+            if [[ "$confidence" -lt 90 ]]; then
+                stack="web-vue"
+                confidence=90
+                signals="package.json + vue/nuxt"
+            fi
+        elif grep -q '"svelte"' "$pkg_json" 2>/dev/null; then
+            if [[ "$confidence" -lt 90 ]]; then
+                stack="web-svelte"
+                confidence=90
+                signals="package.json + svelte"
+            fi
+        fi
+    fi
+
+    # ── Mobile ──────────────────────────────────────────────────────────
+    if [[ -f "$project_dir/package.json" ]] && grep -q "react-native" "$project_dir/package.json" 2>/dev/null; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="mobile-react-native"
+            confidence=95
+            signals="package.json + react-native"
+        fi
+    fi
+
+    if [[ -f "$project_dir/pubspec.yaml" ]]; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="mobile-flutter"
+            confidence=95
+            signals="pubspec.yaml"
+        fi
+    fi
+
+    if [[ -f "$project_dir/Package.swift" ]] || compgen -G "$project_dir/*.xcodeproj" &>/dev/null; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="mobile-swift"
+            confidence=95
+            signals="Package.swift / .xcodeproj"
+        fi
+    fi
+
+    # ── Python ──────────────────────────────────────────────────────────
+    if [[ -f "$project_dir/requirements.txt" || -f "$project_dir/pyproject.toml" || -f "$project_dir/setup.py" ]]; then
+        if [[ "$confidence" -lt 85 ]]; then
+            stack="python"
+            confidence=85
+            signals="requirements.txt / pyproject.toml / setup.py"
+        fi
+    fi
+
+    # ── Rust ────────────────────────────────────────────────────────────
+    if [[ -f "$project_dir/Cargo.toml" ]]; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="rust"
+            confidence=95
+            signals="Cargo.toml"
+        fi
+    fi
+
+    # ── Go ──────────────────────────────────────────────────────────────
+    if [[ -f "$project_dir/go.mod" ]]; then
+        if [[ "$confidence" -lt 95 ]]; then
+            stack="go"
+            confidence=95
+            signals="go.mod"
+        fi
+    fi
+
+    # ── DevOps ──────────────────────────────────────────────────────────
+    local devops_found=false
+    if [[ -f "$project_dir/Dockerfile" || -f "$project_dir/docker-compose.yml" || -f "$project_dir/docker-compose.yaml" ]]; then
+        devops_found=true
+    fi
+    if find_first "$project_dir" "*.tf" 2>/dev/null | grep -q .; then
+        devops_found=true
+    fi
+
+    if $devops_found && [[ "$confidence" -lt 80 ]]; then
+        stack="devops"
+        confidence=80
+        signals="Dockerfile / docker-compose / *.tf"
+    fi
+
+    if [[ -f "$project_dir/Chart.yaml" || -f "$project_dir/kustomization.yaml" ]]; then
+        if [[ "$confidence" -lt 90 ]]; then
+            stack="devops-k8s"
+            confidence=90
+            signals="Chart.yaml / kustomization.yaml"
+        fi
+    fi
+
+    # ── Generic fallback ────────────────────────────────────────────────
+    if [[ -z "$stack" ]]; then
+        stack="generic"
+        confidence=10
+        signals="no signal files detected"
+    fi
+
+    echo "$stack"
+}
+
+# Get stack confidence
+# Args: PROJECT_DIR
+get_stack_confidence() {
+    local project_dir="$1"
+    local stack
+    stack=$(detect_stack "$project_dir")
+
+    # Re-detect with confidence output (simplified)
+    case "$stack" in
+        java-spring) echo 95 ;;
+        java) echo 90 ;;
+        android-kotlin) echo 95 ;;
+        harmony) echo 95 ;;
+        web-nextjs) echo 95 ;;
+        web-react) echo 90 ;;
+        web-vue) echo 90 ;;
+        web-svelte) echo 90 ;;
+        mobile-react-native) echo 95 ;;
+        mobile-flutter) echo 95 ;;
+        mobile-swift) echo 95 ;;
+        python) echo 85 ;;
+        rust) echo 95 ;;
+        rust-tauri) echo 98 ;;
+        go) echo 95 ;;
+        devops) echo 80 ;;
+        devops-k8s) echo 90 ;;
+        *) echo 10 ;;
+    esac
+}
+
+# Map stack type to template name
+# Args: STACK_TYPE
+get_template_name() {
+    local stack="$1"
+    case "$stack" in
+        java-spring|java) echo "java" ;;
+        android-kotlin) echo "android" ;;
+        harmony) echo "harmony" ;;
+        web-nextjs|web-react|web-vue|web-svelte) echo "web" ;;
+        mobile-react-native) echo "mobile-react-native" ;;
+        mobile-flutter) echo "mobile-flutter" ;;
+        mobile-swift) echo "mobile-swift" ;;
+        python) echo "python" ;;
+        rust) echo "rust" ;;
+        rust-tauri) echo "rust-tauri" ;;
+        go) echo "go" ;;
+        devops|devops-k8s) echo "devops" ;;
+        *) echo "generic" ;;
+    esac
+}
+
+# Get human-readable stack description
+# Args: STACK_TYPE
+get_stack_description() {
+    local stack="$1"
+    case "$stack" in
+        java-spring) echo "Java / Spring Boot" ;;
+        java) echo "Java" ;;
+        android-kotlin) echo "Android / Kotlin" ;;
+        harmony) echo "HarmonyOS / ArkTS" ;;
+        web-nextjs) echo "Web / Next.js" ;;
+        web-react) echo "Web / React" ;;
+        web-vue) echo "Web / Vue / Nuxt" ;;
+        web-svelte) echo "Web / Svelte" ;;
+        mobile-react-native) echo "Mobile / React Native" ;;
+        mobile-flutter) echo "Mobile / Flutter" ;;
+        mobile-swift) echo "Mobile / Swift / iOS" ;;
+        python) echo "Python" ;;
+        rust) echo "Rust" ;;
+        rust-tauri) echo "Tauri 2 Desktop (Rust + Web)" ;;
+        go) echo "Go" ;;
+        devops) echo "DevOps / Docker / Terraform" ;;
+        devops-k8s) echo "DevOps / Kubernetes" ;;
+        *) echo "Generic (no specific stack detected)" ;;
+    esac
+}
+
+# ── Monorepo Detection ───────────────────────────────────────────────────────
+
+# Detect if a project directory is a monorepo
+# Returns sub-project paths (one per line) if monorepo, empty string if not
+# Args: PROJECT_DIR
+# Outputs: newline-separated list of sub-project directories (absolute paths)
+detect_monorepo() {
+    local project_dir="$1"
+
+    # 1. Check explicit monorepo signals
+    local is_explicit_monorepo=false
+    if [[ -f "$project_dir/pnpm-workspace.yaml" ]] || \
+       [[ -f "$project_dir/lerna.json" ]] || \
+       [[ -f "$project_dir/nx.json" ]]; then
+        is_explicit_monorepo=true
+    fi
+
+    if [[ -f "$project_dir/package.json" ]]; then
+        local workspaces
+        workspaces=$(jq -r '.workspaces // empty' "$project_dir/package.json" 2>/dev/null || true)
+        if [[ -n "$workspaces" && "$workspaces" != "null" ]]; then
+            is_explicit_monorepo=true
+        fi
+    fi
+
+    # 2. Collect sub-projects (directories with their own package.json or other signal files)
+    local sub_projects=()
+    for subdir in "$project_dir"/*/; do
+        [[ ! -d "$subdir" ]] && continue
+        local sub_name
+        sub_name=$(basename "$subdir")
+
+        # Skip common non-project directories
+        case "$sub_name" in
+            node_modules|.git|dist|build|target|vendor|.atool-docs|coverage|.cache)
+                continue
+                ;;
+        esac
+
+        # Check if sub-directory has its own project signal
+        if [[ -f "$subdir/package.json" ]] || \
+           [[ -f "$subdir/pom.xml" ]] || \
+           [[ -f "$subdir/build.gradle" ]] || \
+           [[ -f "$subdir/Cargo.toml" ]] || \
+           [[ -f "$subdir/go.mod" ]] || \
+           [[ -f "$subdir/pubspec.yaml" ]] || \
+           [[ -f "$subdir/Package.swift" ]] || \
+           [[ -f "$subdir/pyproject.toml" ]] || \
+           [[ -f "$subdir/requirements.txt" ]]; then
+            sub_projects+=("$(cd "$subdir" && pwd)")
+        fi
+    done
+
+    # 3. Determine if this is a monorepo
+    if $is_explicit_monorepo && [[ ${#sub_projects[@]} -ge 1 ]]; then
+        # Explicit monorepo with sub-projects
+        printf '%s\n' "${sub_projects[@]}"
+        return 0
+    fi
+
+    if ! $is_explicit_monorepo && [[ ${#sub_projects[@]} -ge 2 ]]; then
+        # Implicit monorepo: no workspace config but 2+ sub-projects with their own package.json
+        printf '%s\n' "${sub_projects[@]}"
+        return 0
+    fi
+
+    # Not a monorepo
+    return 1
+}

package/lib/generate-visualization.sh

@@ -0,0 +1,266 @@
+#!/usr/bin/env bash
+# shellcheck source=lib/common.sh
+# generate-visualization.sh — Generate interactive Cytoscape.js HTML from knowledge graph
+#
+# Usage: source lib/generate-visualization.sh
+#        generate_visualization <docs_dir>
+#
+# Reads .atool-docs/knowledge-graph.json and produces
+# .atool-docs/visualization/index.html with embedded Cytoscape.js
+set -euo pipefail
+
+# shellcheck disable=SC1091
+source "$(dirname "${BASH_SOURCE[0]}")/common.sh"
+
+# Cache JS libraries for offline use.
+#
+# Downloads each library on first use into $ATOOL_CACHE_DIR, then reads
+# the cached content.  Falls back to CDN <script> tags if download fails.
+#
+# Outputs:
+#   Sets global variables: _CYTOSCAPE_JS, _DAGRE_JS, _CYTOSCAPE_DAGRE_JS
+cache_js_libraries() {
+    local cache_dir="${ATOOL_CACHE_DIR:-$HOME/.atool/cache}/visualization"
+    mkdir -p "$cache_dir"
+
+    local cytoscape_url="https://cdnjs.cloudflare.com/ajax/libs/cytoscape/3.28.0/cytoscape.min.js"
+    local dagre_url="https://unpkg.com/dagre@0.8.5/dist/dagre.min.js"
+    local cytoscape_dagre_url="https://unpkg.com/cytoscape-dagre@2.5.0/cytoscape-dagre.js"
+
+    local cytoscape_file="$cache_dir/cytoscape-3.28.0.min.js"
+    local dagre_file="$cache_dir/dagre-0.8.5.min.js"
+    local cytoscape_dagre_file="$cache_dir/cytoscape-dagre-2.5.0.js"
+
+    # Download each library if not already cached
+    if [[ ! -f "$cytoscape_file" ]]; then
+        log_info "Caching cytoscape.js..."
+        if command -v curl &>/dev/null; then
+            curl -fsSL "$cytoscape_url" -o "$cytoscape_file" 2>/dev/null || true
+        elif command -v wget &>/dev/null; then
+            wget -q -O "$cytoscape_file" "$cytoscape_url" 2>/dev/null || true
+        fi
+    fi
+
+    if [[ ! -f "$dagre_file" ]]; then
+        log_info "Caching dagre.js..."
+        if command -v curl &>/dev/null; then
+            curl -fsSL "$dagre_url" -o "$dagre_file" 2>/dev/null || true
+        elif command -v wget &>/dev/null; then
+            wget -q -O "$dagre_file" "$dagre_url" 2>/dev/null || true
+        fi
+    fi
+
+    if [[ ! -f "$cytoscape_dagre_file" ]]; then
+        log_info "Caching cytoscape-dagre.js..."
+        if command -v curl &>/dev/null; then
+            curl -fsSL "$cytoscape_dagre_url" -o "$cytoscape_dagre_file" 2>/dev/null || true
+        elif command -v wget &>/dev/null; then
+            wget -q -O "$cytoscape_dagre_file" "$cytoscape_dagre_url" 2>/dev/null || true
+        fi
+    fi
+
+    # Read cached content into variables; fall back to empty string
+    _CYTOSCAPE_JS=""
+    _DAGRE_JS=""
+    _CYTOSCAPE_DAGRE_JS=""
+
+    if [[ -f "$cytoscape_file" ]]; then
+        _CYTOSCAPE_JS=$(cat "$cytoscape_file")
+    fi
+    if [[ -f "$dagre_file" ]]; then
+        _DAGRE_JS=$(cat "$dagre_file")
+    fi
+    if [[ -f "$cytoscape_dagre_file" ]]; then
+        _CYTOSCAPE_DAGRE_JS=$(cat "$cytoscape_dagre_file")
+    fi
+}
+
+# Replace a single-line placeholder comment in a file by building the file
+# around it using head/tail.  Avoids sed entirely for large content injection.
+#
+# Args:
+#   $1 - file: path to the HTML file to modify in-place
+#   $2 - placeholder: the exact placeholder string to match as a whole line
+#   $3 - replacement: content to insert in place of the placeholder line
+_replace_placeholder_line() {
+    local file="$1"
+    local placeholder="$2"
+    local replacement="$3"
+
+    # Find the line number of the placeholder (match entire line)
+    local line_num
+    line_num=$(grep -n -F "$placeholder" "$file" | head -1 | cut -d: -f1)
+
+    if [[ -z "$line_num" ]]; then
+        return 1
+    fi
+
+    local tmp_file="${file}.tmp.$$"
+
+    # Lines before placeholder
+    local before=$((line_num - 1))
+
+    # head/tail combination: output [1..before], replacement, [after..end]
+    {
+        if [[ "$before" -gt 0 ]]; then
+            head -n "$before" "$file"
+        fi
+        printf '%s\n' "$replacement"
+        tail -n +"$((line_num + 1))" "$file"
+    } > "$tmp_file"
+
+    mv "$tmp_file" "$file"
+}
+
+# Generate interactive visualization HTML from knowledge graph JSON.
+#
+# Args:
+#   $1 - docs_dir: path to .atool-docs/ directory containing knowledge-graph.json
+# Output: writes visualization/index.html in the docs directory
+generate_visualization() {
+    local docs_dir="$1"
+    local graph_file="$docs_dir/knowledge-graph.json"
+    local output_dir="$docs_dir/visualization"
+    local output_file="$output_dir/index.html"
+    local template_file
+    template_file="$(dirname "${BASH_SOURCE[0]}")/visualization-template.html"
+
+    # Validate inputs
+    if [[ ! -f "$graph_file" ]]; then
+        log_warn "knowledge-graph.json not found at $graph_file, skipping visualization"
+        return 0
+    fi
+
+    if ! command -v jq &>/dev/null; then
+        log_warn "jq not available, skipping visualization generation"
+        return 0
+    fi
+
+    if [[ ! -f "$template_file" ]]; then
+        log_warn "visualization template not found at $template_file"
+        return 0
+    fi
+
+    # Create output directory
+    mkdir -p "$output_dir"
+
+    log_info "Generating interactive visualization..."
+
+    # Prepare graph data: extract only nodes and edges needed by the visualization
+    # Flatten to a compact format to reduce HTML size
+    local graph_data
+    graph_data=$(jq '{
+        nodes: (.nodes // [] | map({
+            id: .id,
+            type: .type,
+            label: .label,
+            path: .path,
+            importance: .importance,
+            metrics: .metrics,
+            tags: .tags,
+            layer: .layer,
+            parent: .parent
+        })),
+        edges: (.edges // [] | map({
+            source: .source,
+            target: .target,
+            type: .type,
+            weight: .weight,
+            confidence: .confidence,
+            line: .line
+        })),
+        layers: (.layers // {}),
+        version: .version
+    }' "$graph_file")
+
+    if [[ -z "$graph_data" || "$graph_data" == "null" ]]; then
+        log_warn "Failed to extract graph data for visualization"
+        return 0
+    fi
+
+    # --- Bug 1 Fix: Template splitting approach ---
+    # Find the line number of __GRAPH_DATA_PLACEHOLDER__ in the template
+    # and assemble the output using head/tail, avoiding sed delimiter/back-reference/ARG_MAX issues.
+    local placeholder_line
+    placeholder_line=$(grep -n -F '__GRAPH_DATA_PLACEHOLDER__' "$template_file" | head -1 | cut -d: -f1)
+
+    if [[ -z "$placeholder_line" ]]; then
+        log_warn "Template does not contain __GRAPH_DATA_PLACEHOLDER__"
+        return 0
+    fi
+
+    local before=$((placeholder_line - 1))
+
+    # Build output: lines before + graph_data assignment + lines after
+    {
+        if [[ "$before" -gt 0 ]]; then
+            head -n "$before" "$template_file"
+        fi
+        printf 'const GRAPH_DATA = %s;\n' "$graph_data"
+        tail -n +"$((placeholder_line + 1))" "$template_file"
+    } > "$output_file"
+
+    # --- Bug 2 Fix: Inline JS libraries ---
+    # Cache and embed JS libraries to support offline / firewall-restricted use.
+    cache_js_libraries
+
+    # Replace each placeholder comment with inline <script> or fallback CDN <script>
+    _inject_js_placeholder "$output_file" \
+        "<!-- __CYTOSCAPE_JS_PLACEHOLDER__ -->" \
+        "$_CYTOSCAPE_JS" \
+        "https://cdnjs.cloudflare.com/ajax/libs/cytoscape/3.28.0/cytoscape.min.js"
+
+    _inject_js_placeholder "$output_file" \
+        "<!-- __DAGRE_JS_PLACEHOLDER__ -->" \
+        "$_DAGRE_JS" \
+        "https://unpkg.com/dagre@0.8.5/dist/dagre.min.js"
+
+    _inject_js_placeholder "$output_file" \
+        "<!-- __CYTOSCAPE_DAGRE_JS_PLACEHOLDER__ -->" \
+        "$_CYTOSCAPE_DAGRE_JS" \
+        "https://unpkg.com/cytoscape-dagre@2.5.0/cytoscape-dagre.js"
+
+    # Verify the output
+    if [[ -f "$output_file" ]] && grep -q "cytoscape" "$output_file"; then
+        local node_count edge_count
+        node_count=$(echo "$graph_data" | jq '.nodes | length')
+        edge_count=$(echo "$graph_data" | jq '.edges | length')
+        log_info "Visualization generated: $output_file ($node_count nodes, $edge_count edges)"
+    else
+        log_warn "Visualization generation may have failed"
+    fi
+}
+
+# Inject a JS library into the HTML file by replacing a placeholder comment.
+# If cached JS content is available, wrap it in <script>...</script>.
+# Otherwise, fall back to a CDN <script src="..."> tag.
+#
+# Args:
+#   $1 - file: path to the HTML file to modify
+#   $2 - placeholder: the placeholder comment line
+#   $3 - js_content: cached JS content (may be empty)
+#   $4 - cdn_url: fallback CDN URL
+_inject_js_placeholder() {
+    local file="$1"
+    local placeholder="$2"
+    local js_content="$3"
+    local cdn_url="$4"
+    local replacement
+
+    if [[ -n "$js_content" ]]; then
+        replacement="<script>${js_content}</script>"
+    else
+        # Fallback to CDN if caching failed
+        replacement="<script src=\"${cdn_url}\"></script>"
+    fi
+
+    if ! _replace_placeholder_line "$file" "$placeholder" "$replacement"; then
+        log_warn "Placeholder not found in output: $placeholder"
+    fi
+}
+
+# === Standalone Execution ===
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    DOCS_DIR="${1:-.atool-docs}"
+    generate_visualization "$DOCS_DIR"
+fi

package/lib/install-claude.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# aTool - lib/install-claude.sh
+# Claude Code CLI installation
+
+set -euo pipefail
+
+# These functions are sourced by the parent script, not run directly.
+# common.sh must already be loaded.
+
+install_claude() {
+    log_step "Installing to Claude Code CLI..."
+
+    # Check if claude is installed
+    if ! command -v claude &>/dev/null; then
+        log_warn "Claude Code CLI not found in PATH"
+        log_info "Install Claude Code first: https://docs.anthropic.com/en/docs/claude-code"
+        if ! confirm "Continue anyway?" "N"; then
+            return 0
+        fi
+    fi
+
+    local claude_config_dir
+    claude_config_dir=$(get_claude_config_dir)
+    local claude_skills_dir="$claude_config_dir/skills"
+
+    # 1. Install skills
+    install_skills "$claude_skills_dir"
+
+    # 2. Install hooks globally
+    install_hooks_global "claude"
+
+    # 3. Install MCP servers
+    install_mcp "claude"
+
+    log_success "Claude Code CLI installation complete!"
+    echo ""
+    log_info "Installed:"
+    log_info "  Skills:   $claude_skills_dir/"
+    log_info "  Hooks:    $claude_config_dir/hooks/atool-session-start"
+    log_info "  MCP:      $claude_config_dir/settings.json"
+    echo ""
+    log_info "Tip: Use /atool-init in a project to auto-detect tech stack"
+}