make-folder-txt 2.0.1 → 2.1.1

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>
 
@@ -24,6 +24,8 @@ 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
 - ✅ **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
@@ -133,6 +135,76 @@ notepad $PROFILE
 
 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:
 
 ```bash

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,11 +217,243 @@ 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
+// Check if completion is already installed, install if not (silent on subsequent runs)
 function checkAndInstallCompletion() {
   const { execSync } = require('child_process');
   const path = require('path');
@@ -211,19 +467,33 @@ function checkAndInstallCompletion() {
     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) {
+      // Check PowerShell completion - use the same path as the installation script
+      try {
+        // Get the PowerShell profile path like the installation script does
+        const profilePathResult = execSync('powershell -Command "echo $PROFILE.CurrentUserCurrentHost"', { encoding: 'utf8' }).trim();
+        const profilePath = profilePathResult.replace(/['"]/g, '').replace(/\.CurrentUserCurrentHost$/, ''); // Remove quotes and suffix
+        
         if (fs.existsSync(profilePath)) {
           const profileContent = fs.readFileSync(profilePath, 'utf8');
-          if (profileContent.includes('make-folder-txt-completion')) {
+          if (profileContent.includes('make-folder-txt') || profileContent.includes('Register-ArgumentCompleter')) {
             completionInstalled = true;
-            break;
+          }
+        }
+      } catch (err) {
+        // If PowerShell detection fails, try fallback paths
+        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') || profileContent.includes('Register-ArgumentCompleter')) {
+              completionInstalled = true;
+              break;
+            }
           }
         }
       }
@@ -247,7 +517,7 @@ function checkAndInstallCompletion() {
       }
     }
     
-    // If completion is not installed, install it automatically
+    // If completion is not installed, install it automatically (show message only first time)
     if (!completionInstalled) {
       console.log('🔧 Installing shell autocompletion for make-folder-txt...');
       
@@ -257,7 +527,7 @@ function checkAndInstallCompletion() {
           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!');
+          console.log('✅ PowerShell completion installed! Restart your terminal to enable autocompletion');
         } catch (err) {
           // Silent fail for PowerShell
         }
@@ -278,7 +548,7 @@ function checkAndInstallCompletion() {
           } catch (e) {
             fs.writeFileSync(zshrc, '# make-folder-txt completion\nfpath+=~/.zsh/completions\nautoload -U compinit && compinit\n');
           }
-          console.log('✅ Zsh completion installed!');
+          console.log('✅ Zsh completion installed! Restart your terminal or run: source ~/.zshrc');
         } catch (err) {
           // Silent fail for zsh
         }
@@ -295,7 +565,7 @@ function checkAndInstallCompletion() {
           } catch (e) {
             fs.writeFileSync(bashrc, `# make-folder-txt completion\nsource "${completionPath}"\n`);
           }
-          console.log('✅ Bash completion installed!');
+          console.log('✅ Bash completion installed! Restart your terminal or run: source ~/.bashrc');
         } catch (err) {
           // Silent fail for bash
         }
@@ -309,7 +579,7 @@ function checkAndInstallCompletion() {
   }
 }
 
-// Run completion check on first run (but not for help/version commands)
+// Run completion check on first run (but not for help/version/install-completion commands)
 if (!args.includes("--help") && !args.includes("-h") && 
     !args.includes("--version") && !args.includes("-v") && 
     !args.includes("--install-completion")) {
@@ -336,7 +606,8 @@ if (args.includes("--install-completion")) {
         const installScript = path.join(__dirname, '..', 'completion', 'install-powershell-completion.ps1');
         
         // Run the PowerShell installation script
-        execSync(`powershell -ExecutionPolicy Bypass -File "${installScript}"`, { stdio: 'inherit' });
+        execSync(`powershell -ExecutionPolicy Bypass -File "${installScript}"`, { stdio: 'ignore' });
+        console.log('✅ PowerShell completion installed! Restart your terminal to enable autocompletion');
         
       } catch (err) {
         console.error('❌ Failed to install PowerShell completion:', err.message);
@@ -415,6 +686,10 @@ 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/PowerShell) - usually automatic
@@ -425,6 +700,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
@@ -456,6 +737,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];
@@ -470,6 +755,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("-")) {
@@ -588,6 +948,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);
 
@@ -611,7 +982,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);
@@ -636,11 +1047,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/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

@@ -12,6 +12,10 @@ Register-ArgumentCompleter -Native -CommandName 'make-folder-txt' -ScriptBlock {
         '--ignore-file', '-ifi', 
         '--only-folder', '-ofo',
         '--only-file', '-ofi',
+        '--skip-large',
+        '--no-skip',
+        '--split-method',
+        '--split-size',
         '--copy',
         '--force',
         '--install-completion',
@@ -49,6 +53,30 @@ Register-ArgumentCompleter -Native -CommandName 'make-folder-txt' -ScriptBlock {
                 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 '-*') {

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.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": {
+    "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.1",
+  "version": "2.1.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": {