Description

This PR adds a command-line interface to gitingest, allowing users to analyze local directories without needing to run the web server. The CLI tool can be installed globally and provides similar functionality to the web interface.

Features

• Global command-line tool installation via pip install -e .
• Analyze any local directory with gitingest /path/to/directory
• Configurable output location with -o flag
• Support for custom file size limits with --max-size
• Additional ignore patterns via -i flag
• Maintains compatibility with web app's ingest functionality
• Automatic file type detection and text content extraction
• Directory tree visualization
• File content summary with statistics

Usage Examples

# Basic usage - outputs to <dirname>.txt
gitingest ~/projects/myproject

# Custom output location
gitingest ~/projects/myproject -o ~/Desktop/analysis.txt

# Ignore specific patterns
gitingest ~/projects/myproject -i "*.csv" -i "*.json"

# Set maximum file size (e.g., 5MB)
gitingest ~/projects/myproject -s 5000000

Technical Details

• Uses Click for CLI argument parsing and help documentation
• Shares core functionality with web app through ingest.py
• Maintains same ignore patterns and file type detection
• Preserves token counting and size limit features

Documentation

• Added CLI usage section to README.md
• Included installation instructions
• Documented all available options
• Added usage examples

Testing

The CLI has been tested with:

• Different directory sizes and structures
• Various file types
• Custom ignore patterns
• Different output locations
• Size limit enforcement