imgstat 2.0.5 → 3.0.0

package/README.md

@@ -3,32 +3,17 @@
 [![npm version](https://img.shields.io/npm/v/imgstat.svg)](https://www.npmjs.com/package/imgstat)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Give AI context about your images.**
-imgstat is a CLI tool that embeds image dimensions directly into filenames, or analyzes remote imagery, to give AI context without needing external parsers.
+give AI context about your images.
 
-## Installation
+imgstat scans your project and generates image dimension reports your AI coding assistant
+can actually read — without guessing, without vision tokens, without touching your source files.
 
-You can install the package globally:
+## install
 
 ```bash
 npm install -g imgstat
 ```
 
-Or run it directly without installing:
-
-```bash
-npx imgstat
-```
-
-## Features
-
-imgstat handles renaming smoothly and idempotently—it will never re-append dimensions to a file that already has them. When dealing with remote imagery from URLs or scanning your codebase, it securely generates dimension reports without leaving permanent downloads on your machine. For AI integration, the `analyze` mode seamlessly builds an `.agent/rules/image_dimensions.md` file, giving your local language models instant, zero-config context about the images used in your project.
-
-## Usage
-
-Run `imgstat` with no arguments to get an interactive menu. You will be prompted to select the mode you want to use.
-
-```bash
 imgstat
 ```
 

package/bin/imgstat

@@ -21,6 +21,7 @@ MODE=""
 TARGET=""
 DRY_RUN="false"
 YES_FLAG="false"
+FORMAT=""
 
 # Simple parser
 while [[ $# -gt 0 ]]; do
@@ -50,14 +51,24 @@ while [[ $# -gt 0 ]]; do
       echo "  inspect    Print dimensions of local directory images"
       echo "  rename     Rename local files (e.g. image-800x600.jpg)"
       echo "  remote     Print dimensions of images from a URL"
-      echo "  analyze    Scan codebase for URLs, write to .agent/rules/image_dimensions.md"
+      echo "  analyze    Scan codebase for URLs, write dimension report for your IDE"
       echo ""
       echo "Options:"
+      echo "  --format   Set output format (e.g. --format json)"
       echo "  --dry-run  Show what would happen without making changes"
       echo "  --yes, -y  Skip confirmation prompts (for rename)"
       echo "  --help, -h Show this help message"
       exit 0
       ;;
+    --format)
+      shift
+      FORMAT="$1"
+      if [[ "$FORMAT" != "json" ]]; then
+        echo "Error: unsupported format '$FORMAT'. Only 'json' is supported."
+        exit 1
+      fi
+      shift
+      ;;
     -*)
       echo "Unknown flag: $1"
       exit 1
@@ -109,6 +120,6 @@ case "$MODE" in
     ;;
   analyze)
     source "$LIB_DIR/analyze.sh"
-    cmd_analyze "$TARGET"
+    cmd_analyze "$TARGET" "1" "$FORMAT"
     ;;
 esac

package/lib/analyze.sh

@@ -4,6 +4,8 @@ source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utils.sh"
 
 cmd_analyze() {
   local dir="$1"
+  local target_option="${2:-1}"
+  local json_format="$3"
   echo "Analyzing codebase for remote image references in $dir..."
 
   # ── Step 1: Extract all http/https URLs from common code files ──────────────
@@ -13,7 +15,7 @@ cmd_analyze() {
     -type f \( -name "*.html" -o -name "*.jsx" -o -name "*.tsx" -o -name "*.js" -o -name "*.ts" \
                -o -name "*.vue" -o -name "*.css" -o -name "*.scss" -o -name "*.php" \
                -o -name "*.py" -o -name "*.rb" -o -name "*.svelte" -o -name "*.astro" \) \
-    -exec grep -oE "https?://[^\"')[:space:]]+" {} + 2>/dev/null | sort -u)
+    -exec grep -hoE "https?://[^\"')[:space:]]+" {} + 2>/dev/null | sort -u)
 
   if [[ ${#all_urls[@]} -eq 0 ]]; then
     echo "No remote URLs found in code files."
@@ -84,22 +86,8 @@ cmd_analyze() {
   trap 'rm -rf "$TEMP_DIR"' EXIT
 
   # Output file setup
-  local rules_dir="$dir/.agent/rules"
-  local rules_file="$rules_dir/image_dimensions.md"
-  mkdir -p "$rules_dir"
-
-  # Write header
-  cat << 'EOF' > "$rules_file"
-# Codebase Remote Images
-
-> [!NOTE]
-> This file is strictly auto-generated by `imgstat`.
-> It maps remote image URLs found in the codebase to their exact physical dimensions.
-> AI assistants should use this dictionary when asked about layout constraints, native sizes, or aspect ratios of referenced images.
-
-| Documented URL | Detected Size (W x H) |
-|---|---|
-EOF
+  local TEMP_RESULTS=$(mktemp)
+  trap 'rm -rf "$TEMP_DIR" "$TEMP_RESULTS"' EXIT
 
   local processed=0
 
@@ -109,7 +97,9 @@ EOF
       --user-agent="Mozilla/5.0" \
       -P "$TEMP_DIR" "$url" 2>/dev/null || true
 
+    shopt -s nullglob
     local all_files=( "$TEMP_DIR"/* )
+    shopt -u nullglob
     local found_image=""
 
     for file in "${all_files[@]}"; do
@@ -128,7 +118,7 @@ EOF
       if [[ -n "$dim" ]]; then
         local w="${dim% *}"
         local h="${dim#* }"
-        echo "| \`$url\` | **${w}x${h}** |" >> "$rules_file"
+        echo "${url}|${w}|${h}" >> "$TEMP_RESULTS"
         printf "  \033[1;32m📐 %s → %sx%s\033[0m\n" "$url" "$w" "$h"
         processed=$((processed + 1))
       fi
@@ -140,6 +130,47 @@ EOF
 
   echo ""
   echo "Analysis complete!"
-  echo "Documented $processed valid image reference(s) into: $rules_file"
+
+  if [[ $processed -eq 0 ]]; then
+    echo "No matching images with dimension info could be parsed."
+    return 0
+  fi
+
+  # Depending on Target Option, write file.
+  if [[ "$json_format" == "json" ]]; then
+    # if it's format json without target, only output json
+    if [[ -z "$2" ]]; then
+      bash "$(dirname "${BASH_SOURCE[0]}")/format-json.sh" "$dir" "$TEMP_RESULTS" "0"
+      return 0
+    else
+      bash "$(dirname "${BASH_SOURCE[0]}")/format-json.sh" "$dir" "$TEMP_RESULTS" "1"
+    fi
+  fi
+
+  case "$target_option" in
+    1)
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-agent.sh" "$dir" "$TEMP_RESULTS"
+      ;;
+    2)
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-cursor.sh" "$dir" "$TEMP_RESULTS"
+      ;;
+    3)
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-windsurf.sh" "$dir" "$TEMP_RESULTS"
+      ;;
+    4)
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-claude.sh" "$dir" "$TEMP_RESULTS"
+      ;;
+    5)
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-agent.sh" "$dir" "$TEMP_RESULTS"
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-cursor.sh" "$dir" "$TEMP_RESULTS"
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-windsurf.sh" "$dir" "$TEMP_RESULTS"
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-claude.sh" "$dir" "$TEMP_RESULTS"
+      ;;
+    *)
+      # default
+      bash "$(dirname "${BASH_SOURCE[0]}")/write-agent.sh" "$dir" "$TEMP_RESULTS"
+      ;;
+  esac
+
   echo "This file can now be read by autonomous coding agents."
 }

package/lib/format-json.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+
+# Inputs
+# $1: Directory path
+# $2: Temp file containing results in format: url|width|height
+# $3: Optional. Target flag meaning we must write to file instead of stdout.
+
+DIR="$1"
+RESULTS_FILE="$2"
+HAS_TARGET="$3"
+
+JSON_FILE=""
+if [[ "$HAS_TARGET" == "1" ]]; then
+  JSON_FILE="$DIR/image_dimensions.json"
+fi
+
+NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+TEMP_JSON=$(mktemp)
+
+echo "{" > "$TEMP_JSON"
+echo "  \"generated_at\": \"$NOW\"," >> "$TEMP_JSON"
+echo "  \"images\": [" >> "$TEMP_JSON"
+
+FIRST_ITEM=true
+
+while IFS='|' read -r url w h; do
+  if [ "$FIRST_ITEM" = "true" ]; then
+    FIRST_ITEM=false
+  else
+    echo "    ," >> "$TEMP_JSON"
+  fi
+  # We escape the URL safely
+  # Assuming url doesn't have quotes for now, but good practice
+  SAFE_URL=$(echo -n "$url" | sed 's/"/\\"/g')
+  echo -n "    { \"path\": \"$SAFE_URL\", \"width\": $w, \"height\": $h }" >> "$TEMP_JSON"
+done < "$RESULTS_FILE"
+
+echo "" >> "$TEMP_JSON"
+echo "  ]" >> "$TEMP_JSON"
+echo "}" >> "$TEMP_JSON"
+
+if [[ -n "$JSON_FILE" ]]; then
+  mv "$TEMP_JSON" "$JSON_FILE"
+  echo "Wrote JSON dimension report to: $JSON_FILE"
+else
+  cat "$TEMP_JSON"
+  rm -f "$TEMP_JSON"
+fi

package/lib/ui.sh

@@ -74,7 +74,24 @@ cmd_ui() {
     3)
       read -e -p "Enter codebase directory to analyze [./]: " dir
       dir="${dir:-./}"
-      cmd_analyze "$dir"
+      echo ""
+      echo "where should the report go?"
+      echo ""
+      echo "  1. .agent/rules/image_dimensions.md     (generic / all tools)"
+      echo "  2. .cursor/rules/image_dimensions.mdc   (cursor)"
+      echo "  3. .windsurfrules                        (windsurf — appends block)"
+      echo "  4. CLAUDE.md                             (claude code — appends block)"
+      echo "  5. all of the above"
+      echo ""
+      read -e -p "Enter choice [1]: " target_env
+      target_env="${target_env:-1}"
+
+      if [[ ! "$target_env" =~ ^[1-5]$ ]]; then
+        echo "Invalid choice. Defaulting to 1."
+        target_env=1
+      fi
+
+      cmd_analyze "$dir" "$target_env" ""
       ;;
     4)
       echo "Exiting."

package/lib/write-agent.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Inputs
+# $1: Directory path
+# $2: Temp file containing results in format: url|width|height
+
+DIR="$1"
+RESULTS_FILE="$2"
+
+RULES_DIR="$DIR/.agent/rules"
+RULES_FILE="$RULES_DIR/image_dimensions.md"
+
+mkdir -p "$RULES_DIR"
+
+cat << 'EOF' > "$RULES_FILE"
+# Codebase Remote Images
+
+> [!NOTE]
+> This file is strictly auto-generated by `imgstat`.
+> It maps remote image URLs found in the codebase to their exact physical dimensions.
+> AI assistants should use this dictionary when asked about layout constraints, native sizes, or aspect ratios of referenced images.
+
+| Documented URL | Detected Size (W x H) |
+|---|---|
+EOF
+
+while IFS='|' read -r url w h; do
+  echo "| \`$url\` | **${w}x${h}** |" >> "$RULES_FILE"
+done < "$RESULTS_FILE"
+
+echo "Wrote generic rules to: $RULES_FILE"

package/lib/write-claude.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+# Inputs
+# $1: Directory path
+# $2: Temp file containing results in format: url|width|height
+
+DIR="$1"
+RESULTS_FILE="$2"
+RULES_FILE="$DIR/CLAUDE.md"
+
+TEMP_BLOCK=$(mktemp)
+
+cat << 'EOF' > "$TEMP_BLOCK"
+## image dimensions
+
+generated by imgstat. run `npx imgstat` to regenerate.
+
+never guess image sizes. use the table below.
+
+| file | width | height |
+|------|-------|--------|
+EOF
+
+while IFS='|' read -r url w h; do
+  echo "| $url | $w | $h |" >> "$TEMP_BLOCK"
+done < "$RESULTS_FILE"
+
+# Appending / Replacing logic
+if [[ -f "$RULES_FILE" ]] && grep -q "## image dimensions" "$RULES_FILE"; then
+  # Block exists. Let's delete it.
+  sed -i.bak '/## image dimensions/,$d' "$RULES_FILE"
+  rm -f "${RULES_FILE}.bak"
+fi
+
+if [[ -f "$RULES_FILE" ]]; then
+  echo "" >> "$RULES_FILE"
+fi
+
+cat "$TEMP_BLOCK" >> "$RULES_FILE"
+rm -f "$TEMP_BLOCK"
+
+echo "Wrote claude code rules to: $RULES_FILE"

package/lib/write-cursor.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+# Inputs
+# $1: Directory path
+# $2: Temp file containing results in format: url|width|height
+
+DIR="$1"
+RESULTS_FILE="$2"
+
+RULES_DIR="$DIR/.cursor/rules"
+RULES_FILE="$RULES_DIR/image_dimensions.mdc"
+
+mkdir -p "$RULES_DIR"
+
+cat << 'EOF' > "$RULES_FILE"
+---
+description: image dimension context for all assets in this project
+alwaysApply: true
+---
+
+when working with images in this project, always refer to this file.
+never guess dimensions. never use vision tokens to infer size.
+
+| file | width | height |
+|------|-------|--------|
+EOF
+
+while IFS='|' read -r url w h; do
+  echo "| $url | $w | $h |" >> "$RULES_FILE"
+done < "$RESULTS_FILE"
+
+echo "Wrote cursor rules to: $RULES_FILE"

package/lib/write-windsurf.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+
+# Inputs
+# $1: Directory path
+# $2: Temp file containing results in format: url|width|height
+
+DIR="$1"
+RESULTS_FILE="$2"
+RULES_FILE="$DIR/.windsurfrules"
+
+TEMP_BLOCK=$(mktemp)
+
+cat << 'EOF' > "$TEMP_BLOCK"
+# imgstat — image dimensions
+# generated by imgstat. do not edit this block manually.
+# run `npx imgstat` to regenerate.
+
+when working with images, never guess dimensions. refer to the table below.
+
+| file | width | height |
+|------|-------|--------|
+EOF
+
+while IFS='|' read -r url w h; do
+  echo "| $url | $w | $h |" >> "$TEMP_BLOCK"
+done < "$RESULTS_FILE"
+
+# Appending / Replacing logic
+if [[ -f "$RULES_FILE" ]] && grep -q "# imgstat — image dimensions" "$RULES_FILE"; then
+  # Block exists, let's remove it and everything after it (assuming block is at the bottom)
+  # Actually, safer to sed replace everything from the start tag until the end of file.
+  # But the instructions say "append a clearly delimited block at the bottom".
+  # If it exists, replace only that block.
+  # Let's assume the block starts at "# imgstat — image dimensions" and continues to EOF.
+  sed -i.bak '/# imgstat — image dimensions/,$d' "$RULES_FILE"
+  rm -f "${RULES_FILE}.bak"
+fi
+
+if [[ -f "$RULES_FILE" ]]; then
+  # Ensure there's a newline before appending
+  echo "" >> "$RULES_FILE"
+fi
+
+cat "$TEMP_BLOCK" >> "$RULES_FILE"
+rm -f "$TEMP_BLOCK"
+
+echo "Wrote windsurf rules to: $RULES_FILE"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imgstat",
-  "version": "2.0.5",
+  "version": "3.0.0",
   "description": "Embeds image dimensions directly into filenames for natural AI context.",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/build_deb.sh

@@ -1,48 +0,0 @@
-#!/bin/bash
-PACKAGE_NAME="imagestat"
-VERSION="1.0"
-ARCH="all"
-DEB_DIR="${PACKAGE_NAME}_${VERSION}_${ARCH}"
-
-echo "Building .deb package for $PACKAGE_NAME..."
-
-# Create directory structure
-mkdir -p "$DEB_DIR/usr/local/bin"
-mkdir -p "$DEB_DIR/DEBIAN"
-
-# Determine source file (handle rename)
-if [ -f "imagestat" ]; then
-    cp imagestat "$DEB_DIR/usr/local/bin/$PACKAGE_NAME"
-elif [ -f "imgstat.sh" ]; then
-    cp imgstat.sh "$DEB_DIR/usr/local/bin/$PACKAGE_NAME"
-else
-    echo "Error: Source script not found (looked for 'imagestat' and 'imgstat.sh')."
-    exit 1
-fi
-
-chmod 755 "$DEB_DIR/usr/local/bin/$PACKAGE_NAME"
-
-# Create control file
-cat > "$DEB_DIR/DEBIAN/control" <<EOF
-Package: $PACKAGE_NAME
-Version: $VERSION
-Section: utils
-Priority: optional
-Architecture: $ARCH
-Allowed-Architectures: all
-Maintainer: User <user@example.com>
-Depends: imagemagick, wget
-Description: Image dimensions scanner and renamer
- Recursively scans directories for images and renames them to include their 
- dimensions (e.g., image-800x600.jpg). Ignores heavy directories like node_modules.
-EOF
-
-# Build package
-dpkg-deb --build "$DEB_DIR"
-
-# Cleanup
-mv "${DEB_DIR}.deb" "${PACKAGE_NAME}.deb" 2>/dev/null || true
-rm -rf "$DEB_DIR"
-
-echo "Build complete: ${PACKAGE_NAME}.deb"
-echo "Install with: sudo apt install ./$PACKAGE_NAME.deb"

package/imagestat

@@ -1,124 +0,0 @@
-#!/bin/bash
-
-# Function to display usage
-usage() {
-    echo "Usage: imagestat [-u|--url <url>] [directory]"
-    echo "  -u, --url <url>   URL to download images from"
-    echo "  directory         Directory to scan (default: current directory)"
-    exit 1
-}
-
-# Parse arguments
-URL=""
-TARGET_DIR="."
-
-while [[ "$#" -gt 0 ]]; do
-    case $1 in
-        -u|--url) URL="$2"; shift ;;
-        -*) echo "Unknown parameter passed: $1"; usage ;;
-        *) TARGET_DIR="$1" ;;
-    esac
-    shift
-done
-
-# Create target directory if it doesn't exist
-if [ ! -d "$TARGET_DIR" ]; then
-    mkdir -p "$TARGET_DIR"
-fi
-
-# Download images if URL is provided
-# Download images if URL is provided
-if [ -n "$URL" ]; then
-    echo "Downloading images from $URL to temp folder..."
-    TEMP_DIR=$(mktemp -d)
-    
-    # Download with wget (no extension restriction to catch all images)
-    # -nd: no directories (flatten)
-    # -r: recursive (useful if URL is a directory, but works for single file too)
-    # -l 1: limit recursion depth to 1 just in case (optional, but safer)
-    # --no-parent: don't go up
-    wget -nd -H -P "$TEMP_DIR" -e robots=off --user-agent="Mozilla/5.0" "$URL" 2>/dev/null
-    
-    echo "Processing downloaded files..."
-    shopt -s nullglob
-    for f in "$TEMP_DIR"/*; do
-        if [ -f "$f" ]; then
-            # Identify format and dimensions (take first frame for animated gifs etc)
-            # Use -ping to be faster? identification doesn't need full read usually
-            ID_OUTPUT=$(identify -format "%m %w %h" "$f[0]" 2>/dev/null)
-            
-            if [ -n "$ID_OUTPUT" ]; then
-                read -r TYPE W H <<< "$ID_OUTPUT"
-                
-                # Normalize extension
-                EXT=$(echo "$TYPE" | tr '[:upper:]' '[:lower:]')
-                case "$EXT" in
-                    jpeg) EXT="jpg" ;;
-                esac
-                
-                # Get clean basename (remove query params)
-                BASENAME=$(basename "$f")
-                CLEAN_NAME=$(echo "$BASENAME" | sed 's/[?=&].*//')
-                # Remove existing extension if it matches common ones
-                CLEAN_NAME="${CLEAN_NAME%.*}"
-                
-                # Construct new filename
-                NEW_FILENAME="${CLEAN_NAME}-${W}x${H}.${EXT}"
-                NEW_PATH="$TARGET_DIR/$NEW_FILENAME"
-                
-                # Move to target
-                mv -n "$f" "$NEW_PATH"
-                echo "Saved: $NEW_FILENAME ($W x $H)"
-            fi
-        fi
-    done
-    rm -rf "$TEMP_DIR"
-    echo "Download processing complete."
-fi
-
-# Export function so xargs can use it
-process_image() {
-    IMG="$1"
-    
-    # Get dimensions
-    DIMENSIONS=$(identify -format "%wx%h" "$IMG" 2>/dev/null)
-    
-    if [ -z "$DIMENSIONS" ]; then
-        echo "Skipping (not an image or identify failed): $IMG"
-        return
-    fi
-    
-    DIRNAME=$(dirname "$IMG")
-    BASENAME=$(basename "$IMG")
-    EXTENSION="${BASENAME##*.}"
-    FILENAME="${BASENAME%.*}"
-    
-    # Normalize filename: lowercase, replace spaces/underscores with hyphens
-    NEW_FILENAME=$(echo "$FILENAME" | tr '[:upper:]' '[:lower:]' | sed 's/[ _]/-/g' | sed 's/-\{2,\}/-/g')
-    
-    # Check if dimensions are already in the filename
-    if [[ "$NEW_FILENAME" != *"$DIMENSIONS"* ]]; then
-        NEW_FILENAME="${NEW_FILENAME}-${DIMENSIONS}"
-    fi
-    
-    NEW_BASENAME="${NEW_FILENAME}.${EXTENSION}"
-    NEW_PATH="$DIRNAME/$NEW_BASENAME"
-    
-    if [ "$IMG" != "$NEW_PATH" ]; then
-        mv "$IMG" "$NEW_PATH"
-        echo "Renamed: $IMG -> $NEW_PATH"
-    else
-        echo "No change: $IMG"
-    fi
-}
-
-export -f process_image
-
-# Find and process images
-echo "Scanning for images in $TARGET_DIR..."
-# Prune standard ignored directories
-find "$TARGET_DIR" \
-    \( -type d -name ".git" -o -name "node_modules" -o -name "dist" -o -name "build" -o -name "vendor" -o -name ".next" -o -name "coverage" \) -prune \
-    -o -type f \( -iname "*.jpg" -o -iname "*.jpeg" -o -iname "*.png" -o -iname "*.gif" -o -iname "*.webp" -o -iname "*.svg" \) -print0 | xargs -0 -P 4 -I {} bash -c 'process_image "$@"' _ {}
-
-echo "Done."

package/install.sh

@@ -1,68 +0,0 @@
-#!/bin/bash
-
-APP_NAME="imagestat"
-INSTALL_DIR="/usr/local/bin"
-TARGET_PATH="$INSTALL_DIR/$APP_NAME"
-SOURCE_FILE=""
-
-# Colors
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-echo -e "${GREEN}Installing $APP_NAME...${NC}"
-
-# Check sudo
-if [ "$EUID" -ne 0 ]; then 
-  echo -e "${YELLOW}Please run as root (sudo) to install globally.${NC}"
-  echo "Try: sudo ./install.sh"
-  exit 1
-fi
-
-# Locate source file
-if [ -f "imagestat" ]; then
-    SOURCE_FILE="imagestat"
-elif [ -f "imgstat.sh" ]; then
-    SOURCE_FILE="imgstat.sh"
-else
-    echo "Local script not found. Downloading from GitHub..."
-    REMOTE_URL="https://raw.githubusercontent.com/isaac0yen/imgstat/main/imagestat"
-    if command -v curl &> /dev/null; then
-        curl -fsSL "$REMOTE_URL" -o imagestat
-    elif command -v wget &> /dev/null; then
-        wget -q "$REMOTE_URL" -O imagestat
-    else
-        echo -e "${RED}Error: Neither curl nor wget found. Cannot download script.${NC}"
-        exit 1
-    fi
-    
-    if [ ! -f "imagestat" ]; then
-         echo -e "${RED}Error: Failed to download script.${NC}"
-         exit 1
-    fi
-    SOURCE_FILE="imagestat"
-fi
-
-# Check dependencies
-MISSING_DEPS=0
-if ! command -v identify &> /dev/null; then
-    echo -e "${RED}Error: 'identify' (ImageMagick) is not installed.${NC}"
-    MISSING_DEPS=1
-fi
-if ! command -v wget &> /dev/null; then
-    echo -e "${RED}Error: 'wget' is not installed.${NC}"
-    MISSING_DEPS=1
-fi
-
-if [ $MISSING_DEPS -eq 1 ]; then
-    echo -e "${YELLOW}Please install missing dependencies first.${NC}"
-    exit 1
-fi
-
-echo "Installing $SOURCE_FILE to $TARGET_PATH..."
-cp "$SOURCE_FILE" "$TARGET_PATH"
-chmod +x "$TARGET_PATH"
-
-echo -e "${GREEN}Success! $APP_NAME has been installed.${NC}"
-echo -e "Usage: ${GREEN}$APP_NAME [-u|--url <url>] [directory]${NC}"