List files in a specified directory with optional filtering.

Args: directory: Directory path to list files from (default: current directory) pattern: File pattern to match (e.g., ".py", ".txt") (default: "*") include_hidden: Whether to include hidden files (default: False)

Returns: List of dictionaries containing file information (name, size, type, path)

Example: list_files(directory=".", pattern="*.py") list_files(directory="/home/user/documents", include_hidden=True)

Find duplicate files in a directory based on content hash.

Args: directory: Directory path to search for duplicates (default: current directory) recursive: Whether to search recursively in subdirectories (default: True)

Returns: Dictionary with hash as key and list of duplicate file paths as values

Example: find_duplicates(directory="./documents") find_duplicates(directory="/home/user", recursive=False)

Delete duplicate files in a directory, keeping only one copy of each file. Uses intelligent copy detection to prioritize deleting files with copy indicators (like "copy", "(1)", "(2)", etc.) over original files.

Args: directory: Directory path to search for duplicates (default: current directory) recursive: Whether to search recursively in subdirectories (default: True) dry_run: If True, only show what would be deleted without actually deleting (default: True)

Returns: Dictionary with information about deleted files and preserved originals

Example: delete_duplicates(directory="./documents", dry_run=True) # Preview only delete_duplicates(directory="./documents", dry_run=False) # Actually delete