make-folder-txt 2.0.0 → 2.1.0

package/README.md

@@ -11,7 +11,7 @@
 
 Perfect for sharing your codebase with **AI tools**, **teammates**, or **code reviewers** — without zipping files or giving repo access.
 
-[Installation](#-installation) · [Usage](#-usage) · [Help](#-get-help) · [Copy to Clipboard](#-copy-to-clipboard) · [Force Include Everything](#-force-include-everything) · [Shell Autocompletion](#-shell-autocompletion) · [Output Format](#-output-format) · [What Gets Skipped](#-what-gets-skipped) · [Contributing](#-contributing)
+[Installation](#-installation) · [Usage](#-usage) · [Help](#-get-help) · [Copy to Clipboard](#-copy-to-clipboard) · [Force Include Everything](#-force-include-everything) · [Shell Autocompletion](#-shell-autocompletion) · [File Size Control](#-file-size-control) · [Output Splitting](#-output-splitting) · [Output Format](#-output-format) · [What Gets Skipped](#-what-gets-skipped) · [Contributing](#-contributing)
 
 </div>
 
@@ -23,7 +23,9 @@ Ever needed to share your entire project with ChatGPT, Claude, or a teammate —
 
 - ✅ Run it from any project directory — no arguments needed
 - ✅ Built-in help system with `--help` flag
-- ✅ Shell autocompletion with `--install-completion`
+- ✅ **Built-in shell autocompletion** (installs automatically)
+- ✅ **File size control** with `--skip-large` and `--no-skip`
+- ✅ **Output splitting** by folders, files, or size
 - ✅ Copy to clipboard with `--copy` flag
 - ✅ Force include everything with `--force` flag
 - ✅ Generates a clean folder tree + every file's content
@@ -89,17 +91,24 @@ The `--force` flag overrides all ignore patterns and includes:
 
 Use this when you need a complete, unfiltered dump of your entire project.
 
-### ⚡ Shell Autocompletion
+### ⚡ Shell Autocompletion (Built-in)
 
 ```bash
-make-folder-txt --install-completion  # Install bash/zsh autocompletion
+make-folder-txt  # Autocompletion installs automatically on first run
 ```
 
-After installation, you'll get intelligent tab completion:
+**🎉 No installation required!** The tool automatically installs shell autocompletion the first time you run it.
+
+**What gets installed automatically:**
 - **Flag completion**: `make-folder-txt --<TAB>` shows all available flags
 - **Folder completion**: `make-folder-txt --ignore-folder <TAB>` shows folders
 - **File completion**: `make-folder-txt --ignore-file <TAB>` shows files
 
+**Supported Shells:**
+- **Bash** - Linux/macOS/Windows (WSL)
+- **Zsh** - macOS/Linux
+- **PowerShell** - Windows (7+)
+
 **Example usage:**
 ```bash
 $ make-folder-txt --ignore-folder b<TAB>
@@ -109,7 +118,92 @@ $ make-folder-txt --ignore-file p<TAB>
 # → completes to "package.json" if package.json exists
 ```
 
-The completion automatically detects your shell (bash/zsh) and installs the appropriate scripts. Restart your terminal after installation.
+**Manual Installation (if needed):**
+```bash
+make-folder-txt --install-completion  # Force reinstall completion
+```
+
+**PowerShell Manual Setup:**
+```powershell
+# If auto-installation doesn't work, load manually:
+. .\completion\make-folder-txt-completion.ps1
+
+# Or add to your PowerShell profile for persistence:
+notepad $PROFILE
+# Add: . "C:\path\to\make-folder-txt\completion\make-folder-txt-completion.ps1"
+```
+
+The completion works out of the box - just run the tool once and restart your terminal!
+
+### 📏 File Size Control
+
+```bash
+make-folder-txt --skip-large 400KB     # Skip files larger than 400KB
+make-folder-txt --skip-large 5GB       # Skip files larger than 5GB
+make-folder-txt --skip-large 1.5MB     # Skip files larger than 1.5MB
+make-folder-txt --no-skip               # Include all files regardless of size
+```
+
+**Default behavior**: Files larger than 500KB are skipped by default.
+
+**Supported size units**:
+- **B** - Bytes
+- **KB** - Kilobytes (1024 bytes)
+- **MB** - Megabytes (1024 KB)
+- **GB** - Gigabytes (1024 MB)
+- **TB** - Terabytes (1024 GB)
+
+**Examples:**
+```bash
+# More restrictive - skip anything over 100KB
+make-folder-txt --skip-large 100KB
+
+# More permissive - allow files up to 10MB
+make-folder-txt --skip-large 10MB
+
+# Include everything - no size limits
+make-folder-txt --no-skip
+
+# Combine with other options
+make-folder-txt --skip-large 2MB --ignore-folder node_modules
+```
+
+**Size format**: Accepts decimal numbers (e.g., `1.5MB`, `0.5GB`) and various units.
+
+### 📂 Output Splitting
+
+```bash
+make-folder-txt --split-method folder    # Split by folders
+make-folder-txt --split-method file      # Split by files  
+make-folder-txt --split-method size --split-size 5MB  # Split by file size
+```
+
+**Split Methods:**
+- **`folder`** - Creates separate files for each folder
+- **`file`** - Creates separate files for each individual file
+- **`size`** - Splits output when content exceeds specified size
+
+**Examples:**
+```bash
+# Split by folders - creates folder-name.txt for each folder
+make-folder-txt --split-method folder
+
+# Split by files - creates filename.txt for each file
+make-folder-txt --split-method file
+
+# Split by size - creates part-1.txt, part-2.txt, etc.
+make-folder-txt --split-method size --split-size 5MB
+
+# Combine with other options
+make-folder-txt --split-method size --split-size 2MB --ignore-folder node_modules
+```
+
+**Output Files:**
+- **Folder method**: `projectname-foldername.txt`
+- **File method**: `projectname-filename.txt`  
+- **Size method**: `projectname-part-1.txt`, `projectname-part-2.txt`, etc.
+
+**Note**: Splitting is not compatible with `--copy` flag.
 
 Ignore specific folders/files by name:
 

package/bin/make-folder-txt.js

@@ -179,13 +179,37 @@ function collectFiles(
   return { lines, filePaths, hasIncluded: filePaths.length > 0 || lines.length > 0 };
 }
 
-function readContent(absPath, force = false) {
+function parseFileSize(sizeStr) {
+  const units = {
+    'B': 1,
+    'KB': 1024,
+    'MB': 1024 * 1024,
+    'GB': 1024 * 1024 * 1024,
+    'TB': 1024 * 1024 * 1024 * 1024
+  };
+  
+  const match = sizeStr.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB|TB)$/i);
+  if (!match) {
+    console.error(`Error: Invalid size format "${sizeStr}". Use format like "500KB", "2MB", "1GB".`);
+    process.exit(1);
+  }
+  
+  const value = parseFloat(match[1]);
+  const unit = match[2].toUpperCase();
+  return Math.floor(value * units[unit]);
+}
+
+function readContent(absPath, force = false, maxFileSize = 500 * 1024) {
   const ext = path.extname(absPath).toLowerCase();
   if (!force && BINARY_EXTS.has(ext)) return "[binary / skipped]";
   try {
     const stat = fs.statSync(absPath);
-    if (!force && stat.size > 500 * 1024) {
-      return `[file too large: ${(stat.size / 1024).toFixed(1)} KB – skipped]`;
+    if (!force && stat.size > maxFileSize) {
+      const sizeStr = stat.size < 1024 ? `${stat.size} B` : 
+                     stat.size < 1024 * 1024 ? `${(stat.size / 1024).toFixed(1)} KB` :
+                     stat.size < 1024 * 1024 * 1024 ? `${(stat.size / (1024 * 1024)).toFixed(1)} MB` :
+                     `${(stat.size / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+      return `[file too large: ${sizeStr} – skipped]`;
     }
     return fs.readFileSync(absPath, "utf8");
   } catch (err) {
@@ -193,10 +217,361 @@ function readContent(absPath, force = false) {
   }
 }
 
+function splitByFolders(treeLines, filePaths, rootName, effectiveMaxSize, forceFlag) {
+  const folders = new Map();
+  
+  // Group files by folder
+  filePaths.forEach(({ abs, rel }) => {
+    const folderPath = path.dirname(rel);
+    const folderKey = folderPath === '/' ? rootName : folderPath.slice(1);
+    
+    if (!folders.has(folderKey)) {
+      folders.set(folderKey, []);
+    }
+    folders.get(folderKey).push({ abs, rel });
+  });
+  
+  const results = [];
+  
+  folders.forEach((files, folderName) => {
+    const out = [];
+    const divider = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+    
+    out.push(divider);
+    out.push(`START OF FOLDER: ${folderName}`);
+    out.push(divider);
+    out.push("");
+    
+    // Add folder structure (only this folder's structure)
+    const folderTreeLines = treeLines.filter(line => 
+      line.includes(folderName + '/') || line === `${rootName}/`
+    );
+    
+    out.push(divider);
+    out.push("PROJECT STRUCTURE");
+    out.push(divider);
+    out.push(`Root: ${folderPath}\n`);
+    out.push(`${rootName}/`);
+    folderTreeLines.forEach(l => out.push(l));
+    out.push("");
+    out.push(`Total files in this folder: ${files.length}`);
+    out.push("");
+    
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+    
+    files.forEach(({ abs, rel }) => {
+      out.push("");
+      out.push(subDivider);
+      out.push(`FILE: ${rel}`);
+      out.push(subDivider);
+      out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    });
+    
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FOLDER: ${folderName}`);
+    out.push(divider);
+    
+    const fileName = `${rootName}-${folderName.replace(/[\/\\]/g, '-')}.txt`;
+    const filePath = path.join(process.cwd(), fileName);
+    
+    fs.writeFileSync(filePath, out.join("\n"), "utf8");
+    const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+    
+    results.push({
+      file: filePath,
+      size: sizeKB,
+      files: files.length,
+      folder: folderName
+    });
+  });
+  
+  return results;
+}
+
+function splitByFiles(filePaths, rootName, effectiveMaxSize, forceFlag) {
+  const results = [];
+  
+  filePaths.forEach(({ abs, rel }) => {
+    const out = [];
+    const divider = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+    const fileName = path.basename(rel, path.extname(rel));
+    
+    out.push(divider);
+    out.push(`FILE: ${rel}`);
+    out.push(divider);
+    out.push("");
+    
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+    out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FILE: ${rel}`);
+    out.push(divider);
+    
+    const outputFileName = `${rootName}-${fileName}.txt`;
+    const filePath = path.join(process.cwd(), outputFileName);
+    
+    fs.writeFileSync(filePath, out.join("\n"), "utf8");
+    const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+    
+    results.push({
+      file: filePath,
+      size: sizeKB,
+      files: 1,
+      fileName: fileName
+    });
+  });
+  
+  return results;
+}
+
+function splitBySize(treeLines, filePaths, rootName, splitSize, effectiveMaxSize, forceFlag) {
+  const results = [];
+  let currentPart = 1;
+  let currentSize = 0;
+  let currentFiles = [];
+  
+  const divider = "=".repeat(80);
+  const subDivider = "-".repeat(80);
+  
+  // Start with header
+  let out = [];
+  out.push(divider);
+  out.push(`START OF FOLDER: ${rootName} (Part ${currentPart})`);
+  out.push(divider);
+  out.push("");
+  
+  out.push(divider);
+  out.push("PROJECT STRUCTURE");
+  out.push(divider);
+  out.push(`Root: ${folderPath}\n`);
+  out.push(`${rootName}/`);
+  treeLines.forEach(l => out.push(l));
+  out.push("");
+  out.push(`Total files: ${filePaths.length}`);
+  out.push("");
+  
+  out.push(divider);
+  out.push("FILE CONTENTS");
+  out.push(divider);
+  
+  filePaths.forEach(({ abs, rel }) => {
+    const content = readContent(abs, forceFlag, effectiveMaxSize);
+    const fileContent = [
+      "",
+      subDivider,
+      `FILE: ${rel}`,
+      subDivider,
+      content
+    ];
+    
+    const contentSize = fileContent.join("\n").length;
+    
+    // Check if adding this file would exceed the split size
+    if (currentSize + contentSize > splitSize && currentFiles.length > 0) {
+      // Finish current part
+      out.push("");
+      out.push(divider);
+      out.push(`END OF FOLDER: ${rootName} (Part ${currentPart})`);
+      out.push(divider);
+      
+      // Write current part
+      const fileName = `${rootName}-part-${currentPart}.txt`;
+      const filePath = path.join(process.cwd(), fileName);
+      fs.writeFileSync(filePath, out.join("\n"), "utf8");
+      const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+      
+      results.push({
+        file: filePath,
+        size: sizeKB,
+        files: currentFiles.length,
+        part: currentPart
+      });
+      
+      // Start new part
+      currentPart++;
+      currentSize = 0;
+      currentFiles = [];
+      
+      out = [];
+      out.push(divider);
+      out.push(`START OF FOLDER: ${rootName} (Part ${currentPart})`);
+      out.push(divider);
+      out.push("");
+      
+      out.push(divider);
+      out.push("PROJECT STRUCTURE");
+      out.push(divider);
+      out.push(`Root: ${folderPath}\n`);
+      out.push(`${rootName}/`);
+      treeLines.forEach(l => out.push(l));
+      out.push("");
+      out.push(`Total files: ${filePaths.length}`);
+      out.push("");
+      
+      out.push(divider);
+      out.push("FILE CONTENTS");
+      out.push(divider);
+    }
+    
+    // Add file to current part
+    out.push(...fileContent);
+    currentSize += contentSize;
+    currentFiles.push(rel);
+  });
+  
+  // Write final part
+  out.push("");
+  out.push(divider);
+  out.push(`END OF FOLDER: ${rootName} (Part ${currentPart})`);
+  out.push(divider);
+  
+  const fileName = `${rootName}-part-${currentPart}.txt`;
+  const filePath = path.join(process.cwd(), fileName);
+  fs.writeFileSync(filePath, out.join("\n"), "utf8");
+  const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+  
+  results.push({
+    file: filePath,
+    size: sizeKB,
+    files: currentFiles.length,
+    part: currentPart
+  });
+  
+  return results;
+}
+
 // ── main ──────────────────────────────────────────────────────────────────────
 
 const args = process.argv.slice(2);
 
+// Check if completion is already installed, install if not
+function checkAndInstallCompletion() {
+  const { execSync } = require('child_process');
+  const path = require('path');
+  const os = require('os');
+  const fs = require('fs');
+  
+  try {
+    const homeDir = os.homedir();
+    const shell = process.env.SHELL || '';
+    const platform = process.platform;
+    let completionInstalled = false;
+    
+    if (platform === 'win32') {
+      // Check PowerShell completion - try multiple profile locations
+      const profilePaths = [
+        path.join(homeDir, 'Documents', 'WindowsPowerShell', 'Microsoft.PowerShell_profile.ps1'),
+        path.join(homeDir, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1'),
+        path.join(homeDir, '.config', 'powershell', 'Microsoft.PowerShell_profile.ps1')
+      ];
+      
+      for (const profilePath of profilePaths) {
+        if (fs.existsSync(profilePath)) {
+          const profileContent = fs.readFileSync(profilePath, 'utf8');
+          if (profileContent.includes('make-folder-txt-completion')) {
+            completionInstalled = true;
+            break;
+          }
+        }
+      }
+    } else if (shell.includes('zsh')) {
+      // Check zsh completion
+      const zshrc = path.join(homeDir, '.zshrc');
+      if (fs.existsSync(zshrc)) {
+        const zshrcContent = fs.readFileSync(zshrc, 'utf8');
+        if (zshrcContent.includes('make-folder-txt')) {
+          completionInstalled = true;
+        }
+      }
+    } else {
+      // Check bash completion
+      const bashrc = path.join(homeDir, '.bashrc');
+      if (fs.existsSync(bashrc)) {
+        const bashrcContent = fs.readFileSync(bashrc, 'utf8');
+        if (bashrcContent.includes('make-folder-txt-completion')) {
+          completionInstalled = true;
+        }
+      }
+    }
+    
+    // If completion is not installed, install it automatically
+    if (!completionInstalled) {
+      console.log('🔧 Installing shell autocompletion for make-folder-txt...');
+      
+      if (platform === 'win32') {
+        // Windows PowerShell
+        try {
+          execSync('powershell -Command "Get-Host"', { stdio: 'ignore' });
+          const installScript = path.join(__dirname, '..', 'completion', 'install-powershell-completion.ps1');
+          execSync(`powershell -ExecutionPolicy Bypass -File "${installScript}"`, { stdio: 'ignore' });
+          console.log('✅ PowerShell completion installed!');
+        } catch (err) {
+          // Silent fail for PowerShell
+        }
+      } else if (shell.includes('zsh')) {
+        // zsh
+        try {
+          const zshrc = path.join(homeDir, '.zshrc');
+          const completionDir = path.join(homeDir, '.zsh', 'completions');
+          execSync(`mkdir -p "${completionDir}"`, { stdio: 'ignore' });
+          const completionPath = path.join(__dirname, '..', 'completion', 'make-folder-txt-completion.zsh');
+          execSync(`cp "${completionPath}" "${completionDir}/_make-folder-txt"`, { stdio: 'ignore' });
+          
+          try {
+            const zshrcContent = fs.readFileSync(zshrc, 'utf8');
+            if (!zshrcContent.includes('fpath+=~/.zsh/completions')) {
+              fs.appendFileSync(zshrc, '\n# make-folder-txt completion\nfpath+=~/.zsh/completions\nautoload -U compinit && compinit\n');
+            }
+          } catch (e) {
+            fs.writeFileSync(zshrc, '# make-folder-txt completion\nfpath+=~/.zsh/completions\nautoload -U compinit && compinit\n');
+          }
+          console.log('✅ Zsh completion installed!');
+        } catch (err) {
+          // Silent fail for zsh
+        }
+      } else {
+        // bash
+        try {
+          const bashrc = path.join(homeDir, '.bashrc');
+          const completionPath = path.join(__dirname, '..', 'completion', 'make-folder-txt-completion.bash');
+          try {
+            const bashrcContent = fs.readFileSync(bashrc, 'utf8');
+            if (!bashrcContent.includes('make-folder-txt-completion.bash')) {
+              fs.appendFileSync(bashrc, `\n# make-folder-txt completion\nsource "${completionPath}"\n`);
+            }
+          } catch (e) {
+            fs.writeFileSync(bashrc, `# make-folder-txt completion\nsource "${completionPath}"\n`);
+          }
+          console.log('✅ Bash completion installed!');
+        } catch (err) {
+          // Silent fail for bash
+        }
+      }
+      
+      console.log('💡 Restart your terminal to enable autocompletion');
+      console.log('');
+    }
+  } catch (err) {
+    // Silent fail - don't interrupt the main functionality
+  }
+}
+
+// Run completion check on first run (but not for help/version commands)
+if (!args.includes("--help") && !args.includes("-h") && 
+    !args.includes("--version") && !args.includes("-v") && 
+    !args.includes("--install-completion")) {
+  checkAndInstallCompletion();
+}
+
 if (args.includes("--install-completion")) {
   const { execSync } = require('child_process');
   const path = require('path');
@@ -205,8 +580,26 @@ if (args.includes("--install-completion")) {
   try {
     const homeDir = os.homedir();
     const shell = process.env.SHELL || '';
+    const platform = process.platform;
     
-    if (shell.includes('zsh')) {
+    if (platform === 'win32') {
+      // Windows - Check if PowerShell is available
+      try {
+        execSync('powershell -Command "Get-Host"', { stdio: 'ignore' });
+        
+        // Install PowerShell completion
+        const completionScript = path.join(__dirname, '..', 'completion', 'make-folder-txt-completion.ps1');
+        const installScript = path.join(__dirname, '..', 'completion', 'install-powershell-completion.ps1');
+        
+        // Run the PowerShell installation script
+        execSync(`powershell -ExecutionPolicy Bypass -File "${installScript}"`, { stdio: 'inherit' });
+        
+      } catch (err) {
+        console.error('❌ Failed to install PowerShell completion:', err.message);
+        process.exit(1);
+      }
+      
+    } else if (shell.includes('zsh')) {
       // Install for zsh
       const zshrc = path.join(homeDir, '.zshrc');
       const completionDir = path.join(homeDir, '.zsh', 'completions');
@@ -278,9 +671,13 @@ Dump an entire project folder into a single readable .txt file.
   --ignore-file, -ifi <names...>      Ignore specific files by name
   --only-folder, -ofo <names...>      Include only specific folders
   --only-file, -ofi <names...>        Include only specific files
+  --skip-large <size>                 Skip files larger than specified size (default: 500KB)
+  --no-skip                           Include all files regardless of size
+  --split-method <method>             Split output: folder, file, or size
+  --split-size <size>                 Split output when size exceeds limit (requires --split-method size)
   --copy                              Copy output to clipboard
   --force                             Include everything (overrides all ignore patterns)
-  --install-completion                 Install shell autocompletion (bash/zsh)
+  --install-completion         Install shell autocompletion (bash/zsh/PowerShell) - usually automatic
   --help, -h                          Show this help message
   --version, -v                       Show version information
 
@@ -288,6 +685,12 @@ Dump an entire project folder into a single readable .txt file.
   make-folder-txt
   make-folder-txt --copy
   make-folder-txt --force
+  make-folder-txt --skip-large 400KB
+  make-folder-txt --skip-large 5GB
+  make-folder-txt --no-skip
+  make-folder-txt --split-method folder
+  make-folder-txt --split-method file
+  make-folder-txt --split-method size --split-size 5MB
   make-folder-txt --install-completion
   make-folder-txt --ignore-folder node_modules dist
   make-folder-txt -ifo node_modules dist
@@ -319,6 +722,10 @@ const onlyFiles = new Set();
 let outputArg = null;
 let copyToClipboardFlag = false;
 let forceFlag = false;
+let maxFileSize = 500 * 1024; // Default 500KB
+let noSkipFlag = false;
+let splitMethod = null; // 'folder', 'file', 'size'
+let splitSize = null; // size in bytes
 
 for (let i = 0; i < args.length; i += 1) {
   const arg = args[i];
@@ -333,6 +740,81 @@ for (let i = 0; i < args.length; i += 1) {
     continue;
   }
 
+  if (arg === "--no-skip") {
+    noSkipFlag = true;
+    continue;
+  }
+
+  if (arg === "--skip-large") {
+    if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+      console.error("Error: --skip-large requires a size value (e.g., 400KB, 5GB).");
+      process.exit(1);
+    }
+    maxFileSize = parseFileSize(args[i + 1]);
+    i += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--skip-large=")) {
+    const value = arg.slice("--skip-large=".length);
+    if (!value) {
+      console.error("Error: --skip-large requires a size value (e.g., 400KB, 5GB).");
+      process.exit(1);
+    }
+    maxFileSize = parseFileSize(value);
+    continue;
+  }
+
+  if (arg === "--split-method") {
+    if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+      console.error("Error: --split-method requires a method (folder, file, or size).");
+      process.exit(1);
+    }
+    const method = args[i + 1].toLowerCase();
+    if (!['folder', 'file', 'size'].includes(method)) {
+      console.error("Error: --split-method must be one of: folder, file, size");
+      process.exit(1);
+    }
+    splitMethod = method;
+    i += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--split-method=")) {
+    const value = arg.slice("--split-method=".length);
+    if (!value) {
+      console.error("Error: --split-method requires a method (folder, file, or size).");
+      process.exit(1);
+    }
+    const method = value.toLowerCase();
+    if (!['folder', 'file', 'size'].includes(method)) {
+      console.error("Error: --split-method must be one of: folder, file, size");
+      process.exit(1);
+    }
+    splitMethod = method;
+    continue;
+  }
+
+  if (arg === "--split-size") {
+    if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+      console.error("Error: --split-size requires a size value (e.g., 5MB, 10MB).");
+      process.exit(1);
+    }
+    splitSize = parseFileSize(args[i + 1]);
+    i += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--split-size=")) {
+    const value = arg.slice("--split-size=".length);
+    if (!value) {
+      console.error("Error: --split-size requires a size value (e.g., 5MB, 10MB).");
+      process.exit(1);
+    }
+    splitSize = parseFileSize(value);
+    continue;
+  }
+
   if (arg === "--ignore-folder" || arg === "-ifo") {
     let consumed = 0;
     while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
@@ -451,6 +933,17 @@ for (let i = 0; i < args.length; i += 1) {
   process.exit(1);
 }
 
+// Validate split options
+if (splitMethod === 'size' && !splitSize) {
+  console.error("Error: --split-method size requires --split-size to be specified.");
+  process.exit(1);
+}
+
+if (splitSize && splitMethod !== 'size') {
+  console.error("Error: --split-size can only be used with --split-method size.");
+  process.exit(1);
+}
+
 const folderPath = process.cwd();
 const rootName = path.basename(folderPath);
 
@@ -474,7 +967,47 @@ const { lines: treeLines, filePaths } = collectFiles(
   { hasOnlyFilters, rootName, txtIgnore, force: forceFlag },
 );
 
-// ── build output ──────────────────────────────────────────────────────────────
+// ── handle splitting ──────────────────────────────────────────────────────────────
+const effectiveMaxSize = noSkipFlag ? Infinity : maxFileSize;
+
+if (splitMethod) {
+  console.log(`🔧 Splitting output by: ${splitMethod}`);
+  
+  let results;
+  
+  if (splitMethod === 'folder') {
+    results = splitByFolders(treeLines, filePaths, rootName, effectiveMaxSize, forceFlag);
+  } else if (splitMethod === 'file') {
+    results = splitByFiles(filePaths, rootName, effectiveMaxSize, forceFlag);
+  } else if (splitMethod === 'size') {
+    results = splitBySize(treeLines, filePaths, rootName, splitSize, effectiveMaxSize, forceFlag);
+  }
+  
+  console.log(`✅  Done! Created ${results.length} split files:`);
+  console.log('');
+  
+  results.forEach((result, index) => {
+    if (splitMethod === 'folder') {
+      console.log(`📁  Folder: ${result.folder}`);
+    } else if (splitMethod === 'file') {
+      console.log(`📄  File: ${result.fileName}`);
+    } else if (splitMethod === 'size') {
+      console.log(`📦  Part ${result.part}`);
+    }
+    console.log(`📄  Output : ${result.file}`);
+    console.log(`📊  Size   : ${result.size} KB`);
+    console.log(`🗂️   Files  : ${result.files}`);
+    console.log('');
+  });
+  
+  if (copyToClipboardFlag) {
+    console.log('⚠️  --copy flag is not compatible with splitting - clipboard copy skipped');
+  }
+  
+  process.exit(0);
+}
+
+// ── build output (no splitting) ───────────────────────────────────────────────────
 const out = [];
 const divider    = "=".repeat(80);
 const subDivider = "-".repeat(80);
@@ -499,11 +1032,12 @@ out.push("FILE CONTENTS");
 out.push(divider);
 
 filePaths.forEach(({ abs, rel }) => {
-  out.push("");
-  out.push(subDivider);
-  out.push(`FILE: ${rel}`);
-  out.push(subDivider);
-  out.push(readContent(abs, forceFlag));
+out.push("");
+out.push(subDivider);
+out.push(`FILE: ${rel}`);
+out.push(subDivider);
+const effectiveMaxSize = noSkipFlag ? Infinity : maxFileSize;
+out.push(readContent(abs, forceFlag, effectiveMaxSize));
 });
 
 out.push("");

package/completion/install-powershell-completion.ps1

@@ -0,0 +1,75 @@
+# PowerShell completion installation script for make-folder-txt
+
+function Install-MakeFolderTxtCompletion {
+    param(
+        [switch]$Force,
+        [switch]$CurrentUser
+    )
+    
+    $ErrorActionPreference = 'Stop'
+    
+    # Determine PowerShell profile path
+    if ($CurrentUser) {
+        $profilePath = $PROFILE.CurrentUserCurrentHost
+    } else {
+        $profilePath = $PROFILE.AllUsersCurrentHost
+    }
+    
+    # Create profile directory if it doesn't exist
+    $profileDir = Split-Path $profilePath -Parent
+    if (-not (Test-Path $profileDir)) {
+        try {
+            New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
+            Write-Host "Created profile directory: $profileDir" -ForegroundColor Green
+        } catch {
+            Write-Error "Failed to create profile directory: $profileDir"
+            return
+        }
+    }
+    
+    # Get the completion script content
+    $completionScriptPath = Join-Path $PSScriptRoot 'make-folder-txt-completion.ps1'
+    if (-not (Test-Path $completionScriptPath)) {
+        Write-Error "Completion script not found: $completionScriptPath"
+        return
+    }
+    
+    $completionContent = Get-Content $completionScriptPath -Raw
+    
+    # Check if completion is already installed
+    if (Test-Path $profilePath) {
+        $profileContent = Get-Content $profilePath -Raw
+        if ($profileContent -match 'make-folder-txt.*completion') {
+            if (-not $Force) {
+                Write-Host "make-folder-txt completion is already installed in $profilePath" -ForegroundColor Yellow
+                Write-Host "Use -Force to reinstall" -ForegroundColor Yellow
+                return
+            }
+            Write-Host "Removing existing completion..." -ForegroundColor Yellow
+            # Remove existing completion
+            $profileContent = $profileContent -replace '(?s)# make-folder-txt completion.*?Register-ArgumentComplester.*?Export-ModuleMember.*?\n', ''
+            Set-Content $profilePath $profileContent -Force
+        }
+    }
+    
+    # Add completion to profile
+    $completionBlock = @"
+
+# make-folder-txt completion
+$completionContent
+"@
+    
+    try {
+        Add-Content $profilePath $completionBlock -Force
+        Write-Host "✅ PowerShell completion installed successfully!" -ForegroundColor Green
+        Write-Host "Added to: $profilePath" -ForegroundColor Cyan
+        Write-Host "Restart PowerShell or run: . `$profile" -ForegroundColor Cyan
+    } catch {
+        Write-Error "Failed to install completion: $_"
+    }
+}
+
+# Auto-install if script is run directly
+if ($MyInvocation.InvocationName -eq $MyInvocation.MyCommand.Name) {
+    Install-MakeFolderTxtCompletion -CurrentUser
+}

package/completion/make-folder-txt-completion.bash

@@ -7,7 +7,7 @@ _make_folder_txt_completion() {
     cur="${COMP_WORDS[COMP_CWORD]}"
     prev="${COMP_WORDS[COMP_CWORD-1]}"
     
-    opts="--ignore-folder -ifo --ignore-file -ifi --only-folder -ofo --only-file -ofi --copy --force --help --version -h -v"
+    opts="--ignore-folder -ifo --ignore-file -ifi --only-folder -ofo --only-file -ofi --skip-large --no-skip --split-method --split-size --copy --force --help --version -h -v"
     
     case "${prev}" in
         --ignore-folder|-ifo)
@@ -28,6 +28,24 @@ _make_folder_txt_completion() {
             COMPREPLY=( $(compgen -W "${folders}" -- ${cur}) )
             return 0
             ;;
+        --skip-large)
+            # Complete with common size formats
+            local sizes="100KB 200KB 400KB 500KB 1MB 5MB 10MB 100MB 1GB 5GB"
+            COMPREPLY=( $(compgen -W "${sizes}" -- ${cur}) )
+            return 0
+            ;;
+        --split-method)
+            # Complete with split methods
+            local methods="folder file size"
+            COMPREPLY=( $(compgen -W "${methods}" -- ${cur}) )
+            return 0
+            ;;
+        --split-size)
+            # Complete with common size formats
+            local sizes="1MB 5MB 10MB 50MB 100MB 500MB 1GB"
+            COMPREPLY=( $(compgen -W "${sizes}" -- ${cur}) )
+            return 0
+            ;;
         *)
             ;;
     esac

package/completion/make-folder-txt-completion.ps1

@@ -0,0 +1,95 @@
+# make-folder-txt PowerShell completion script
+
+Register-ArgumentCompleter -Native -CommandName 'make-folder-txt' -ScriptBlock {
+    param($commandName, $wordToComplete, $commandAst, $fakeBoundParameters)
+
+    # Get the current argument being completed
+    $currentArgument = $wordToComplete
+
+    # Define available options
+    $options = @(
+        '--ignore-folder', '-ifo',
+        '--ignore-file', '-ifi', 
+        '--only-folder', '-ofo',
+        '--only-file', '-ofi',
+        '--skip-large',
+        '--no-skip',
+        '--split-method',
+        '--split-size',
+        '--copy',
+        '--force',
+        '--install-completion',
+        '--help', '-h',
+        '--version', '-v'
+    )
+
+    # Get the previous parameter to determine context
+    $previousParameter = if ($commandAst.CommandElements.Count -gt 1) {
+        $commandAst.CommandElements[-2].Extent.Text
+    } else {
+        ''
+    }
+
+    switch ($previousParameter) {
+        { $_ -in '--ignore-folder', '-ifo', '--only-folder', '-ofo' } {
+            # Complete with folder names
+            try {
+                $folders = Get-ChildItem -Directory -Name | Where-Object { $_ -like "*$currentArgument*" }
+                return $folders | ForEach-Object { 
+                    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Folder: $_")
+                }
+            } catch {
+                return @()
+            }
+        }
+        { $_ -in '--ignore-file', '-ifi', '--only-file', '-ofi' } {
+            # Complete with file names
+            try {
+                $files = Get-ChildItem -File -Name | Where-Object { $_ -like "*$currentArgument*" }
+                return $files | ForEach-Object { 
+                    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "File: $_")
+                }
+            } catch {
+                return @()
+            }
+        }
+        '--skip-large' {
+            # Complete with common size formats
+            $sizes = @('100KB', '200KB', '400KB', '500KB', '1MB', '5MB', '10MB', '100MB', '1GB', '5GB')
+            $matchingSizes = $sizes | Where-Object { $_ -like "*$currentArgument*" }
+            return $matchingSizes | ForEach-Object { 
+                [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Size: $_")
+            }
+        }
+        '--split-method' {
+            # Complete with split methods
+            $methods = @('folder', 'file', 'size')
+            $matchingMethods = $methods | Where-Object { $_ -like "*$currentArgument*" }
+            return $matchingMethods | ForEach-Object { 
+                [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Method: $_")
+            }
+        }
+        '--split-size' {
+            # Complete with common size formats
+            $sizes = @('1MB', '5MB', '10MB', '50MB', '100MB', '500MB', '1GB')
+            $matchingSizes = $sizes | Where-Object { $_ -like "*$currentArgument*" }
+            return $matchingSizes | ForEach-Object { 
+                [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Size: $_")
+            }
+        }
+        default {
+            # Complete with options
+            if ($currentArgument -like '-*') {
+                $matchingOptions = $options | Where-Object { $_ -like "*$currentArgument*" }
+                return $matchingOptions | ForEach-Object { 
+                    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', "Option: $_")
+                }
+            }
+        }
+    }
+
+    return @()
+}
+
+# Export the completion function
+Export-ModuleMember -Function *

package/completion/make-folder-txt-completion.zsh

@@ -12,6 +12,10 @@ _make_folder_txt() {
         '-ofo[Include only specific folders]:folder:_directories'
         '--only-file[Include only specific files]:file:_files'
         '-ofi[Include only specific files]:file:_files'
+        '--skip-large[Skip files larger than specified size]:size:(100KB 200KB 400KB 500KB 1MB 5MB 10MB 100MB 1GB 5GB)'
+        '--no-skip[Include all files regardless of size]'
+        '--split-method[Split output by method]:method:(folder file size)'
+        '--split-size[Split output when size exceeds limit]:size:(1MB 5MB 10MB 50MB 100MB 500MB 1GB)'
         '--copy[Copy output to clipboard]'
         '--force[Include everything (overrides all ignore patterns)]'
         '--help[Show help message]'

package/make-folder-txt.txt

@@ -0,0 +1,52 @@
+================================================================================
+START OF FOLDER: make-folder-txt
+================================================================================
+
+================================================================================
+PROJECT STRUCTURE
+================================================================================
+Root: C:\Programming\make-folder-txt
+
+make-folder-txt/
+├── package.json
+
+Total files: 1
+
+================================================================================
+FILE CONTENTS
+================================================================================
+
+--------------------------------------------------------------------------------
+FILE: /package.json
+--------------------------------------------------------------------------------
+{
+  "name": "make-folder-txt",
+  "version": "2.0.1",
+  "description": "Generate a single .txt file containing the full folder structure and file contents of any project, ignoring node_modules and other junk.",
+  "main": "bin/make-folder-txt.js",
+  "bin": {
+    "make-folder-txt": "bin/make-folder-txt.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "folder",
+    "dump",
+    "project",
+    "structure",
+    "txt",
+    "cli",
+    "export"
+  ],
+  "author": "Muhammad Saad Amin",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}
+
+
+================================================================================
+END OF FOLDER: make-folder-txt
+================================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "make-folder-txt",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Generate a single .txt file containing the full folder structure and file contents of any project, ignoring node_modules and other junk.",
   "main": "bin/make-folder-txt.js",
   "bin": {