Documentation

# AI Configuration (required for AI features)
GEMINI_API_KEY=your-api-key-here

# Optional: Performance tuning
COPYTREE_MAX_FILE_SIZE=configurable  # Set size limit
COPYTREE_MAX_TOTAL_SIZE=configurable # Set total limit
COPYTREE_MAX_CONCURRENCY=5

# Optional: Cache settings
CACHE_ENABLED=true
CACHE_FILE_PATH=~/.copytree/cache

# Run setup wizard
copytree install:copytree

# Validate configuration
copytree config:validate

# List available profiles
copytree profile:list

{
  "profile": "laravel",
  "format": "xml",
  "transforms": {
    "enabled": true,
    "preferredTransformers": ["ai-summary", "pdf", "image-description"]
  },
  "filters": {
    "include": ["src/**", "app/**"],
    "exclude": ["**/*.test.js", "node_modules/**", "vendor/**"],
    "alwaysInclude": ["README.md", "package.json", "composer.json"]
  },
  "output": {
    "charLimit": 100000,
    "fileLimit": 500,
    "clipboard": true
  },
  "git": {
    "respectGitignore": true,
    "includeUntracked": false
  },
  "cache": {
    "enabled": true,
    "ttl": 86400
  }
}

# Required for AI features
export GEMINI_API_KEY=your-api-key-here

# Performance settings
export COPYTREE_MAX_FILE_SIZE=1048576
export COPYTREE_MAX_TOTAL_SIZE=10485760
export COPYTREE_MAX_CONCURRENCY=5

# Cache configuration
export CACHE_ENABLED=true
export CACHE_FILE_PATH=~/.copytree/cache

# .copytree/profiles/my-custom-profile.yaml
name: my-custom-profile
description: Custom profile for my specific project

include:
  - "src/**/*.js"
  - "lib/**/*.js"
  - "config/**"

exclude:
  - "**/*.test.js"
  - "**/*.spec.js"
  - "**/node_modules/**"
  - "**/coverage/**"

alwaysInclude:
  - "README.md"
  - "package.json"
  - ".env.example"

transforms:
  enabled: true
  preferredTransformers:
    - ai-summary
    - pdf
    - image-description

options:
  respectGitignore: true
  includeUntracked: false
  charLimit: 150000

# .copytree/profiles/my-monorepo.yaml
name: my-monorepo
description: Custom profile for our monorepo structure

# Base profile to extend from
extends: default

# File patterns to include
include:
  - "packages/*/src/**"
  - "apps/*/src/**"
  - "shared/**"

# File patterns to exclude  
exclude:
  - "**/node_modules/**"
  - "**/dist/**"
  - "**/build/**"
  - "**/*.test.*"
  - "**/__tests__/**"

# Files to always include regardless of filters
alwaysInclude:
  - "README.md"
  - "lerna.json"
  - "package.json"
  - "pnpm-workspace.yaml"

# Transformer configuration
transforms:
  enabled: true
  preferredTransformers:
    - ai-summary
    - pdf
    - image-description
  
# Additional options
options:
  respectGitignore: true
  includeUntracked: false
  charLimit: 200000
  fileLimit: 1000

// .copytree/transformers/my-transformer.js
module.exports = {
  name: 'my-transformer',
  
  // File patterns this transformer handles
  patterns: ['*.myext', '*.custom'],
  
  // Priority (higher runs first)
  priority: 100,
  
  // Transform function
  async transform(file, content, options) {
    // Process the file content
    const processed = await myCustomProcessing(content);
    
    // Return transformed content
    return {
      content: processed,
      metadata: {
        transformer: 'my-transformer',
        processedAt: new Date().toISOString()
      }
    };
  },
  
  // Optional: Check if transformer should run
  shouldTransform(file, options) {
    // Custom logic to determine if transformer applies
    return file.size < 1000000; // Only files under 1MB
  }
};

{
  "transforms": {
    "enabled": true,
    "preferredTransformers": [
      "ai-summary",
      "pdf",
      "image-description"
    ],
    "transformerOptions": {
      "ai-summary": {
        "maxLength": 500,
        "style": "technical"
      },
      "pdf": {
        "extractImages": false,
        "preserveFormatting": true
      },
      "first-lines": {
        "lineCount": 50
      }
    },
    "customTransformersPath": ".copytree/transformers"
  }
}

# Cache configuration in .copytreerc
{
  "cache": {
    "enabled": true,
    "ttl": 86400,              // 24 hours in seconds
    "maxSize": "auto",         // Configurable cache size limit
    "strategy": "lru",         // Least Recently Used eviction
    "location": "~/.copytree/cache"
  }
}

# Clear cache manually
copytree cache:clear

# Run without cache
copytree --no-cache

# Show cache statistics
copytree cache:stats

// .copytree/pipeline/my-stage.js
module.exports = {
  name: 'my-custom-stage',
  order: 550, // Runs after transform (500) but before output (600)
  
  async process(files, options, context) {
    // Add custom metadata to all files
    const processedFiles = await Promise.all(
      files.map(async (file) => {
        const metrics = await analyzeCode(file.content);
        
        return {
          ...file,
          metadata: {
            ...file.metadata,
            complexity: metrics.complexity,
            lines: metrics.lines,
            dependencies: metrics.dependencies
          }
        };
      })
    );
    
    // Emit event for monitoring
    context.emit('custom-stage:complete', {
      filesProcessed: processedFiles.length
    });
    
    return processedFiles;
  }
};

#!/bin/bash
# copytree-daily-summary.sh

# Configuration
OUTPUT_DIR="./ai-contexts"
DATE=$(date +%Y-%m-%d)

# Create output directory
mkdir -p "$OUTPUT_DIR"

# Generate different contexts for different purposes
echo "Generating code contexts..."

# 1. Modified files context
copytree --modified \
         --format xml \
         --output "$OUTPUT_DIR/daily-changes-$DATE.xml"

# 2. Full project snapshot
copytree --profile default \
         --char-limit 500000 \
         --output "$OUTPUT_DIR/project-snapshot-$DATE.xml"

# 3. Test coverage context
copytree --filter "**/*.test.*" "**/*.spec.*" \
         --transformers "unit-test-summary" \
         --output "$OUTPUT_DIR/test-coverage-$DATE.xml"

# 4. Architecture overview
copytree --only-tree \
         --with-stats \
         --output "$OUTPUT_DIR/architecture-$DATE.txt"

echo "✅ Generated contexts in $OUTPUT_DIR"

# Optional: Upload to cloud storage
# aws s3 sync "$OUTPUT_DIR" "s3://my-bucket/copytree-contexts/"